NAME
conky - A system monitor for X originally based on the torsmo code, but
- more kickass. It just keeps on given'er. Yeah.
+ more kickass. It just keeps on given’er. Yeah.
SYNOPSIS
conky [options]
DESCRIPTION
Conky is a system monitor for X originally based on the torsmo code.
- Since it's original conception, Conky has changed a fair bit from it's
+ Since it’s original conception, Conky has changed a fair bit from it’s
predecessor. Conky can display just about anything, either on your
- root desktop or in it's own window. Conky has many built-in objects,
+ root desktop or in it’s own window. Conky has many built-in objects,
as well as the ability to execute programs and scripts, then display
the output from stdout.
libraries installed. This should be a package along the lines of
"libx11-dev or xorg-x11-dev".
- Gentoo users -- Conky is in Gentoo's Portage... simply use "emerge app-
+ Gentoo users -- Conky is in Gentoo’s Portage... simply use "emerge app-
admin/conky" for installation. There is also usually an up-to-date
- ebuild within Conky's package or in CVS.
+ ebuild within Conky’s package or in CVS.
- Debian,etc. users -- Conky will be in Debian's repositories soon (by
+ Debian,etc. users -- Conky will be in Debian’s repositories soon (by
mid-September, hopefully), and then Ubuntu shortly thereafter. Until
then, "dpkg -i" the .deb package to install.
./configure --prefix=/usr --mandir=/usr/share/man
--infodir=/usr/share/info --datadir=/usr/share --sysconfdir=/etc
- --localstatedir=/var/lib --enable-xft --enable-seti --enable-dou-
+ --localstatedir=/var/lib --enable-xft --enable-seti --enable-dou‐
ble-buffer --enable-own-window --enable-proc-uptime --enable-mpd
--enable-mldonkey --enable-x11 --enable-portmon
src/conky
- Conky probably doesn't compile with compilers other than gcc and icc.
- It doesn't compile with C89 compiler and not even with pure C99. It
- uses a few things that might not exist: strdup(), strcasecmp(), strn-
+ Conky probably doesn’t compile with compilers other than gcc and icc.
+ It doesn’t compile with C89 compiler and not even with pure C99. It
+ uses a few things that might not exist: strdup(), strcasecmp(), strn‐
casecmp(), optarg variable with getopt() and long long (not in C89).
- Crashes in file system statistics stuff when compiled with icc, I don't
+ Crashes in file system statistics stuff when compiled with icc, I don’t
know exactly why.
- You can disable 'drawing to own window' feature in case you don't need
+ You can disable ’drawing to own window’ feature in case you don’t need
it by passing --disable-own-window to configure -script.
rest of Conky.
If you do use them, please do not complain about memory or CPU usage,
- unless you think something's seriously wrong (mem leak, etc.).
+ unless you think something’s seriously wrong (mem leak, etc.).
An easy way to force Conky to reload your ~/.conkyrc: "killall -SIGUSR1
conky". Saves you the trouble of having to kill and then restart.
IMPORTANT: For previous Conky users, Conky 1.3 no longer supports the
metar stuff. mdsplib was causing way too many problems. Hopefully
- there'll be a better solution in Conky 2.x...
+ there’ll be a better solution in Conky 2.x...
OPTIONS
Command line options override configurations defined in configuration
-t TEXT
- Text to render, remember single quotes, like -t ' $uptime '
+ Text to render, remember single quotes, like -t ’ $uptime ’
-u SECONDS
CONFIGURATION SETTINGS
Default configuration file is $HOME/.conkyrc (can be changed from
conky.c among other things). See conkyrc.sample. If installing from
- Debian package, this should be in /usr/share/doc/conky/examples ("gun-
+ Debian package, this should be in /usr/share/doc/conky/examples ("gun‐
zip conkyrc.sample.gz" to get conkyrc.sample).
You might want to copy it to $HOME/.conkyrc and then start modifying
it. Other configs can be found at http://conky.sf.net
alignment
- Aligned position on screen, may be top_left, top_right, bot-
+ Aligned position on screen, may be top_left, top_right, bot‐
tom_left, bottom_right, or none
default_shade_color
- Default shading color and border's shading color
+ Default shading color and border’s shading color
default_outline_color
double_buffer
- Use the Xdbe extension? (eliminates flicker) It is highly recom-
- mended to use own window with this one so double buffer won't be
+ Use the Xdbe extension? (eliminates flicker) It is highly recom‐
+ mended to use own window with this one so double buffer won’t be
so big.
Use Xft (anti-aliased font and stuff)
+ min_port_monitors
+ Allow for the creation of at least this number of port monitors
+ (if 0 or not set, default is 16)
+
+
+ min_port_monitor_connections
+ Allow each port monitor to track at least this many connections
+ (if 0 or not set, default is 256)
+
+
TEXT After this begins text to be formatted on screen
VARIABLES
Colors are parsed using XParsecolor(), there might be a list of them:
/usr/X11R6/lib/X11/rgb.txt. Also, http://sedition.com/perl/rgb.html
- [http://sedition.com/perl/rgb.html]. Color can be also in #rrggbb for-
+ [http://sedition.com/perl/rgb.html]. Color can be also in #rrggbb for‐
mat (hex). Note that when displaying bytes, power is 1024 and not 1000
so 1M really means 1024*1024 bytes and not 1000*1000.
cpubar (cpu number) (height),(width)
- Bar that shows CPU usage, height is bar's height in pixels. See
+ Bar that shows CPU usage, height is bar’s height in pixels. See
$cpu for more info on SMP.
exec command
- Executes a shell command and displays the output in conky. warn-
- ing: this takes a lot more resources than other variables. I'd
+ Executes a shell command and displays the output in conky. warn‐
+ ing: this takes a lot more resources than other variables. I’d
recommend coding wanted behaviour in C and posting a patch.
execi interval command
- Same as exec but with specific interval. Interval can't be less
+ Same as exec but with specific interval. Interval can’t be less
than update_interval in configuration. See also $texeci
head logfile lines (interval)
Displays first N lines of supplied text text file. If interval
- is not supplied, Conky assumes 2x Conky's interval. Max of 30
+ is not supplied, Conky assumes 2x Conky’s interval. Max of 30
lines can be displayed, or until the text buffer is filled.
i8k_left_fan_rpm
If running the i8k kernel driver for Inspiron laptops, displays
- the left fan's rate of rotation, in revolutions per minute as
+ the left fan’s rate of rotation, in revolutions per minute as
listed in /proc/i8k. Beware, some laptops i8k reports these fans
in reverse order.
i8k_right_fan_rpm
If running the i8k kernel driver for Inspiron laptops, displays
- the right fan's rate of rotation, in revolutions per minute as
+ the right fan’s rate of rotation, in revolutions per minute as
listed in /proc/i8k. Beware, some laptops i8k reports these fans
in reverse order.
mpd_bar (height),(width)
- Bar of mpd's progress
+ Bar of mpd’s progress
mpd_bitrate
mpd_vol
- MPD's volume
+ MPD’s volume
mpd_elapsed
- Song's elapsed time
+ Song’s elapsed time
mpd_length
- Song's length
+ Song’s length
mpd_percent
- Percent of song's progress
+ Percent of song’s progress
mpd_random
Examples:
- ${tcp_portmon 6881 6889 count} - displays the number of connec-
+ ${tcp_portmon 6881 6889 count} - displays the number of connec‐
tions in the bittorrent port range
${tcp_portmon 22 22 rip 0} - displays the remote host ip of the
name of the fifteenth connection in the range of all ports
Note that port monitor variables which share the same port range
- actually refer to the same monitor, so many references to a sin-
+ actually refer to the same monitor, so many references to a sin‐
gle port range for different items and different indexes all use
the same monitor internally. In other words, the program avoids
creating redundant monitors.
texeci interval command
Runs a command at an interval inside a thread and displays the
output. Same as $execi, except the command is run inside a
- thread. Use this if you have a slow script to keep Conky updat-
+ thread. Use this if you have a slow script to keep Conky updat‐
ing. You should make the interval slightly longer then the time
it takes your script to execute. For example, if you have a
script that take 5 seconds to execute, you should make the
tail logfile lines (interval)
Displays last N lines of supplied text text file. If interval is
- not supplied, Conky assumes 2x Conky's interval. Max of 30 lines
+ not supplied, Conky assumes 2x Conky’s interval. Max of 30 lines
can be displayed, or until the text buffer is filled.
time (format)
- Local time, see man strftime to get more information about for-
+ Local time, see man strftime to get more information about for‐
mat
totaldown net
Total download, overflows at 4 GB on Linux with 32-bit arch and
- there doesn't seem to be a way to know how many times it has
+ there doesn’t seem to be a way to know how many times it has
already done that before conky has started.
EXAMPLES
- conky -t '${time %D %H:%m}' -o -u 30
+ conky -t ’${time %D %H:%m}’ -o -u 30
Start Conky in its own window with date and clock as text and 30
sec update interval.
~/.conkyrc default configuration file
BUGS
- Drawing to root or some other desktop window directly doesn't work with
- all window managers. Especially doesn't work well with Gnome and it has
- been reported that it doesn't work with KDE either. Nautilus can be
+ Drawing to root or some other desktop window directly doesn’t work with
+ all window managers. Especially doesn’t work well with Gnome and it has
+ been reported that it doesn’t work with KDE either. Nautilus can be
disabled from drawing to desktop with program gconf-editor. Uncheck
show_desktop in /apps/nautilus/preferences/. There is -w switch in
Conky to set some specific window id. You might find xwininfo -tree
SEE ALSO
http://conky.sourceforge.net [http://conky.sourceforge.net]
- http://www.sourceforge.net/projects/conky [http://www.source-
+ http://www.sourceforge.net/projects/conky [http://www.source‐
forge.net/projects/conky]
#conky on irc.freenode.net
AUTHORS
- The Conky dev team. What's up now!
+ The Conky dev team. What’s up now!
/* pad percentages to decimals? */
static int pad_percents = 0;
+#ifdef TCP_PORT_MONITOR
+static int min_port_monitors = 0; /* config item */
+static int min_port_monitor_connections = 0; /* config item */
+#endif
+
/* Text that is shown */
static char original_text[] =
"$nodename - $sysname $kernel on $machine\n"
/* if the port monitor collection hasn't been created, we must create it */
if ( !info.p_tcp_port_monitor_collection )
{
- info.p_tcp_port_monitor_collection = create_tcp_port_monitor_collection();
+ double hash_size, log_base_2;
+
+ /* calculate hash_size from min_port_monitors */
+ hash_size = (double)min_port_monitors / (double)TCP_MONITOR_HASH_MAX_LOAD_PCT;
+ /* correct hash_size to nearest power of two */
+ log_base_2 = log(hash_size) / log(2);
+ if ( log_base_2 - (int)log_base_2 > 0.001 )
+ log_base_2 = (double)( (int)log_base_2 + 1 );
+ hash_size = pow(2,log_base_2);
+ /*fprintf(stderr,"collection hash size is %d\n",(int)hash_size);*/
+
+ info.p_tcp_port_monitor_collection = create_tcp_port_monitor_collection( (int)hash_size );
if ( !info.p_tcp_port_monitor_collection )
{
CRIT_ERR("tcp_portmon: unable to create port monitor collection");
/* if a port monitor for this port does not exist, create one and add it to the collection */
if ( find_tcp_port_monitor( info.p_tcp_port_monitor_collection, port_begin, port_end ) == NULL )
{
- tcp_port_monitor_t * p_monitor = create_tcp_port_monitor( port_begin, port_end );
+ double hash_size, log_base_2;
+
+ /* calculate hash_size from min_port_monitor_connections */
+ hash_size = (double)min_port_monitor_connections / (double)TCP_CONNECTION_HASH_MAX_LOAD_PCT;
+ /* correct hash_size to nearest power of two */
+ log_base_2 = log(hash_size) / log(2);
+ if ( log_base_2 - (int)log_base_2 > 0.001)
+ log_base_2 = (double)( (int)log_base_2 + 1 );
+ hash_size = pow(2, log_base_2);
+ /*fprintf(stderr,"monitor hash size is %d\n",(int)hash_size);*/
+
+ tcp_port_monitor_t * p_monitor =
+ create_tcp_port_monitor( port_begin, port_end, (int)hash_size );
if ( !p_monitor )
{
CRIT_ERR("tcp_portmon: unable to create port monitor");
mlconfig.mldonkey_login = NULL;
mlconfig.mldonkey_password = NULL;
#endif
+
+#ifdef TCP_PORT_MONITOR
+ min_port_monitors = MIN_PORT_MONITORS_DEFAULT;
+ min_port_monitor_connections = MIN_PORT_MONITOR_CONNECTIONS_DEFAULT;
+#endif
}
static void load_config_file(const char *f)
fclose(fp);
return;
}
+#ifdef TCP_PORT_MONITOR
+ CONF("min_port_monitors")
+ {
+ if ( !value ||
+ (sscanf(value, "%d", &min_port_monitors) != 1) ||
+ min_port_monitors <= 0 )
+ {
+ min_port_monitors = MIN_PORT_MONITORS_DEFAULT;
+ CONF_ERR;
+ }
+ }
+ CONF("min_port_monitor_connections")
+ {
+ if ( !value ||
+ (sscanf(value, "%d", &min_port_monitor_connections) != 1)
+ || min_port_monitor_connections <= 0 )
+ {
+ min_port_monitor_connections = MIN_PORT_MONITOR_CONNECTIONS_DEFAULT;
+ CONF_ERR;
+ }
+ }
+#endif
else
ERR("%s: %d: no such configuration: '%s'", f, line, name);
projects / monky / commitdiff