xref: /illumos-gate/usr/src/cmd/powertop/common/suggestions.c (revision 3bbf88b3546192f29c18986b9fb8a19ff364a4ea)
1 /*
2  * Copyright 2009, Intel Corporation
3  * Copyright 2009, Sun Microsystems, Inc
4  *
5  * This file is part of PowerTOP
6  *
7  * This program file is free software; you can redistribute it and/or modify it
8  * under the terms of the GNU General Public License as published by the
9  * Free Software Foundation; version 2 of the License.
10  *
11  * This program is distributed in the hope that it will be useful, but WITHOUT
12  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
13  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
14  * for more details.
15  *
16  * You should have received a copy of the GNU General Public License
17  * along with this program in a file named COPYING; if not, write to the
18  * Free Software Foundation, Inc.,
19  * 51 Franklin Street, Fifth Floor,
20  * Boston, MA 02110-1301 USA
21  *
22  * Authors:
23  *      Arjan van de Ven <arjan@linux.intel.com>
24  *      Eric C Saxe <eric.saxe@sun.com>
25  *      Aubrey Li <aubrey.li@intel.com>
26  */
27 
28 /*
29  * GPL Disclaimer
30  *
31  * For the avoidance of doubt, except that if any license choice other
32  * than GPL or LGPL is available it will apply instead, Sun elects to
33  * use only the General Public License version 2 (GPLv2) at this time
34  * for any software where a choice of GPL license versions is made
35  * available with the language indicating that GPLv2 or any later
36  * version may be used, or where a choice of which version of the GPL
37  * is applied is otherwise unspecified.
38  */
39 
40 #include <unistd.h>
41 #include <stdio.h>
42 #include <stdlib.h>
43 #include <string.h>
44 #include "powertop.h"
45 
46 /*
47  * Default number of intervals we display a suggestion before moving
48  * to the next.
49  */
50 #define	PT_SUGG_DEF_SLICE	3
51 
52 /*
53  * Global pointer to the current suggestion.
54  */
55 sugg_t	*g_curr_sugg;
56 
57 /*
58  * Head of the list of suggestions.
59  */
60 static sugg_t *sugg;
61 
62 /*
63  * Add a new suggestion. Only one suggestion per text allowed.
64  */
65 void
66 pt_sugg_add(char *text, int weight, char key, char *sb_msg, sugg_func_t *func)
67 {
68 	sugg_t *new, *n, *pos = NULL;
69 
70 	/*
71 	 * Text is a required field for suggestions
72 	 */
73 	if (text == NULL)
74 		return;
75 
76 	if (sugg == NULL) {
77 		/*
78 		 * Creating first element
79 		 */
80 		if ((new = calloc(1, sizeof (sugg_t))) == NULL)
81 			return;
82 
83 		if (sb_msg != NULL)
84 			new->sb_msg = strdup(sb_msg);
85 
86 		if (text != NULL)
87 			new->text = strdup(text);
88 
89 		new->weight = weight;
90 		new->key = key;
91 		new->func = func;
92 		new->slice = 0;
93 
94 		sugg = new;
95 		new->prev = NULL;
96 		new->next = NULL;
97 	} else {
98 		for (n = sugg; n != NULL; n = n->next) {
99 			if (strcmp(n->text, text) == 0)
100 				return;
101 
102 			if (weight > n->weight && pos == NULL)
103 				pos = n;
104 		}
105 		/*
106 		 * Create a new element
107 		 */
108 		if ((new = calloc(1, sizeof (sugg_t))) == NULL)
109 			return;
110 
111 		if (sb_msg != NULL)
112 			new->sb_msg = strdup(sb_msg);
113 
114 		new->text = strdup(text);
115 
116 		new->weight = weight;
117 		new->key = key;
118 		new->func = func;
119 		new->slice = 0;
120 
121 		if (pos == NULL) {
122 			/*
123 			 * Ordering placed the new element at the end
124 			 */
125 			for (n = sugg; n->next != NULL; n = n->next)
126 				;
127 
128 			n->next = new;
129 			new->prev = n;
130 			new->next = NULL;
131 		} else {
132 			if (pos == sugg) {
133 				/*
134 				 * Ordering placed the new element at the start
135 				 */
136 				new->next = sugg;
137 				new->prev = sugg;
138 				sugg->prev = new;
139 				sugg = new;
140 			} else {
141 				/*
142 				 * Ordering placed the new element somewhere in
143 				 * the middle
144 				 */
145 				new->next = pos;
146 				new->prev = pos->prev;
147 				pos->prev->next = new;
148 				pos->prev = new;
149 			}
150 		}
151 	}
152 }
153 
154 /*
155  * Removes a suggestion, returning 0 if not found and 1 if so.
156  */
157 int
158 pt_sugg_remove(sugg_func_t *func)
159 {
160 	sugg_t *n;
161 	int ret = 0;
162 
163 	for (n = sugg; n != NULL; n = n->next) {
164 		if (n->func == func) {
165 			/* Removing the first element */
166 			if (n == sugg) {
167 				if (sugg->next == NULL) {
168 					/* Removing the only element */
169 					sugg = NULL;
170 				} else {
171 					sugg = n->next;
172 					sugg->prev = NULL;
173 				}
174 			} else {
175 				if (n->next == NULL) {
176 					/* Removing the last element */
177 					n->prev->next = NULL;
178 				} else {
179 					/* Removing an intermediate element */
180 					n->prev->next = n->next;
181 					n->next->prev = n->prev;
182 				}
183 			}
184 
185 			/*
186 			 * If this suggestions is currently being suggested,
187 			 * remove it and update the screen.
188 			 */
189 			if (n == g_curr_sugg) {
190 				if (n->sb_msg != NULL) {
191 					pt_display_mod_status_bar(n->sb_msg);
192 					pt_display_status_bar();
193 				}
194 				if (n->text != NULL)
195 					pt_display_suggestions(NULL);
196 			}
197 
198 			free(n);
199 			ret = 1;
200 		}
201 	}
202 
203 	return (ret);
204 }
205 
206 /*
207  * Chose a suggestion to display. The list of suggestions is ordered by weight,
208  * so we only worry about fariness here. Each suggestion, starting with the
209  * first (the 'heaviest') is displayed during PT_SUGG_DEF_SLICE intervals.
210  */
211 void
212 pt_sugg_pick(void)
213 {
214 	sugg_t *n;
215 
216 	if (sugg == NULL) {
217 		g_curr_sugg = NULL;
218 		return;
219 	}
220 
221 search:
222 	for (n = sugg; n != NULL; n = n->next) {
223 
224 		if (n->slice++ < PT_SUGG_DEF_SLICE) {
225 
226 			/*
227 			 * Don't need to re-suggest the current suggestion.
228 			 */
229 			if (g_curr_sugg == n && !g_sig_resize)
230 				return;
231 
232 			/*
233 			 * Remove the current suggestion from screen.
234 			 */
235 			if (g_curr_sugg != NULL) {
236 				if (g_curr_sugg->sb_msg != NULL) {
237 					pt_display_mod_status_bar(
238 					    g_curr_sugg->sb_msg);
239 					pt_display_status_bar();
240 				}
241 				if (g_curr_sugg->text != NULL)
242 					pt_display_suggestions(NULL);
243 			}
244 
245 			if (n->sb_msg != NULL) {
246 				pt_display_mod_status_bar(n->sb_msg);
247 				pt_display_status_bar();
248 			}
249 
250 			pt_display_suggestions(n->text);
251 
252 			g_curr_sugg = n;
253 
254 			return;
255 		}
256 	}
257 
258 	/*
259 	 * All suggestions have run out of slice quotas, so we restart.
260 	 */
261 	for (n = sugg; n != NULL; n = n->next)
262 		n->slice = 0;
263 
264 	goto search;
265 }
266 
267 void
268 pt_sugg_as_root(void)
269 {
270 	pt_sugg_add("Suggestion: run as root to get suggestions"
271 	    " for reducing system power consumption",  40, NULL, NULL,
272 	    NULL);
273 }
274