added alternate codepath that gets battery info from dbus when power kernel is not...
[monky] / src / conky.h
1 /* -*- mode: c; c-basic-offset: 4; tab-width: 4; indent-tabs-mode: t -*-
2  * vim: ts=4 sw=4 noet ai cindent syntax=c
3  *
4  * Conky, a system monitor, based on torsmo
5  *
6  * Any original torsmo code is licensed under the BSD license
7  *
8  * All code written since the fork of torsmo is licensed under the GPL
9  *
10  * Please see COPYING for details
11  *
12  * Copyright (c) 2004, Hannu Saransaari and Lauri Hakkarainen
13  * Copyright (c) 2005-2010 Brenden Matthews, Philip Kovacs, et. al.
14  *      (see AUTHORS)
15  * All rights reserved.
16  *
17  * This program is free software: you can redistribute it and/or modify
18  * it under the terms of the GNU General Public License as published by
19  * the Free Software Foundation, either version 3 of the License, or
20  * (at your option) any later version.
21  *
22  * This program is distributed in the hope that it will be useful,
23  * but WITHOUT ANY WARRANTY; without even the implied warranty of
24  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
25  * GNU General Public License for more details.
26  * You should have received a copy of the GNU General Public License
27  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
28  *
29  */
30
31 #ifndef _conky_h_
32 #define _conky_h_
33
34 #include "config.h"     /* defines */
35 #include "common.h"     /* at least for struct dns_data */
36 #include <sys/utsname.h> /* struct uname_s */
37 #include <arpa/inet.h>
38
39 #if defined(HAS_MCHECK_H)
40 #include <mcheck.h>
41 #endif /* HAS_MCHECK_H */
42
43 #undef EQUAL
44 #undef FALSE
45 #undef TRUE
46 #define EQUAL 0 //returnvalue of strcmp-variants when strings are equal
47 #define FALSE 0
48 #define TRUE 1
49
50 #define DEFAULT_BAR_WIDTH_NO_X 10
51
52 #if !defined(__GNUC__)
53 #  define __attribute__(x) /* nothing */
54 #endif
55
56 #ifndef HAVE_STRNDUP
57 // use our own strndup() if it's not available
58 char *strndup(const char *s, size_t n);
59 #endif /* HAVE_STRNDUP */
60
61 /* headers of optional features
62  * include them here, so we don't need to run the check
63  * in every code file optionally using the feature
64  */
65
66 /* forward define to make gcc happy */
67 struct text_object;
68
69 #ifdef AUDACIOUS
70 #include "audacious.h"
71 #endif
72
73 #ifdef BMPX
74 #include "bmpx.h"
75 #endif
76
77 #ifdef EVE
78 #include "eve.h"
79 #endif
80
81 #ifdef HDDTEMP
82 #include "hddtemp.h"
83 #endif /* HDDTEMP */
84
85 #ifdef MOC
86 #include "moc.h"
87 #endif
88
89 #ifdef MPD
90 #include "mpd.h"
91 #endif
92
93 #ifdef HAVE_CURL
94 #include "ccurl_thread.h"
95 #endif /* HAVE_CURL */
96
97 #ifdef RSS
98 #include "rss.h"
99 #endif /* RSS */
100
101 #ifdef XOAP
102 #ifndef WEATHER
103 #error "WEATHER needs to be defined if XOAP is defined"
104 #endif /* WEATHER */
105 #endif /* XOAP */
106
107 #ifdef WEATHER
108 #include "weather.h"
109 #endif /* WEATHER */
110
111 #ifdef TCP_PORT_MONITOR
112 #include "tcp-portmon.h"
113 #endif
114
115 #ifdef XMMS2
116 #include "xmms2.h"
117 #endif
118
119 #ifdef IBM
120 #include "ibm.h"
121 #include "smapi.h"
122 #endif
123
124 #ifdef APCUPSD
125 #include "apcupsd.h"
126 #endif
127
128 /* sony support */
129 #include "sony.h"
130
131 /* A size for temporary, static buffers to use when
132  * one doesn't know what to choose. Defaults to 256.  */
133 extern unsigned int text_buffer_size;
134
135 struct usr_info {
136         char *names;
137         char *times;
138         char *ctime;
139         char *terms;
140         int number;
141 };
142
143 #ifdef X11
144 struct monitor_info {
145         int number;
146         int current;
147 };
148
149 struct desktop_info {
150         int current;
151         int number;
152         unsigned int nitems;
153         char *all_names;
154         char *name;
155 };
156
157 struct x11_info {
158         struct monitor_info monitor;
159         struct desktop_info desktop;
160 };
161
162 int get_stippled_borders(void);
163
164 #endif /* X11 */
165
166 /* defined in conky.c */
167 extern long default_fg_color, default_bg_color, default_out_color;
168 extern long color0, color1, color2, color3, color4, color5, color6, color7,
169            color8, color9;
170 void set_current_text_color(long colour);
171 long get_current_text_color(void);
172
173 void set_updatereset(int);
174 int get_updatereset(void);
175
176 int percent_print(char *, int, unsigned);
177 void human_readable(long long, char *, int);
178
179 struct conftree {
180         char* string;
181         struct conftree* horz_next;
182         struct conftree* vert_next;
183         struct conftree* back;
184 };
185
186 char load_config_file(const char *);
187
188 char *get_global_text(void);
189 extern long global_text_lines;
190
191 //adds newstring to to the tree unless you can already see it when travelling back.
192 //if it's possible to attach it then it returns a pointer to the leaf, else it returns NULL
193 struct conftree* conftree_add(struct conftree* previous, const char* newstring);
194
195 extern struct conftree *currentconffile;
196
197 #define MAX_TEMPLATES 10
198 char **get_templates(void);
199
200 /* get_xxxxx_stuff() item selector
201  * needed by conky.c, linux.c and freebsd.c */
202 enum {
203         BATTERY_STATUS,
204         BATTERY_TIME,
205         BATTERY_VOLTS,
206         BATTERY_TEMP,
207         DBUS_CELL_DBM,
208         DBUS_CELL_PERCENT,
209         DBUS_HAL_BATTERY_CHRG_STATUS,
210         DBUS_HAL_BATTERY_PERCENT,
211         DBUS_HAL_BATTERY_VOLTS_CURRENT
212 };
213
214 /* if_up strictness selector
215  * needed by conky.c and linux.c (and potentially others) */
216 enum {
217         IFUP_UP,
218         IFUP_LINK,
219         IFUP_ADDR
220 } ifup_strictness;
221
222 struct information {
223         unsigned int mask;
224
225         struct utsname uname_s;
226
227         char freq[10];
228
229         double uptime;
230
231         /* memory information in kilobytes */
232         unsigned long long mem, memeasyfree, memfree, memmax, swap, swapfree, swapmax;
233         unsigned long long bufmem, buffers, cached;
234
235         unsigned short procs;
236         unsigned short run_procs;
237         unsigned short threads;
238         unsigned short run_threads;
239
240         float *cpu_usage;
241         /* struct cpu_stat cpu_summed; what the hell is this? */
242         int cpu_count;
243         int cpu_avg_samples;
244
245         int net_avg_samples;
246
247         int diskio_avg_samples;
248
249         float loadavg[3];
250
251 #ifdef XMMS2
252         struct xmms2_s xmms2;
253 #endif
254 #ifdef AUDACIOUS
255         AUDACIOUS_S audacious;
256 #endif
257 #ifdef BMPX
258         struct bmpx_s bmpx;
259 #endif
260         struct usr_info users;
261         struct process *cpu[10];
262         struct process *memu[10];
263         struct process *time[10];
264 #ifdef IOSTATS
265         struct process *io[10];
266 #endif
267         struct process *first_process;
268         unsigned long looped;
269         double music_player_interval;
270
271 #ifdef X11
272         struct x11_info x11;
273 #endif
274
275 #ifdef APCUPSD
276         APCUPSD_S apcupsd;
277 #endif
278
279         short kflags;   /* kernel settings, see enum KFLAG */
280 };
281
282 #ifdef HAVE_LUA
283 #include "llua.h"
284 #endif /* HAVE_LUA */
285
286 /* needed by linux.c and top.c -> outsource somewhere */
287 enum {
288         /* set to true if kernel uses "long" format for /proc/stats */
289         KFLAG_IS_LONGSTAT = 0x01,
290         /* set to true if kernel shows # of threads for the proc value
291          * in sysinfo() call */
292         KFLAG_PROC_IS_THREADS = 0x02
293         /* bits 0x04, 0x08, 0x10, 0x20, 0x40, 0x80 available for future use */
294         /* KFLAG_NEXT_ONE = 0x04 */
295 };
296 #define KFLAG_SETON(a) info.kflags |= a
297 #define KFLAG_SETOFF(a) info.kflags &= (~a)
298 #define KFLAG_FLIP(a) info.kflags ^= a
299 #define KFLAG_ISSET(a) info.kflags & a
300
301 /* defined in conky.c, needed by top.c */
302 extern int top_cpu, top_mem, top_time;
303 #ifdef IOSTATS
304 extern int top_io;
305 #endif
306 extern int top_running;
307
308 /* defined in conky.c, needed by top.c */
309 extern int cpu_separate;
310
311 /* struct that has all info to be shared between
312  * instances of the same text object */
313 extern struct information info;
314
315 /* defined in users.c */
316 int update_users(void);
317 void update_user_time(char *tty);
318
319 /* defined in conky.c */
320 extern double current_update_time, last_update_time, update_interval;
321
322 /* defined in conky.c */
323 int spaced_print(char *, int, const char *, int, ...)
324         __attribute__((format(printf, 3, 5)));
325 extern int inotify_fd;
326
327 /* defined in conky.c
328  * evaluates 'text' and places the result in 'p' of max length 'p_max_size'
329  */
330 void evaluate(const char *text, char *p, int p_max_size);
331
332 /* maximum size of config TEXT buffer, i.e. below TEXT line. */
333 extern unsigned int max_user_text;
334
335 /* path to config file */
336 extern char *current_config;
337
338 #ifdef X11
339 #define TO_X 1
340 #endif /* X11 */
341 #define TO_STDOUT 2
342 #define TO_STDERR 4
343 #define OVERWRITE_FILE 8
344 #define APPEND_FILE 16
345 #ifdef NCURSES
346 #define TO_NCURSES 32
347 #endif /* NCURSES */
348 enum x_initialiser_state {
349         NO = 0,
350         YES = 1,
351         NEVER = 2
352 };
353 extern int output_methods;
354 extern enum x_initialiser_state x_initialised;
355
356 void set_update_interval(double interval);
357
358 #define DEFAULT_TEXT_BUFFER_SIZE_S "##DEFAULT_TEXT_BUFFER_SIZE"
359
360 #define NOBATTERY 0
361
362 /* to get rid of 'unused variable' warnings */
363 #define UNUSED(a)  (void)a
364 #define UNUSED_ATTR __attribute__ ((unused))
365
366 void parse_conky_vars(struct text_object *, const char *,
367                         char *, int, struct information *);
368
369 void generate_text_internal(char *, int, struct text_object,
370                                    struct information *);
371 #endif /* _conky_h_ */