---

Manual Reference Pages  - READXS (1)

---

readxs - Display xs-httpd counter file information

CONTENTS

Synopsis
Description
Files
Examples
Diagnostics
See Also

readxs [-d-| -m -| -t -| -l -| -v ] [-w number] URI

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.

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.

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

.Ex -std readxs

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

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