home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 22 gnu / 22-gnu.zip / GNUTUE.ZIP / man / tail.man < prev    next >
Text File  |  1992-07-18  |  2KB  |  60 lines

  1. NAME
  2.      tail - output the last part of files
  3.  
  4. SYNOPSIS
  5.      tail [-c [+]N[bkm]] [-n [+]N] [-fqv]  [--bytes=[+]N[bkm]]  [--lines=[+]N]
  6.      [--follow] [--quiet] [--silent] [--verbose] [file...]
  7.  
  8.      tail [{-,+}Nbcfklmqv] [file...]
  9.  
  10. DESCRIPTION
  11.      This manual page documents the GNU version of tail.  tail prints the last
  12.      part  (10  lines  by  default) of each given file; it reads from standard
  13.      input if no files are given or when a filename of `-' is encountered.  If
  14.      more  than one file is given, it prints a header consisting of the file's
  15.      name enclosed in `==>' and `<==' before the output for each file.
  16.  
  17.      The GNU tail can output any amount of  data,  unlike  the  Unix  version,
  18.      which  uses a fixed size buffer.  It has no -r option (print in reverse).
  19.      Reversing a file is really a different job from printing  the  end  of  a
  20.      file;  the  BSD  tail can only reverse files that are at most as large as
  21.      its buffer, which is typically 32k.  A reliable and more versatile way to
  22.      reverse files is the GNU tac command.
  23.  
  24.      OPTIONS
  25.  
  26.      tail accepts two option formats:  the  new  one,  in  which  numbers  are
  27.      arguments  to  the option letters, and the old one, in which a `+' or `-'
  28.      and optional number precede any option letters.
  29.  
  30.      If a number (`N') starts with a `+', tail begins printing  with  the  Nth
  31.      item from the start of each file, instead of from the end.
  32.  
  33.      -c N, --bytes N
  34.           Tail by N bytes.  N is a nonzero integer, optionally followed by one
  35.           of the following characters to specify a different unit.
  36.  
  37.      b    512-byte blocks.
  38.  
  39.      k    1-kilobyte blocks.
  40.  
  41.      m    1-megabyte blocks.
  42.  
  43.      -f, --follow
  44.           Loop forever trying to read more characters at the end of the  file,
  45.           on the assumption that the file is growing.  Ignored if reading from
  46.           a pipe.  Cannot be used if more than one file is given.
  47.  
  48.      -l, -n N, --lines N
  49.           Tail by N lines.
  50.  
  51.      -q, --quiet, --silent
  52.           Never print filename headers.
  53.  
  54.      -v, --verbose
  55.           Always print filename headers.
  56.  
  57.      The long-named options can be introduced with `+' as well  as  `--',  for
  58.      compatibility with previous releases.  Eventually support for `+' will be
  59.      removed, because it is incompatible with the POSIX.2 standard.
  60.