READXS(1) BSD General Commands Manual READXS(1)NAME
readxs — Display xs-httpd counter file information
SYNOPSIS
readxs [-d | -m | -t | -l | -v] [-w number] URI
DESCRIPTION
Read statistics from the xs-httpd pageview counter data. This informa‐
tion is usually displayed using the webserver's server-side include
count-* directives, explained in httpd_ssi(7). This program is mainly
used for debugging purposes.
The following options are available
-d display the ‘day’ type counter
-m display the ‘month’ type counter
-t display the ‘total’ type counter (this is the default)
-l display last access timestamp
-v display counter datafile version id (for debugging purposes)
-w number
set the selected type counter to the specified number. This
option may only be used by an administrator and should be used
with care as it can be used to set "impossible" values. If you
want to reset the counters, use clearxs(1) instead.
FILES
xs-counter.data
The data file containing all counter details. The default loca‐
tion for this file is in SystemRoot/logs/.
xs-counter.lock
Temporary lock file used when writing (incrementing or resetting)
counter data. Stale lock files will not be removed automatically.
EXAMPLES
Say you have a counter installed on your webpage using the server's
server side includes as explained in httpd_ssi(7). Say this page is
called index.html. Then you can get the value of this counter on stan‐
dard output for use in shell scripts using this program. In this case you
could type:
readxs /~username/index.html
DIAGNOSTICS
The readxs utility exits 0 on success, and >0 if an error occurs.
SEE ALSOhttpd(1), clearxs(1), httpd_ssi(7)
The project homepage: http://www.xs-httpd.org/
xs-httpd/3.5 March 26, 1996 xs-httpd/3.5