GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
retail(1) FreeBSD General Commands Manual retail(1)

retail - a program to track logfile changes.

retail [-h] [-p prefix] [-s suffix] [-d] files ...

This manual page documents briefly the program retail.

retail tries to be an intelligent incremental logfile reader. It will read a file or list of files given as arguments, and output any new contents thereof to stdout. If the file has changed, it will attempt to handle the situation intelligently.

It keeps track of what parts of a file it has read in the past, and only reads lines which have been appended since the last time it was asked to read the file(s) in question. It does this via several methods. First, it tracks the position in the file in bytes, and tries to return there on subsequent calls. If it is unable to return to the previous position, or if the data found at the previous position has changed since last time, it will rewind to the beginning of the file, and search for the data which was at the last known position. Failing any of those methods to find it's last known position, it will rewind to the very beginning of the file, and read and output to stdout from there. Oh yeah, it tracks it's state info in offset files named (by default) /path/file.aoffset, in the format of "position:last_known_data".

This program does NOT follow the usual GNU command line syntax, with long options starting with two dashes (`-'). It uses only short options as documented below
-d
Output debug info on stderr (probably only of use for developers like me).
-h
Show summary of options.
-V
Show version of program.
-s suffix
Change the default suffix to something other than .aoffset.
-p prefix
Specify an alternative directory to place the offset files into.

This program is not documented fully anywhere else that I know of, not even in The Rise and Fall of a Fooish Bar.

This manual page was written by A.L.Lambert <al@xjack.org>, for the Debian GNU/Linux system (but may be used by others).

Search for    or go to Top of page |  Section 1 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.