Manual Reference Pages  - READXS (1)

NAME

readxs - Display xs-httpd counter file information

CONTENTS

Synopsis
Description
Files
Examples
Diagnostics
See Also

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


.Ex -std readxs

SEE ALSO

httpd(1), clearxs(1), httpd_ssi(7)

The project homepage: http://www.xs-httpd.org/


March 26, 1996 READXS (1) xs-httpd/3.5