mirror of
https://github.com/Llewellynvdm/conky.git
synced 2024-12-27 20:44:56 +00:00
update README and manpage
git-svn-id: https://conky.svn.sourceforge.net/svnroot/conky/trunk/conky1@1272 7f574dfc-610e-0410-a909-a81674777703
This commit is contained in:
parent
ecb3004c0f
commit
a89bef1b0e
365
README
365
README
@ -388,8 +388,20 @@ conky(1) conky(1)
|
|||||||
Border stippling (dashing) in pixels
|
Border stippling (dashing) in pixels
|
||||||
|
|
||||||
|
|
||||||
|
1mtemplateN0m
|
||||||
|
Define a template for later use inside TEXT segments. Substitute
|
||||||
|
N by a digit between 0 and 9, inclusively. The value of the
|
||||||
|
variable is being inserted into the stuff below TEXT at the cor‐
|
||||||
|
responding position, but before some substitutions are applied:
|
||||||
|
|
||||||
|
’\n’ -> newline
|
||||||
|
’\\’ -> backslash
|
||||||
|
’\ ’ -> space
|
||||||
|
’\N’ -> template argument N
|
||||||
|
|
||||||
|
|
||||||
1mtotal_run_times0m
|
1mtotal_run_times0m
|
||||||
Total number of times for Conky to update before quitting. Zero
|
Total number of times for Conky to update before quitting. Zero
|
||||||
makes Conky run forever
|
makes Conky run forever
|
||||||
|
|
||||||
|
|
||||||
@ -404,8 +416,8 @@ conky(1) conky(1)
|
|||||||
1muse_spacer0m
|
1muse_spacer0m
|
||||||
Adds spaces around certain objects to stop them from moving oth‐
|
Adds spaces around certain objects to stop them from moving oth‐
|
||||||
er things around. Arguments are left, right, and none (default).
|
er things around. Arguments are left, right, and none (default).
|
||||||
The old true/false values are deprecated and default to
|
The old true/false values are deprecated and default to
|
||||||
right/none respectively. Note that this only helps if you are
|
right/none respectively. Note that this only helps if you are
|
||||||
using a mono font, such as Bitstream Vera Sans Mono.
|
using a mono font, such as Bitstream Vera Sans Mono.
|
||||||
|
|
||||||
|
|
||||||
@ -425,17 +437,17 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
1mVARIABLES0m
|
1mVARIABLES0m
|
||||||
Colors are parsed using XParsecolor(), there might be a list of them:
|
Colors are parsed using XParsecolor(), there might be a list of them:
|
||||||
/usr/share/X11/rgb.txt. Also, ⟨http://sedition.com/perl/rgb.html⟩.
|
/usr/share/X11/rgb.txt. Also, ⟨http://sedition.com/perl/rgb.html⟩.
|
||||||
Color can be also in #rrggbb format (hex).
|
Color can be also in #rrggbb format (hex).
|
||||||
|
|
||||||
1maddr interface0m
|
1maddr interface0m
|
||||||
IP address for an interface, or "No Address" if no address is
|
IP address for an interface, or "No Address" if no address is
|
||||||
assigned.
|
assigned.
|
||||||
|
|
||||||
|
|
||||||
1maddrs interface0m
|
1maddrs interface0m
|
||||||
IP addresses for an interface (if one - works like addr). Linux
|
IP addresses for an interface (if one - works like addr). Linux
|
||||||
only.
|
only.
|
||||||
|
|
||||||
|
|
||||||
@ -480,7 +492,7 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
1mapm_battery_time0m
|
1mapm_battery_time0m
|
||||||
Display remaining APM battery life in hh:mm:ss or "unknown" if
|
Display remaining APM battery life in hh:mm:ss or "unknown" if
|
||||||
AC adapterstatus is on-line or charging (FreeBSD only)
|
AC adapterstatus is on-line or charging (FreeBSD only)
|
||||||
|
|
||||||
|
|
||||||
@ -537,8 +549,8 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
1mbattery (num)0m
|
1mbattery (num)0m
|
||||||
Battery status and remaining percentage capacity of ACPI or APM
|
Battery status and remaining percentage capacity of ACPI or APM
|
||||||
battery. ACPI battery number can be given as argument (default
|
battery. ACPI battery number can be given as argument (default
|
||||||
is BAT0).
|
is BAT0).
|
||||||
|
|
||||||
|
|
||||||
@ -553,7 +565,7 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
1mbattery_time (num)0m
|
1mbattery_time (num)0m
|
||||||
Battery charge/discharge time remaining of ACPI battery. ACPI
|
Battery charge/discharge time remaining of ACPI battery. ACPI
|
||||||
battery number can be given as argument (default is BAT0).
|
battery number can be given as argument (default is BAT0).
|
||||||
|
|
||||||
|
|
||||||
@ -592,7 +604,7 @@ conky(1) conky(1)
|
|||||||
Change drawing color to color
|
Change drawing color to color
|
||||||
|
|
||||||
|
|
||||||
1mcolorN 22mChange drawing color to colorN configuration option, where N is
|
1mcolorN 22mChange drawing color to colorN configuration option, where N is
|
||||||
a digit between 0 and 9, inclusively.
|
a digit between 0 and 9, inclusively.
|
||||||
|
|
||||||
|
|
||||||
@ -609,20 +621,20 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
1mcpu (cpuN)0m
|
1mcpu (cpuN)0m
|
||||||
CPU usage in percents. For SMP machines, the CPU number can be
|
CPU usage in percents. For SMP machines, the CPU number can be
|
||||||
provided as an argument. ${cpu cpu0} is the total usage, and
|
provided as an argument. ${cpu cpu0} is the total usage, and
|
||||||
${cpu cpuX} (X >= 1) are individual CPUs.
|
${cpu cpuX} (X >= 1) are individual CPUs.
|
||||||
|
|
||||||
|
|
||||||
1mcpubar (cpu number) (height),(width)0m
|
1mcpubar (cpu number) (height),(width)0m
|
||||||
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.
|
$cpu for more info on SMP.
|
||||||
|
|
||||||
|
|
||||||
1mcpugraph normal|log (cpu number) (height),(width) (gradient colour 1)0m
|
1mcpugraph normal|log (cpu number) (height),(width) (gradient colour 1)0m
|
||||||
1m(gradient colour 2)0m
|
1m(gradient colour 2)0m
|
||||||
CPU usage graph, with optional colours in hex, minus the #. See
|
CPU usage graph, with optional colours in hex, minus the #. See
|
||||||
$cpu for more info on SMP. Uses a logarithmic scale (to see
|
$cpu for more info on SMP. Uses a logarithmic scale (to see
|
||||||
small numbers) when you use "log" instead of "normal".
|
small numbers) when you use "log" instead of "normal".
|
||||||
|
|
||||||
|
|
||||||
@ -631,9 +643,9 @@ conky(1) conky(1)
|
|||||||
of sda for /dev/sda. Individual partitions are allowed.
|
of sda for /dev/sda. Individual partitions are allowed.
|
||||||
|
|
||||||
|
|
||||||
1mdiskiograph normal|log (device) (height),(width) (gradient colour 1)0m
|
1mdiskiograph normal|log (device) (height),(width) (gradient colour 1)0m
|
||||||
1m(gradient colour 2) (scale)0m
|
1m(gradient colour 2) (scale)0m
|
||||||
Disk IO graph, colours defined in hex, minus the #. If scale is
|
Disk IO graph, colours defined in hex, minus the #. If scale is
|
||||||
non-zero, it becomes the scale for the graph. Uses a logarithmic
|
non-zero, it becomes the scale for the graph. Uses a logarithmic
|
||||||
scale (to see small numbers) when you use "log" instead of "nor‐
|
scale (to see small numbers) when you use "log" instead of "nor‐
|
||||||
mal".
|
mal".
|
||||||
@ -643,11 +655,11 @@ conky(1) conky(1)
|
|||||||
Displays current disk IO for reads. Device as in diskio.
|
Displays current disk IO for reads. Device as in diskio.
|
||||||
|
|
||||||
|
|
||||||
1mdiskiograph_read normal|log (device) (height),(width) (gradient colour0m
|
1mdiskiograph_read normal|log (device) (height),(width) (gradient colour0m
|
||||||
1m1) (gradient colour 2) (scale)0m
|
1m1) (gradient colour 2) (scale)0m
|
||||||
Disk IO graph for reads, colours defined in hex, minus the #. If
|
Disk IO graph for reads, colours defined in hex, minus the #. If
|
||||||
scale is non-zero, it becomes the scale for the graph. Device as
|
scale is non-zero, it becomes the scale for the graph. Device as
|
||||||
in diskio. Uses a logarithmic scale (to see small numbers) when
|
in diskio. Uses a logarithmic scale (to see small numbers) when
|
||||||
you use "log" instead of "normal".
|
you use "log" instead of "normal".
|
||||||
|
|
||||||
|
|
||||||
@ -657,9 +669,9 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
1mdiskiograph_write normal|log (device) (height),(width) (gradient colour0m
|
1mdiskiograph_write normal|log (device) (height),(width) (gradient colour0m
|
||||||
1m1) (gradient colour 2) (scale)0m
|
1m1) (gradient colour 2) (scale)0m
|
||||||
Disk IO graph for writes, colours defined in hex, minus the #.
|
Disk IO graph for writes, colours defined in hex, minus the #.
|
||||||
If scale is non-zero, it becomes the scale for the graph. Device
|
If scale is non-zero, it becomes the scale for the graph. Device
|
||||||
as in diskio. Uses a logarithmic scale (to see small numbers)
|
as in diskio. Uses a logarithmic scale (to see small numbers)
|
||||||
when you use "log" instead of "normal".
|
when you use "log" instead of "normal".
|
||||||
|
|
||||||
|
|
||||||
@ -676,11 +688,11 @@ conky(1) conky(1)
|
|||||||
Download speed in KiB with one decimal
|
Download speed in KiB with one decimal
|
||||||
|
|
||||||
|
|
||||||
1mdownspeedgraph normal|log net (height),(width) (gradient colour 1)0m
|
1mdownspeedgraph normal|log net (height),(width) (gradient colour 1)0m
|
||||||
1m(gradient colour 2) (scale)0m
|
1m(gradient colour 2) (scale)0m
|
||||||
Download speed graph, colours defined in hex, minus the #. If
|
Download speed graph, colours defined in hex, minus the #. If
|
||||||
scale is non-zero, it becomes the scale for the graph. Uses a
|
scale is non-zero, it becomes the scale for the graph. Uses a
|
||||||
logarithmic scale (to see small numbers) when you use "log" in‐
|
logarithmic scale (to see small numbers) when you use "log" in‐
|
||||||
stead of "normal".
|
stead of "normal".
|
||||||
|
|
||||||
|
|
||||||
@ -701,24 +713,24 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
1mexec command0m
|
1mexec command0m
|
||||||
Executes a shell command and displays the output in conky. warn‐
|
Executes a shell command and displays the output in conky. warn‐
|
||||||
ing: this takes a lot more resources than other variables. I’d
|
ing: this takes a lot more resources than other variables. I’d
|
||||||
recommend coding wanted behaviour in C and posting a patch.
|
recommend coding wanted behaviour in C and posting a patch.
|
||||||
|
|
||||||
|
|
||||||
1mexecbar command0m
|
1mexecbar command0m
|
||||||
Same as exec, except if the first value return is a value be‐
|
Same as exec, except if the first value return is a value be‐
|
||||||
tween 0-100, it will use that number for a bar. The size for the
|
tween 0-100, it will use that number for a bar. The size for the
|
||||||
bar is currently fixed, but that may change in the future.
|
bar is currently fixed, but that may change in the future.
|
||||||
|
|
||||||
|
|
||||||
1mexecgraph (normal|log) command0m
|
1mexecgraph (normal|log) command0m
|
||||||
Same as execbar, but graphs values. Uses a logaritmic scale when
|
Same as execbar, but graphs values. Uses a logaritmic scale when
|
||||||
the log option is given (to see small numbers). Values still
|
the log option is given (to see small numbers). Values still
|
||||||
have to be between 0 and 100.
|
have to be between 0 and 100.
|
||||||
|
|
||||||
|
|
||||||
1mexeci interval command0m
|
1mexeci interval command0m
|
||||||
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
|
than update_interval in configuration. See also $texeci
|
||||||
|
|
||||||
|
|
||||||
@ -732,14 +744,14 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
1mexecp command0m
|
1mexecp command0m
|
||||||
Executes a shell command and displays the output in conky. warn‐
|
Executes a shell command and displays the output in conky. warn‐
|
||||||
ing: this takes a lot more resources than other variables. I’d
|
ing: this takes a lot more resources than other variables. I’d
|
||||||
recommend coding wanted behaviour in C and posting a patch. This
|
recommend coding wanted behaviour in C and posting a patch. This
|
||||||
differs from $exec in that it parses the output of the command,
|
differs from $exec in that it parses the output of the command,
|
||||||
so you can insert things like ${color red}hi!${color} in your
|
so you can insert things like ${color red}hi!${color} in your
|
||||||
script and have it correctly parsed by Conky. Caveats: Conky
|
script and have it correctly parsed by Conky. Caveats: Conky
|
||||||
parses and evaluates the output of $execp every time Conky
|
parses and evaluates the output of $execp every time Conky
|
||||||
loops, and then destroys all the objects. If you try to use any‐
|
loops, and then destroys all the objects. If you try to use any‐
|
||||||
thing like $execi within an $execp statement, it will function‐
|
thing like $execi within an $execp statement, it will function‐
|
||||||
ally run at the same interval that the $execp statement runs, as
|
ally run at the same interval that the $execp statement runs, as
|
||||||
it is created and destroyed at every interval.
|
it is created and destroyed at every interval.
|
||||||
|
|
||||||
@ -747,41 +759,41 @@ conky(1) conky(1)
|
|||||||
1mexecpi interval command0m
|
1mexecpi interval command0m
|
||||||
Same as execp but with specific interval. Interval can’t be less
|
Same as execp but with specific interval. Interval can’t be less
|
||||||
than update_interval in configuration. Note that the output from
|
than update_interval in configuration. Note that the output from
|
||||||
the $execpi command is still parsed and evaluated at every in‐
|
the $execpi command is still parsed and evaluated at every in‐
|
||||||
terval.
|
terval.
|
||||||
|
|
||||||
|
|
||||||
1mfont (font)0m
|
1mfont (font)0m
|
||||||
Specify a different font. This new font will apply to the cur‐
|
Specify a different font. This new font will apply to the cur‐
|
||||||
rent line and everything following. You can use a $font with no
|
rent line and everything following. You can use a $font with no
|
||||||
arguments to change back to the default font (much like with
|
arguments to change back to the default font (much like with
|
||||||
$color)
|
$color)
|
||||||
|
|
||||||
|
|
||||||
1mfreq (n)0m
|
1mfreq (n)0m
|
||||||
Returns CPU #n’s frequency in MHz. CPUs are counted from 1. If
|
Returns CPU #n’s frequency in MHz. CPUs are counted from 1. If
|
||||||
omitted, the parameter defaults to 1.
|
omitted, the parameter defaults to 1.
|
||||||
|
|
||||||
|
|
||||||
1mfreq_g (n)0m
|
1mfreq_g (n)0m
|
||||||
Returns CPU #n’s frequency in GHz. CPUs are counted from 1. If
|
Returns CPU #n’s frequency in GHz. CPUs are counted from 1. If
|
||||||
omitted, the parameter defaults to 1.
|
omitted, the parameter defaults to 1.
|
||||||
|
|
||||||
|
|
||||||
1mfreq_dyn (n)0m
|
1mfreq_dyn (n)0m
|
||||||
Returns CPU #n’s frequency in MHz (defaults to 1), but is calcu‐
|
Returns CPU #n’s frequency in MHz (defaults to 1), but is calcu‐
|
||||||
lated by counting to clock cycles to complete an instruction.
|
lated by counting to clock cycles to complete an instruction.
|
||||||
Only available for x86/amd64.
|
Only available for x86/amd64.
|
||||||
|
|
||||||
|
|
||||||
1mfreq_dyn_g (n)0m
|
1mfreq_dyn_g (n)0m
|
||||||
Returns CPU #n’s frequency in GHz (defaults to 1), but is calcu‐
|
Returns CPU #n’s frequency in GHz (defaults to 1), but is calcu‐
|
||||||
lated by counting to clock cycles to complete an instruction.
|
lated by counting to clock cycles to complete an instruction.
|
||||||
Only available for x86/amd64.
|
Only available for x86/amd64.
|
||||||
|
|
||||||
|
|
||||||
1mfs_bar (height),(width) fs0m
|
1mfs_bar (height),(width) fs0m
|
||||||
Bar that shows how much space is used on a file system. height
|
Bar that shows how much space is used on a file system. height
|
||||||
is the height in pixels. fs is any file on that file system.
|
is the height in pixels. fs is any file on that file system.
|
||||||
|
|
||||||
|
|
||||||
@ -809,23 +821,23 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
1mgw_iface0m
|
1mgw_iface0m
|
||||||
Displays the default route’s interface or "multiple"/"none" ac‐
|
Displays the default route’s interface or "multiple"/"none" ac‐
|
||||||
cordingly.
|
cordingly.
|
||||||
|
|
||||||
|
|
||||||
1mgw_ip 22mDisplays the default gateway’s IP or "multiple"/"none" accord‐
|
1mgw_ip 22mDisplays the default gateway’s IP or "multiple"/"none" accord‐
|
||||||
ingly.
|
ingly.
|
||||||
|
|
||||||
|
|
||||||
1mhddtemp dev, (host,(port))0m
|
1mhddtemp dev, (host,(port))0m
|
||||||
Displays temperature of a selected hard disk drive as reported
|
Displays temperature of a selected hard disk drive as reported
|
||||||
by the hddtemp daemon running on host:port. Default host is
|
by the hddtemp daemon running on host:port. Default host is
|
||||||
127.0.0.1, default port is 7634.
|
127.0.0.1, default port is 7634.
|
||||||
|
|
||||||
|
|
||||||
1mhead logfile lines (interval)0m
|
1mhead logfile lines (interval)0m
|
||||||
Displays first N lines of supplied text text file. If 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.
|
lines can be displayed, or until the text buffer is filled.
|
||||||
|
|
||||||
|
|
||||||
@ -834,16 +846,16 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
1mhwmon (dev) type n0m
|
1mhwmon (dev) type n0m
|
||||||
Hwmon sensor from sysfs (Linux 2.6). Parameter dev may be omit‐
|
Hwmon sensor from sysfs (Linux 2.6). Parameter dev may be omit‐
|
||||||
ted if you have only one hwmon device. Parameter type is either
|
ted if you have only one hwmon device. Parameter type is either
|
||||||
’in’ or ’vol’ meaning voltage; ’fan’ meaning fan; ’temp’ (Cel‐
|
’in’ or ’vol’ meaning voltage; ’fan’ meaning fan; ’temp’ (Cel‐
|
||||||
sius) or ’tempf’ (Fahrenheit) meaning temperature. Parameter n
|
sius) or ’tempf’ (Fahrenheit) meaning temperature. Parameter n
|
||||||
is number of the sensor. See /sys/class/hwmon/ on your local
|
is number of the sensor. See /sys/class/hwmon/ on your local
|
||||||
computer.
|
computer.
|
||||||
|
|
||||||
|
|
||||||
1miconv_start codeset_from codeset_to0m
|
1miconv_start codeset_from codeset_to0m
|
||||||
Convert text from one codeset to another using GNU iconv. Needs
|
Convert text from one codeset to another using GNU iconv. Needs
|
||||||
to be stopped with iconv_stop.
|
to be stopped with iconv_stop.
|
||||||
|
|
||||||
|
|
||||||
@ -852,75 +864,75 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
1mi2c (dev) type n0m
|
1mi2c (dev) type n0m
|
||||||
I2C sensor from sysfs (Linux 2.6). Parameter dev may be omitted
|
I2C sensor from sysfs (Linux 2.6). Parameter dev may be omitted
|
||||||
if you have only one I2C device. Parameter type is either ’in’
|
if you have only one I2C device. Parameter type is either ’in’
|
||||||
or ’vol’ meaning voltage; ’fan’ meaning fan; ’temp’ (Celsius) or
|
or ’vol’ meaning voltage; ’fan’ meaning fan; ’temp’ (Celsius) or
|
||||||
’tempf’ (Fahrenheit) meaning temperature. Parameter n is number
|
’tempf’ (Fahrenheit) meaning temperature. Parameter n is number
|
||||||
of the sensor. See /sys/bus/i2c/devices/ on your local computer.
|
of the sensor. See /sys/bus/i2c/devices/ on your local computer.
|
||||||
|
|
||||||
|
|
||||||
1mi8k_ac_status0m
|
1mi8k_ac_status0m
|
||||||
If running the i8k kernel driver for Inspiron laptops, displays
|
If running the i8k kernel driver for Inspiron laptops, displays
|
||||||
whether ac power is on, as listed in /proc/i8k (translated to
|
whether ac power is on, as listed in /proc/i8k (translated to
|
||||||
human-readable). Beware that this is by default not enabled by
|
human-readable). Beware that this is by default not enabled by
|
||||||
i8k itself.
|
i8k itself.
|
||||||
|
|
||||||
|
|
||||||
1mi8k_bios0m
|
1mi8k_bios0m
|
||||||
If running the i8k kernel driver for Inspiron laptops, displays
|
If running the i8k kernel driver for Inspiron laptops, displays
|
||||||
the bios version as listed in /proc/i8k.
|
the bios version as listed in /proc/i8k.
|
||||||
|
|
||||||
|
|
||||||
1mi8k_buttons_status0m
|
1mi8k_buttons_status0m
|
||||||
If running the i8k kernel driver for Inspiron laptops, displays
|
If running the i8k kernel driver for Inspiron laptops, displays
|
||||||
the volume buttons status as listed in /proc/i8k.
|
the volume buttons status as listed in /proc/i8k.
|
||||||
|
|
||||||
|
|
||||||
1mi8k_cpu_temp0m
|
1mi8k_cpu_temp0m
|
||||||
If running the i8k kernel driver for Inspiron laptops, displays
|
If running the i8k kernel driver for Inspiron laptops, displays
|
||||||
the cpu temperature in Celsius, as reported by /proc/i8k.
|
the cpu temperature in Celsius, as reported by /proc/i8k.
|
||||||
|
|
||||||
|
|
||||||
1mi8k_cpu_tempf0m
|
1mi8k_cpu_tempf0m
|
||||||
If running the i8k kernel driver for Inspiron laptops, displays
|
If running the i8k kernel driver for Inspiron laptops, displays
|
||||||
the cpu temperature in Fahrenheit, as reported by /proc/i8k.
|
the cpu temperature in Fahrenheit, as reported by /proc/i8k.
|
||||||
|
|
||||||
|
|
||||||
1mi8k_left_fan_rpm0m
|
1mi8k_left_fan_rpm0m
|
||||||
If running the i8k kernel driver for Inspiron laptops, displays
|
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
|
listed in /proc/i8k. Beware, some laptops i8k reports these fans
|
||||||
in reverse order.
|
in reverse order.
|
||||||
|
|
||||||
|
|
||||||
1mi8k_left_fan_status0m
|
1mi8k_left_fan_status0m
|
||||||
If running the i8k kernel driver for Inspiron laptops, displays
|
If running the i8k kernel driver for Inspiron laptops, displays
|
||||||
the left fan status as listed in /proc/i8k (translated to human-
|
the left fan status as listed in /proc/i8k (translated to human-
|
||||||
readable). Beware, some laptops i8k reports these fans in re‐
|
readable). Beware, some laptops i8k reports these fans in re‐
|
||||||
verse order.
|
verse order.
|
||||||
|
|
||||||
|
|
||||||
1mi8k_right_fan_rpm0m
|
1mi8k_right_fan_rpm0m
|
||||||
If running the i8k kernel driver for Inspiron laptops, displays
|
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
|
listed in /proc/i8k. Beware, some laptops i8k reports these fans
|
||||||
in reverse order.
|
in reverse order.
|
||||||
|
|
||||||
|
|
||||||
1mi8k_right_fan_status0m
|
1mi8k_right_fan_status0m
|
||||||
If running the i8k kernel driver for Inspiron laptops, displays
|
If running the i8k kernel driver for Inspiron laptops, displays
|
||||||
the right fan status as listed in /proc/i8k (translated to hu‐
|
the right fan status as listed in /proc/i8k (translated to hu‐
|
||||||
man-readable). Beware, some laptops i8k reports these fans in
|
man-readable). Beware, some laptops i8k reports these fans in
|
||||||
reverse order.
|
reverse order.
|
||||||
|
|
||||||
|
|
||||||
1mi8k_serial0m
|
1mi8k_serial0m
|
||||||
If running the i8k kernel driver for Inspiron laptops, displays
|
If running the i8k kernel driver for Inspiron laptops, displays
|
||||||
your laptop serial number as listed in /proc/i8k.
|
your laptop serial number as listed in /proc/i8k.
|
||||||
|
|
||||||
|
|
||||||
1mi8k_version0m
|
1mi8k_version0m
|
||||||
If running the i8k kernel driver for Inspiron laptops, displays
|
If running the i8k kernel driver for Inspiron laptops, displays
|
||||||
the version formatting of /proc/i8k.
|
the version formatting of /proc/i8k.
|
||||||
|
|
||||||
|
|
||||||
@ -929,13 +941,13 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
1mibm_temps N0m
|
1mibm_temps N0m
|
||||||
If running the IBM ACPI, displays the temperatures from the IBM
|
If running the IBM ACPI, displays the temperatures from the IBM
|
||||||
temperature sensors (N=0..7) Sensor 0 is on the CPU, 3 is on the
|
temperature sensors (N=0..7) Sensor 0 is on the CPU, 3 is on the
|
||||||
GPU.
|
GPU.
|
||||||
|
|
||||||
|
|
||||||
1mibm_volume0m
|
1mibm_volume0m
|
||||||
If running the IBM ACPI, displays the "master" volume, con‐
|
If running the IBM ACPI, displays the "master" volume, con‐
|
||||||
trolled by the volume keys (0-14).
|
trolled by the volume keys (0-14).
|
||||||
|
|
||||||
|
|
||||||
@ -945,7 +957,7 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
1mif_empty (var)0m
|
1mif_empty (var)0m
|
||||||
if conky variable VAR is empty, display everything between
|
if conky variable VAR is empty, display everything between
|
||||||
$if_empty and the matching $endif
|
$if_empty and the matching $endif
|
||||||
|
|
||||||
|
|
||||||
@ -954,14 +966,14 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
1mif_running (process)0m
|
1mif_running (process)0m
|
||||||
if PROCESS is running, display everything $if_running and the
|
if PROCESS is running, display everything $if_running and the
|
||||||
matching $endif
|
matching $endif
|
||||||
|
|
||||||
|
|
||||||
1mif_existing file (string)0m
|
1mif_existing file (string)0m
|
||||||
if FILE exists, display everything between if_existing and the
|
if FILE exists, display everything between if_existing and the
|
||||||
matching $endif. The optional second paramater checks for FILE
|
matching $endif. The optional second paramater checks for FILE
|
||||||
containing the specified string and prints everything between
|
containing the specified string and prints everything between
|
||||||
$if_existing and the matching $endif.
|
$if_existing and the matching $endif.
|
||||||
|
|
||||||
|
|
||||||
@ -971,8 +983,8 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
1mif_smapi_bat_installed (INDEX)0m
|
1mif_smapi_bat_installed (INDEX)0m
|
||||||
when using smapi, if the battery with index INDEX is installed,
|
when using smapi, if the battery with index INDEX is installed,
|
||||||
display everything between $if_smapi_bat_installed and the
|
display everything between $if_smapi_bat_installed and the
|
||||||
matching $endif
|
matching $endif
|
||||||
|
|
||||||
|
|
||||||
@ -983,7 +995,7 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
1mimap_messages (args)0m
|
1mimap_messages (args)0m
|
||||||
Displays the number of messages in your global IMAP inbox by de‐
|
Displays the number of messages in your global IMAP inbox by de‐
|
||||||
fault. You can define individual IMAP inboxes seperately by
|
fault. You can define individual IMAP inboxes seperately by
|
||||||
passing arguments to this object. Arguments are: "host user pass
|
passing arguments to this object. Arguments are: "host user pass
|
||||||
[-i interval] [-p port] [-e command] [-r retries]". Default port
|
[-i interval] [-p port] [-e command] [-r retries]". Default port
|
||||||
is 143, default interval is 5 minutes, and default number of re‐
|
is 143, default interval is 5 minutes, and default number of re‐
|
||||||
@ -1002,7 +1014,7 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
1mioscheduler disk0m
|
1mioscheduler disk0m
|
||||||
Prints the current ioscheduler used for the given disk name
|
Prints the current ioscheduler used for the given disk name
|
||||||
(i.e. e.g. "hda" or "sdb")
|
(i.e. e.g. "hda" or "sdb")
|
||||||
|
|
||||||
|
|
||||||
@ -1018,10 +1030,10 @@ conky(1) conky(1)
|
|||||||
5 minutes and 3 for past 15 minutes.
|
5 minutes and 3 for past 15 minutes.
|
||||||
|
|
||||||
|
|
||||||
1mloadgraph normal|log (height),(width) (gradient colour 1) (gradient0m
|
1mloadgraph normal|log (height),(width) (gradient colour 1) (gradient0m
|
||||||
1mcolour 2)0m
|
1mcolour 2)0m
|
||||||
Load1 average graph, similar to xload, with optional colours in
|
Load1 average graph, similar to xload, with optional colours in
|
||||||
hex, minus the #. Uses a logarithmic scale (to see small num‐
|
hex, minus the #. Uses a logarithmic scale (to see small num‐
|
||||||
bers) when you use "log" instead of "normal".
|
bers) when you use "log" instead of "normal".
|
||||||
|
|
||||||
|
|
||||||
@ -1034,16 +1046,16 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
1mmails (mailbox) (interval)0m
|
1mmails (mailbox) (interval)0m
|
||||||
Mail count in the specified mailbox or your mail spool if not.
|
Mail count in the specified mailbox or your mail spool if not.
|
||||||
Both mbox and maildir type mailboxes are supported. You can use
|
Both mbox and maildir type mailboxes are supported. You can use
|
||||||
a program like fetchmail to get mails from some server using
|
a program like fetchmail to get mails from some server using
|
||||||
your favourite protocol. See also new_mails.
|
your favourite protocol. See also new_mails.
|
||||||
|
|
||||||
|
|
||||||
1mmboxscan (-n number of messages to print) (-fw from width) (-sw subject0m
|
1mmboxscan (-n number of messages to print) (-fw from width) (-sw subject0m
|
||||||
1mwidth) mbox0m
|
1mwidth) mbox0m
|
||||||
Print a summary of recent messages in an mbox format mailbox.
|
Print a summary of recent messages in an mbox format mailbox.
|
||||||
mbox parameter is the filename of the mailbox (can be encapsu‐
|
mbox parameter is the filename of the mailbox (can be encapsu‐
|
||||||
lated using ’"’, ie. ${mboxscan -n 10 "/home/brenden/some box"}
|
lated using ’"’, ie. ${mboxscan -n 10 "/home/brenden/some box"}
|
||||||
|
|
||||||
|
|
||||||
@ -1054,14 +1066,14 @@ conky(1) conky(1)
|
|||||||
Bar that shows amount of memory in use
|
Bar that shows amount of memory in use
|
||||||
|
|
||||||
|
|
||||||
1mmemgraph normal|log (height),(width) (gradient colour 1) (gradient0m
|
1mmemgraph normal|log (height),(width) (gradient colour 1) (gradient0m
|
||||||
1mcolour 2)0m
|
1mcolour 2)0m
|
||||||
Memory usage graph. Uses a logarithmic scale (to see small num‐
|
Memory usage graph. Uses a logarithmic scale (to see small num‐
|
||||||
bers) when you use "log" instead of "normal".
|
bers) when you use "log" instead of "normal".
|
||||||
|
|
||||||
|
|
||||||
1mmemeasyfree0m
|
1mmemeasyfree0m
|
||||||
Amount of free memory including the memory that is very easily
|
Amount of free memory including the memory that is very easily
|
||||||
freed (buffers/cache)
|
freed (buffers/cache)
|
||||||
|
|
||||||
|
|
||||||
@ -1077,39 +1089,39 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
1mmixer (device)0m
|
1mmixer (device)0m
|
||||||
Prints the mixer value as reported by the OS. Default mixer is
|
Prints the mixer value as reported by the OS. Default mixer is
|
||||||
"vol", but you can specify one of the following optional argu‐
|
"vol", but you can specify one of the following optional argu‐
|
||||||
ments: "vol", "bass", "treble", "synth", "pcm", "speaker",
|
ments: "vol", "bass", "treble", "synth", "pcm", "speaker",
|
||||||
"line", "mic", "cd", "mix", "pcm2", "rec", "igain", "ogain",
|
"line", "mic", "cd", "mix", "pcm2", "rec", "igain", "ogain",
|
||||||
"line1", "line2", "line3", "dig1", "dig2", "dig3", "phin",
|
"line1", "line2", "line3", "dig1", "dig2", "dig3", "phin",
|
||||||
"phout", "video", "radio", "monitor". Refer to the definition of
|
"phout", "video", "radio", "monitor". Refer to the definition of
|
||||||
SOUND_DEVICE_NAMES in <linux/soundcard.h> (on Linux), <sound‐
|
SOUND_DEVICE_NAMES in <linux/soundcard.h> (on Linux), <sound‐
|
||||||
card.h> (on OpenBSD), or <sys/soundcard.h> to find the exact op‐
|
card.h> (on OpenBSD), or <sys/soundcard.h> to find the exact op‐
|
||||||
tions available on your system.
|
tions available on your system.
|
||||||
|
|
||||||
|
|
||||||
1mmixerbar (device)0m
|
1mmixerbar (device)0m
|
||||||
Displays mixer value in a bar as reported by the OS. See docs
|
Displays mixer value in a bar as reported by the OS. See docs
|
||||||
for $mixer for details on arguments.
|
for $mixer for details on arguments.
|
||||||
|
|
||||||
|
|
||||||
1mmixerr (device)0m
|
1mmixerr (device)0m
|
||||||
Prints the right channel mixer value as reported by the OS. See
|
Prints the right channel mixer value as reported by the OS. See
|
||||||
docs for $mixer for details on arguments.
|
docs for $mixer for details on arguments.
|
||||||
|
|
||||||
|
|
||||||
1mmixerrbar (device)0m
|
1mmixerrbar (device)0m
|
||||||
Displays the right channel mixer value in a bar as reported by
|
Displays the right channel mixer value in a bar as reported by
|
||||||
the OS. See docs for $mixer for details on arguments.
|
the OS. See docs for $mixer for details on arguments.
|
||||||
|
|
||||||
|
|
||||||
1mmixerl (device)0m
|
1mmixerl (device)0m
|
||||||
Prints the left channel mixer value as reported by the OS. See
|
Prints the left channel mixer value as reported by the OS. See
|
||||||
docs for $mixer for details on arguments.
|
docs for $mixer for details on arguments.
|
||||||
|
|
||||||
|
|
||||||
1mmixerlbar (device)0m
|
1mmixerlbar (device)0m
|
||||||
Displays the left channel mixer value in a bar as reported by
|
Displays the left channel mixer value in a bar as reported by
|
||||||
the OS. See docs for $mixer for details on arguments.
|
the OS. See docs for $mixer for details on arguments.
|
||||||
|
|
||||||
|
|
||||||
@ -1231,12 +1243,12 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
1mif_mpd_playing0m
|
1mif_mpd_playing0m
|
||||||
if mpd is playing or paused, display everything between
|
if mpd is playing or paused, display everything between
|
||||||
$if_mpd_playing and the matching $endif
|
$if_mpd_playing and the matching $endif
|
||||||
|
|
||||||
|
|
||||||
1mnameserver (index)0m
|
1mnameserver (index)0m
|
||||||
Print a nameserver from /etc/resolv.conf. Index starts at and
|
Print a nameserver from /etc/resolv.conf. Index starts at and
|
||||||
defaults to 0.
|
defaults to 0.
|
||||||
|
|
||||||
|
|
||||||
@ -1250,8 +1262,8 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
1mnvidia threshold temp gpufreq memfreq imagequality0m
|
1mnvidia threshold temp gpufreq memfreq imagequality0m
|
||||||
Nvidia graficcard support for the XNVCtrl library. Each option
|
Nvidia graficcard support for the XNVCtrl library. Each option
|
||||||
can be shortened to the least significant part. Temperatures
|
can be shortened to the least significant part. Temperatures
|
||||||
are printed as float, all other values as integer.
|
are printed as float, all other values as integer.
|
||||||
|
|
||||||
1mthreshold22m: the thresholdtemperature at which the gpu slows down
|
1mthreshold22m: the thresholdtemperature at which the gpu slows down
|
||||||
@ -1268,26 +1280,26 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
1mpb_battery item0m
|
1mpb_battery item0m
|
||||||
If running on Apple powerbook/ibook, display information on bat‐
|
If running on Apple powerbook/ibook, display information on bat‐
|
||||||
tery status. The item parameter specifies, what information to
|
tery status. The item parameter specifies, what information to
|
||||||
display. Exactly one item must be specified. Valid items are:
|
display. Exactly one item must be specified. Valid items are:
|
||||||
|
|
||||||
1mstatus22m: Display if battery is fully charged, charging, discharg‐
|
1mstatus22m: Display if battery is fully charged, charging, discharg‐
|
||||||
ing or absent (running on AC)
|
ing or absent (running on AC)
|
||||||
1mpercent22m: Display charge of battery in percent, if charging or
|
1mpercent22m: Display charge of battery in percent, if charging or
|
||||||
discharging. Nothing will be displayed, if battery is fully
|
discharging. Nothing will be displayed, if battery is fully
|
||||||
charged or absent.
|
charged or absent.
|
||||||
1mtime22m: Display the time remaining until the battery will be fully
|
1mtime22m: Display the time remaining until the battery will be fully
|
||||||
charged or discharged at current rate. Nothing is displayed, if
|
charged or discharged at current rate. Nothing is displayed, if
|
||||||
battery is absent or if it’s present but fully charged and not
|
battery is absent or if it’s present but fully charged and not
|
||||||
discharging.
|
discharging.
|
||||||
|
|
||||||
|
|
||||||
1mplatform (dev) type n0m
|
1mplatform (dev) type n0m
|
||||||
Platform sensor from sysfs (Linux 2.6). Parameter dev may be
|
Platform sensor from sysfs (Linux 2.6). Parameter dev may be
|
||||||
omitted if you have only one platform device. Platform type is
|
omitted if you have only one platform device. Platform type is
|
||||||
either ’in’ or ’vol’ meaning voltage; ’fan’ meaning fan; ’temp’
|
either ’in’ or ’vol’ meaning voltage; ’fan’ meaning fan; ’temp’
|
||||||
(Celsius) or ’tempf’ (Fahrenheit) meaning temperature. Parameter
|
(Celsius) or ’tempf’ (Fahrenheit) meaning temperature. Parameter
|
||||||
n is number of the sensor. See /sys/bus/platform/devices/ on
|
n is number of the sensor. See /sys/bus/platform/devices/ on
|
||||||
your local computer.
|
your local computer.
|
||||||
|
|
||||||
|
|
||||||
@ -1302,13 +1314,13 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
1mpop3_used (args)0m
|
1mpop3_used (args)0m
|
||||||
Displays the amount of space (in MiB, 2^20) used in your global
|
Displays the amount of space (in MiB, 2^20) used in your global
|
||||||
POP3 inbox by default. You can define individual POP3 inboxes
|
POP3 inbox by default. You can define individual POP3 inboxes
|
||||||
seperately by passing arguments to this object. Arguments are:
|
seperately by passing arguments to this object. Arguments are:
|
||||||
"host user pass [-i interval] [-p port] [-e command] [-r re‐
|
"host user pass [-i interval] [-p port] [-e command] [-r re‐
|
||||||
tries]". Default port is 110, default interval is 5 minutes, and
|
tries]". Default port is 110, default interval is 5 minutes, and
|
||||||
default number of retries before giving up is 5. If the password
|
default number of retries before giving up is 5. If the password
|
||||||
is supplied as ’*’, you will be prompted to enter the password
|
is supplied as ’*’, you will be prompted to enter the password
|
||||||
when Conky starts.
|
when Conky starts.
|
||||||
|
|
||||||
|
|
||||||
@ -1326,14 +1338,14 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
1mscroll length (step) text0m
|
1mscroll length (step) text0m
|
||||||
Scroll ’text’ by ’step’ characters showing ’length’ number of
|
Scroll ’text’ by ’step’ characters showing ’length’ number of
|
||||||
characters at the same time. The text may also contain vari‐
|
characters at the same time. The text may also contain vari‐
|
||||||
ables. ’step’ is optional and defaults to 1 if not set. If a var
|
ables. ’step’ is optional and defaults to 1 if not set. If a var
|
||||||
creates output on multiple lines then the lines are placed be‐
|
creates output on multiple lines then the lines are placed be‐
|
||||||
hind each other separated with a ’|’-sign. Do NOT use vars that
|
hind each other separated with a ’|’-sign. Do NOT use vars that
|
||||||
change colors or otherwise affect the design inside a scrolling
|
change colors or otherwise affect the design inside a scrolling
|
||||||
text. If you want spaces between the start and the end of
|
text. If you want spaces between the start and the end of
|
||||||
’text’, place them at the end of ’text’ not at the front ("foo‐
|
’text’, place them at the end of ’text’ not at the front ("foo‐
|
||||||
bar" and " foobar" can both generate "barfoo" but "foobar " will
|
bar" and " foobar" can both generate "barfoo" but "foobar " will
|
||||||
keep the spaces like this "bar foo").
|
keep the spaces like this "bar foo").
|
||||||
|
|
||||||
@ -1343,35 +1355,35 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
1msmapi (ARGS)0m
|
1msmapi (ARGS)0m
|
||||||
when using smapi, display contents of the /sys/devices/plat‐
|
when using smapi, display contents of the /sys/devices/plat‐
|
||||||
form/smapi directory. ARGS are either ’(FILENAME)’ or ’bat (IN‐
|
form/smapi directory. ARGS are either ’(FILENAME)’ or ’bat (IN‐
|
||||||
DEX) (FILENAME)’ to display the corresponding files’ content.
|
DEX) (FILENAME)’ to display the corresponding files’ content.
|
||||||
This is a very raw method of accessing the smapi values. When
|
This is a very raw method of accessing the smapi values. When
|
||||||
available, better use one of the smapi_* variables instead.
|
available, better use one of the smapi_* variables instead.
|
||||||
|
|
||||||
|
|
||||||
1msmapi_bat_bar (INDEX),(height),(width)0m
|
1msmapi_bat_bar (INDEX),(height),(width)0m
|
||||||
when using smapi, display the remaining capacity of the battery
|
when using smapi, display the remaining capacity of the battery
|
||||||
with index INDEX as a bar.
|
with index INDEX as a bar.
|
||||||
|
|
||||||
|
|
||||||
1msmapi_bat_perc (INDEX)0m
|
1msmapi_bat_perc (INDEX)0m
|
||||||
when using smapi, display the remaining capacity in percent of
|
when using smapi, display the remaining capacity in percent of
|
||||||
the battery with index INDEX. This is a separate variable be‐
|
the battery with index INDEX. This is a separate variable be‐
|
||||||
cause it supports the ’use_spacer’ configuration option.
|
cause it supports the ’use_spacer’ configuration option.
|
||||||
|
|
||||||
|
|
||||||
1msmapi_bat_power INDEX0m
|
1msmapi_bat_power INDEX0m
|
||||||
when using smapi, display the current power of the battery with
|
when using smapi, display the current power of the battery with
|
||||||
index INDEX in watt. This is a separate variable because the
|
index INDEX in watt. This is a separate variable because the
|
||||||
original read out value is being converted from mW. The sign of
|
original read out value is being converted from mW. The sign of
|
||||||
the output reflects charging (positive) or discharging (nega‐
|
the output reflects charging (positive) or discharging (nega‐
|
||||||
tive) state.
|
tive) state.
|
||||||
|
|
||||||
|
|
||||||
1msmapi_bat_temp INDEX0m
|
1msmapi_bat_temp INDEX0m
|
||||||
when using smapi, display the current temperature of the battery
|
when using smapi, display the current temperature of the battery
|
||||||
with index INDEX in degree Celsius. This is a separate variable
|
with index INDEX in degree Celsius. This is a separate variable
|
||||||
because the original read out value is being converted from mil‐
|
because the original read out value is being converted from mil‐
|
||||||
li degree Celsius.
|
li degree Celsius.
|
||||||
|
|
||||||
@ -1416,36 +1428,36 @@ conky(1) conky(1)
|
|||||||
The connection index provides you with access to each connection
|
The connection index provides you with access to each connection
|
||||||
in the port monitor. The monitor will return information for in‐
|
in the port monitor. The monitor will return information for in‐
|
||||||
dex values from 0 to n-1 connections. Values higher than n-1 are
|
dex values from 0 to n-1 connections. Values higher than n-1 are
|
||||||
simply ignored. For the "count" item, the connection index must
|
simply ignored. For the "count" item, the connection index must
|
||||||
be omitted. It is required for all other items.
|
be omitted. It is required for all other items.
|
||||||
|
|
||||||
Examples:
|
Examples:
|
||||||
1m${tcp_portmon 6881 6999 count} 22m- displays the number of connec‐
|
1m${tcp_portmon 6881 6999 count} 22m- displays the number of connec‐
|
||||||
tions in the bittorrent port range
|
tions in the bittorrent port range
|
||||||
1m${tcp_portmon 22 22 rip 0} 22m- displays the remote host ip of the
|
1m${tcp_portmon 22 22 rip 0} 22m- displays the remote host ip of the
|
||||||
first sshd connection
|
first sshd connection
|
||||||
1m${tcp_portmon 22 22 rip 9} 22m- displays the remote host ip of the
|
1m${tcp_portmon 22 22 rip 9} 22m- displays the remote host ip of the
|
||||||
tenth sshd connection
|
tenth sshd connection
|
||||||
1m${tcp_portmon 1 1024 rhost 0} 22m- displays the remote host name of
|
1m${tcp_portmon 1 1024 rhost 0} 22m- displays the remote host name of
|
||||||
the first connection on a privileged port
|
the first connection on a privileged port
|
||||||
1m${tcp_portmon 1 1024 rport 4} 22m- displays the remote host port of
|
1m${tcp_portmon 1 1024 rport 4} 22m- displays the remote host port of
|
||||||
the fifth connection on a privileged port
|
the fifth connection on a privileged port
|
||||||
1m${tcp_portmon 1 65535 lservice 14} 22m- displays the local service
|
1m${tcp_portmon 1 65535 lservice 14} 22m- displays the local service
|
||||||
name of the fifteenth connection in the range of all ports
|
name of the fifteenth connection in the range of all ports
|
||||||
|
|
||||||
Note that port monitor variables which share the same port range
|
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
|
gle port range for different items and different indexes all use
|
||||||
the same monitor internally. In other words, the program avoids
|
the same monitor internally. In other words, the program avoids
|
||||||
creating redundant monitors.
|
creating redundant monitors.
|
||||||
|
|
||||||
1mtexeci interval command0m
|
1mtexeci interval command0m
|
||||||
Runs a command at an interval inside a thread and displays the
|
Runs a command at an interval inside a thread and displays the
|
||||||
output. Same as $execi, except the command is run inside a
|
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
|
ing. You should make the interval slightly longer then the time
|
||||||
it takes your script to execute. For example, if you have a
|
it takes your script to execute. For example, if you have a
|
||||||
script that take 5 seconds to execute, you should make the in‐
|
script that take 5 seconds to execute, you should make the in‐
|
||||||
terval at least 6 seconds. See also $execi.
|
terval at least 6 seconds. See also $execi.
|
||||||
|
|
||||||
|
|
||||||
@ -1454,8 +1466,8 @@ conky(1) conky(1)
|
|||||||
|
|
||||||
|
|
||||||
1mrss url delay_in_minutes action item_num0m
|
1mrss url delay_in_minutes action item_num0m
|
||||||
Download and parse RSS feeds. Action may be one of the follow‐
|
Download and parse RSS feeds. Action may be one of the follow‐
|
||||||
ing: feed_title, item_title (with num par), item_desc (with num
|
ing: feed_title, item_title (with num par), item_desc (with num
|
||||||
par) and item_titles.
|
par) and item_titles.
|
||||||
|
|
||||||
|
|
||||||
@ -1469,6 +1481,35 @@ conky(1) conky(1)
|
|||||||
can be displayed, or until the text buffer is filled.
|
can be displayed, or until the text buffer is filled.
|
||||||
|
|
||||||
|
|
||||||
|
1mtemplateN (arg1) (arg2) (arg3 ...)0m
|
||||||
|
Evaluate the content of the templateN configuration variable
|
||||||
|
(where N is a value between 0 and 9, inclusively), applying sub‐
|
||||||
|
stitutions as described in the documentation of the correspond‐
|
||||||
|
ing configuration variable. The number of arguments is option‐
|
||||||
|
al, but must match the highest referred index in the template.
|
||||||
|
You can use the same special sequences in each argument as the
|
||||||
|
ones valid for a template definition, e.g. to allow an argument
|
||||||
|
to contain a whitespace. Also simple nesting of templates is
|
||||||
|
possible this way.
|
||||||
|
|
||||||
|
Here are some examples of template definitions:
|
||||||
|
|
||||||
|
template0 $\1\2
|
||||||
|
template1 \1: ${fs_used \2} / ${fs_size \2}
|
||||||
|
template2 \1 \2
|
||||||
|
|
||||||
|
The following list shows sample usage of the templates defined
|
||||||
|
above, with the equivalent syntax when not using any template at
|
||||||
|
all:
|
||||||
|
|
||||||
|
using template same without template
|
||||||
|
─────────────────────────────────────────────────────────────────────────────────
|
||||||
|
${template0 node name} $nodename
|
||||||
|
${template1 root /} root: ${fs_free /} /
|
||||||
|
${fs_size /}
|
||||||
|
${template1 ${template2\ disk\ root} /} disk root: ${fs_free /} / ${fs_size /}
|
||||||
|
|
||||||
|
|
||||||
1mtime (format)0m
|
1mtime (format)0m
|
||||||
Local time, see man strftime to get more information about for‐
|
Local time, see man strftime to get more information about for‐
|
||||||
mat
|
mat
|
||||||
|
67
doc/conky.1
67
doc/conky.1
@ -1,4 +1,4 @@
|
|||||||
'\" -*- coding: us-ascii -*-
|
'\" t -*- coding: us-ascii -*-
|
||||||
.if \n(.g .ds T< \\FC
|
.if \n(.g .ds T< \\FC
|
||||||
.if \n(.g .ds T> \\F[\n[.fam]]
|
.if \n(.g .ds T> \\F[\n[.fam]]
|
||||||
.de URL
|
.de URL
|
||||||
@ -346,6 +346,20 @@ Shows the time range covered by a graph.
|
|||||||
\fB\*(T<\fBstippled_borders\fR\*(T>\fR
|
\fB\*(T<\fBstippled_borders\fR\*(T>\fR
|
||||||
Border stippling (dashing) in pixels
|
Border stippling (dashing) in pixels
|
||||||
|
|
||||||
|
.TP
|
||||||
|
\fB\*(T<\fBtemplateN\fR\*(T>\fR
|
||||||
|
Define a template for later use inside TEXT segments. Substitute N by a digit between 0 and 9, inclusively.
|
||||||
|
The value of the variable is being inserted into the stuff below TEXT at the corresponding position,
|
||||||
|
but before some substitutions are applied:
|
||||||
|
|
||||||
|
\&'\en' -> newline
|
||||||
|
.br
|
||||||
|
\&'\e\e' -> backslash
|
||||||
|
.br
|
||||||
|
\&'\e ' -> space
|
||||||
|
.br
|
||||||
|
\&'\eN' -> template argument N
|
||||||
|
|
||||||
.TP
|
.TP
|
||||||
\fB\*(T<\fBtotal_run_times\fR\*(T>\fR
|
\fB\*(T<\fBtotal_run_times\fR\*(T>\fR
|
||||||
Total number of times for Conky to update before quitting. Zero makes Conky run forever
|
Total number of times for Conky to update before quitting. Zero makes Conky run forever
|
||||||
@ -1255,6 +1269,57 @@ Puts a tab of the specified width, starting from column 'start'.
|
|||||||
\fB\*(T<\fBtail\fR\*(T>\fR \*(T<\fBlogfile lines (interval)\fR\*(T>
|
\fB\*(T<\fBtail\fR\*(T>\fR \*(T<\fBlogfile lines (interval)\fR\*(T>
|
||||||
Displays last N lines of supplied text text file. If interval is not supplied, Conky assumes 2x Conky's interval. Max of 30 lines can be displayed, or until the text buffer is filled.
|
Displays last N lines of supplied text text file. If interval is not supplied, Conky assumes 2x Conky's interval. Max of 30 lines can be displayed, or until the text buffer is filled.
|
||||||
|
|
||||||
|
.TP
|
||||||
|
\fB\*(T<\fBtemplateN\fR\*(T>\fR \*(T<\fB(arg1)\fR\*(T> \*(T<\fB(arg2)\fR\*(T> \*(T<\fB(arg3 ...)\fR\*(T>
|
||||||
|
Evaluate the content of the templateN configuration variable (where N is a value between 0 and 9, inclusively),
|
||||||
|
applying substitutions as described in the documentation of the corresponding configuration variable.
|
||||||
|
The number of arguments is optional, but must match the highest referred index in the template. You can use the
|
||||||
|
same special sequences in each argument as the ones valid for a template definition, e.g. to allow an argument
|
||||||
|
to contain a whitespace. Also simple nesting of templates is possible this way.
|
||||||
|
|
||||||
|
Here are some examples of template definitions:
|
||||||
|
|
||||||
|
template0 $\e1\e2
|
||||||
|
.br
|
||||||
|
template1 \e1: ${fs_used \e2} / ${fs_size \e2}
|
||||||
|
.br
|
||||||
|
template2 \e1 \e2
|
||||||
|
|
||||||
|
The following list shows sample usage of the templates defined above,
|
||||||
|
with the equivalent syntax when not using any template at all:
|
||||||
|
.TS
|
||||||
|
l l.
|
||||||
|
T{
|
||||||
|
using template
|
||||||
|
T} T{
|
||||||
|
same without template
|
||||||
|
T}
|
||||||
|
.T&
|
||||||
|
_ _
|
||||||
|
l l
|
||||||
|
l l
|
||||||
|
l l.
|
||||||
|
T{
|
||||||
|
${template0 node name}
|
||||||
|
T} T{
|
||||||
|
$nodename
|
||||||
|
T}
|
||||||
|
T{
|
||||||
|
${template1 root /}
|
||||||
|
T} T{
|
||||||
|
root: ${fs_free /} / ${fs_size /}
|
||||||
|
T}
|
||||||
|
T{
|
||||||
|
.nf
|
||||||
|
\*(T<${template1 ${template2\e disk\e root} /}\*(T>
|
||||||
|
.fi
|
||||||
|
T} T{
|
||||||
|
.nf
|
||||||
|
\*(T<disk root: ${fs_free /} / ${fs_size /}\*(T>
|
||||||
|
.fi
|
||||||
|
T}
|
||||||
|
.TE
|
||||||
|
|
||||||
.TP
|
.TP
|
||||||
\fB\*(T<\fBtime\fR\*(T>\fR \*(T<\fB(format)\fR\*(T>
|
\fB\*(T<\fBtime\fR\*(T>\fR \*(T<\fB(format)\fR\*(T>
|
||||||
Local time, see man strftime to get more information about format
|
Local time, see man strftime to get more information about format
|
||||||
|
Loading…
Reference in New Issue
Block a user