DragonFly On-Line Manual Pages

READXS(1)              DragonFly 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
     information 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
             location 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
     standard 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 ALSO
     httpd(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