mdw@git.distorted.org.uk Git - misc/blob - stamp.1

   1 .\" -*-nroff-*-
   2 .TH stamp 1 "11 August 2006" "Straylight/Edgeware"
   3 .SH NAME
   4 stamp \- copy files, prefixing each line with a datestamp
   5 .SH SYNOPSIS
   6 .B stamp
   7 .RB [ \-z ]
   8 .RB [ \-f
   9 .IR format ]
  10 .RI [ file ...]
  11 .SH DESCRIPTION
  12 Copies files, like
  13 .BR cat (1),
  14 except that it prefixes each line with a datestamp indicating when the
  15 line was recieved.  The datestamp is formatted using
  16 .BR strftime (3),
  17 and can use any formatting codes permitted by that function.
  18 .PP
  19 Options available:
  20 .TP
  21 .B \-h, \-\-help
  22 Show a help message for
  23 .BR stamp .
  24 .TP
  25 .B \-v, \-\-version
  26 Show version number for
  27 .BR stamp .
  28 .TP
  29 .B \-u, \-\-usage
  30 Show usage message for
  31 .BR stamp .
  32 .TP
  33 .BI "\-f, \-\-format=" format
  34 Use
  35 .I format
  36 as the
  37 .BR strftime (3)
  38 format string for the datestamps.  Note that if the datestamp is meant
  39 to be separated from the rest of the line by anything, then that
  40 separator should be part of the format string.
  41 .TP
  42 .B \-z, \-\-utc, \-\-zulu
  43 Use UTC (Zulu time) instead of local time for datestamps.
  44 .SH BUGS
  45 While
  46 .B stamp
  47 ensures that its input is line-buffered only, it's possible that
  48 whatever is providing that input delays it arbitrarily due to its own
  49 buffering.  There's not much to be done about this.
  50 .SH AUTHOR
  51 Mark Wooding, <mdw@distorted.org.uk>
  52 .SH SEE ALSO
  53 .BR cat (1),
  54 .BR strftime (3).