home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / prgramer / unix / doc / tail.man < prev    next >
Text File  |  1993-06-13  |  3KB  |  133 lines
  1.  
  2.  
  3.  
  4. TAIL(1L)                                                 TAIL(1L)
  5.  
  6.  
  7. NAME
  8.        tail - output the last part of files
  9.  
  10. SYNOPSIS
  11.        tail  [-c  [+]N[bkm]] [-n [+]N] [-fqv] [--bytes=[+]N[bkm]]
  12.        [--lines=[+]N] [--follow] [--quiet] [--silent] [--verbose]
  13.        [--help] [--version] [file...]
  14.  
  15.        tail [{-,+}Nbcfklmqv] [file...]
  16.  
  17. DESCRIPTION
  18.        This  manual page documents the GNU version of tail.  tail
  19.        prints the last part (10 lines by default) of  each  given
  20.        file;  it  reads from standard input if no files are given
  21.        or when a filename of `-' is encountered.   If  more  than
  22.        one  file  is  given, it prints a header consisting of the
  23.        file's name enclosed in `==>' and `<==' before the  output
  24.        for each file.
  25.  
  26.        The  GNU  tail  can  output any amount of data, unlike the
  27.        Unix version, which uses a fixed size buffer.  It  has  no
  28.        -r  option (print in reverse).  Reversing a file is really
  29.        a different job from printing the end of a file;  the  BSD
  30.        tail  can  only reverse files that are at most as large as
  31.        its buffer, which is typically 32k.  A reliable  and  more
  32.        versatile way to reverse files is the GNU tac command.
  33.  
  34.    OPTIONS
  35.        tail  accepts  two  option  formats: the new one, in which
  36.        numbers are arguments to the option letters, and  the  old
  37.        one, in which a `+' or `-' and optional number precede any
  38.        option letters.
  39.  
  40.        If a number (`N') starts with a `+', tail begins  printing
  41.        with  the Nth item from the start of each file, instead of
  42.        from the end.
  43.  
  44.        -c N, --bytes N
  45.               Tail by N bytes.  N is a nonzero  integer,  option-
  46.               ally followed by one of the following characters to
  47.               specify a different unit.
  48.  
  49.               b      512-byte blocks.
  50.  
  51.               k      1-kilobyte blocks.
  52.  
  53.               m      1-megabyte blocks.
  54.  
  55.        -f, --follow
  56.               Loop forever trying to read more characters at  the
  57.               end of the file, on the assumption that the file is
  58.               growing.  Ignored if reading from a pipe.  If  more
  59.               than  one file is given, tail prints a header when-
  60.               ever it gets  output  from  a  different  file,  to
  61.  
  62.  
  63.  
  64. FSF                     GNU Text Utilities                      1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. TAIL(1L)                                                 TAIL(1L)
  71.  
  72.  
  73.               indicate which file that output is from.
  74.  
  75.        -l, -n N, --lines N
  76.               Tail  by  N lines.  -l is only recognized using the
  77.               old option format.
  78.  
  79.        -q, --quiet, --silent
  80.               Never print filename headers.
  81.  
  82.        -v, --verbose
  83.               Always print filename headers.
  84.  
  85.        --help Print a usage message and exit with a non-zero sta-
  86.               tus.
  87.  
  88.        --version
  89.               Print  version  information  on standard error then
  90.               exit.
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130. FSF                     GNU Text Utilities                      2
  131.  
  132.  
  133.