|
READXS(1) |
FreeBSD 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.