### fstat-1.0 README file

    	=========================================================
    	      File Status Information  -- Version %R% (%E%)
    	=========================================================
    	Copyright (1994): Martin Weitzel, Darmstadt, Germany

    The "fstat"-command is much similar to the well-know "ls", but with two
    important differences:

         a)	file names are not supplied as command line arguments
    	but read from standard input;
         b) output format can be freely chosen, and there is some
    	information that "ls" cannot produce;

    Here is a full description of "fstat" and its features.  It can be
    obtained by calling "fstat" with the (single) option "-help".
    ------------------------------------------------------------------------
    	***** fstat -- Print File Status Information *****

    USAGE:
    	fstat [ -e[msg] ] [ -c[nnn] ] [ +format ]

    DESCRIPTION:
    	This program reads file names from stdin and prints further
    	information, mainly from the file's i-node.  Output format
    	can be tailored by a format-string that follows a plus sign.
    	The options are:
    	-e[msg]  message to print for files that cannot be stat()-ed
    	         (if 'msg' is missing, such files are ignored)
    	-c[nnn]  number of bytes to include into the checksum
    	         (see also %H-place-holder, if 'nnn' is missing or
    		  zero, checksum is calculated for the complete file)
    	Within the format string certain place-holders are recognized:
    	  %t  file type (in octal)
    	  %T  file type (coded as in 'ls -l')
    	  %V  file type (in words)
    	  %p  permissions (in octal);
    	  %P  permissions (in coded as in 'ls -l');
    	  %d  device number (in decimal);
    	  %i  inode number (in decimal);
    	  %n  number of links (in decimal);
    	  %u  file owner (decimal UID)
    	  %U  file owner (name)
    	  %g  file group (decimal GID)
    	  %G  file group (name)
    	  %s  file size in byte
    	  %a  access time (seconds since urknall)
    	  %A  access time (YYMMDDhhmmss)
    	  %c  creation time (seconds since urknall)
    	  %C  creation time (YYMMDDhhmmss)
    	  %m  modification time (seconds since urknall)
    	  %M  modification time (YYMMDDhhmmss)
    	  %h  file header (first two bytes in hex);
    	  %H  checksum of first portion of file;
    	  %f  last part of file name;
    	  %F  full file name (as read from input);
    	An optional number between '%' and format specification is
    	treated as field width.  Output is always right justified in
    	a zone of the given width.  If a value does not fit into that
    	zone, more room is provided automatically.  To print a %-sign,
    	two such characters must be used in sequence.  Other characters
    	in the format string are printed as they appear, except that
    	some basic '\'-escape-sequences are recognized and interpreted
    	as usual.  A '\c' in the format string will stop any further
    	interpretation and will also suppress the new line character
    	that otherwise terminates each line of output.

    	NOTE that while in a user defined error message (see 'e'-option
    	above) place holders are interpreted in the same way as in the
    	format string, when this message is printed only '%f' and '%F'
    	have meaningful values; in addition, '%e' may be used to print
    	the current value of 'errno'.
    ------------------------------------------------------------------------

    COMPILATION:
    ------------
    To compile the sources, you should first have a look into the file
    "COMPILE", which gives you the opportunity to change some of the
    compile time options.  This file may also contain hints on the compiler
    flags to use.

    Compilation is the default target in the Makefile.  If you have to change
    any compiler options or the compiler itself, you can do this from the
    command line when calling make.  Alternatively you may change the Makefile.

    INSTALLATION:
    -------------
    To install the programs, you should first have a look into the file
    "INSTALL" which gives you the opportunity to change some of the
    installation options.

    Depending on your permissions and where you want to install the programs,
    it may then be necessary to "su" to the appropriate account (or become
    root) and then to type "sh INSTALL".