b717e386a2c90248b9069d6321bfde80ea2d6542
[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_battery_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 };
208
209 /* if_up strictness selector
210  * needed by conky.c and linux.c (and potentially others) */
211 enum {
212         IFUP_UP,
213         IFUP_LINK,
214         IFUP_ADDR
215 } ifup_strictness;
216
217 struct information {
218         unsigned int mask;
219
220         struct utsname uname_s;
221
222         char freq[10];
223
224         double uptime;
225
226         /* memory information in kilobytes */
227         unsigned long long mem, memeasyfree, memfree, memmax, swap, swapfree, swapmax;
228         unsigned long long bufmem, buffers, cached;
229
230         unsigned short procs;
231         unsigned short run_procs;
232         unsigned short threads;
233         unsigned short run_threads;
234
235         float *cpu_usage;
236         /* struct cpu_stat cpu_summed; what the hell is this? */
237         int cpu_count;
238         int cpu_avg_samples;
239
240         int net_avg_samples;
241
242         int diskio_avg_samples;
243
244         float loadavg[3];
245
246 #ifdef XMMS2
247         struct xmms2_s xmms2;
248 #endif
249 #ifdef AUDACIOUS
250         AUDACIOUS_S audacious;
251 #endif
252 #ifdef BMPX
253         struct bmpx_s bmpx;
254 #endif
255         struct usr_info users;
256         struct process *cpu[10];
257         struct process *memu[10];
258         struct process *time[10];
259 #ifdef IOSTATS
260         struct process *io[10];
261 #endif
262         struct process *first_process;
263         unsigned long looped;
264         double music_player_interval;
265
266 #ifdef X11
267         struct x11_info x11;
268 #endif
269
270 #ifdef APCUPSD
271         APCUPSD_S apcupsd;
272 #endif
273
274         short kflags;   /* kernel settings, see enum KFLAG */
275 };
276
277 #ifdef HAVE_LUA
278 #include "llua.h"
279 #endif /* HAVE_LUA */
280
281 /* needed by linux.c and top.c -> outsource somewhere */
282 enum {
283         /* set to true if kernel uses "long" format for /proc/stats */
284         KFLAG_IS_LONGSTAT = 0x01,
285         /* set to true if kernel shows # of threads for the proc value
286          * in sysinfo() call */
287         KFLAG_PROC_IS_THREADS = 0x02
288         /* bits 0x04, 0x08, 0x10, 0x20, 0x40, 0x80 available for future use */
289         /* KFLAG_NEXT_ONE = 0x04 */
290 };
291 #define KFLAG_SETON(a) info.kflags |= a
292 #define KFLAG_SETOFF(a) info.kflags &= (~a)
293 #define KFLAG_FLIP(a) info.kflags ^= a
294 #define KFLAG_ISSET(a) info.kflags & a
295
296 /* defined in conky.c, needed by top.c */
297 extern int top_cpu, top_mem, top_time;
298 #ifdef IOSTATS
299 extern int top_io;
300 #endif
301 extern int top_running;
302
303 /* defined in conky.c, needed by top.c */
304 extern int cpu_separate;
305
306 /* struct that has all info to be shared between
307  * instances of the same text object */
308 extern struct information info;
309
310 /* defined in users.c */
311 int update_users(void);
312 void update_user_time(char *tty);
313
314 /* defined in conky.c */
315 extern double current_update_time, last_update_time, update_interval;
316
317 /* defined in conky.c */
318 int spaced_print(char *, int, const char *, int, ...)
319         __attribute__((format(printf, 3, 5)));
320 extern int inotify_fd;
321
322 /* defined in conky.c
323  * evaluates 'text' and places the result in 'p' of max length 'p_max_size'
324  */
325 void evaluate(const char *text, char *p, int p_max_size);
326
327 /* maximum size of config TEXT buffer, i.e. below TEXT line. */
328 extern unsigned int max_user_text;
329
330 /* path to config file */
331 extern char *current_config;
332
333 #ifdef X11
334 #define TO_X 1
335 #endif /* X11 */
336 #define TO_STDOUT 2
337 #define TO_STDERR 4
338 #define OVERWRITE_FILE 8
339 #define APPEND_FILE 16
340 #ifdef NCURSES
341 #define TO_NCURSES 32
342 #endif /* NCURSES */
343 enum x_initialiser_state {
344         NO = 0,
345         YES = 1,
346         NEVER = 2
347 };
348 extern int output_methods;
349 extern enum x_initialiser_state x_initialised;
350
351 void set_update_interval(double interval);
352
353 #define DEFAULT_TEXT_BUFFER_SIZE_S "##DEFAULT_TEXT_BUFFER_SIZE"
354
355 #define NOBATTERY 0
356
357 /* to get rid of 'unused variable' warnings */
358 #define UNUSED(a)  (void)a
359 #define UNUSED_ATTR __attribute__ ((unused))
360
361 void parse_conky_vars(struct text_object *, const char *,
362                         char *, int, struct information *);
363
364 void generate_text_internal(char *, int, struct text_object,
365                                    struct information *);
366 #endif /* _conky_h_ */