freedt/recordio.8

   1 ." Text automatically generated by txt2man-1.4.7
   2 .TH recordio  "September 25, 2006" "" ""
   3 .SH NAME
   4 \fBrecordio \fP- recordio records the input and output of a program.
   5 .SH SYNOPSIS
   6 .nf
   7 .fam C
   8 \fBrecordio\fP \fIprog\fP
   9 .fam T
  10 .fi
  11 .SH DESCRIPTION
  12
  13 \fBrecordio\fP runs \fIprog\fP. It prints lines to descriptor 2 showing the input and output of \fIprog\fP.
  14 .PP
  15 At the beginning of each line on descriptor 2, \fBrecordio\fP inserts the \fIprog\fP process ID, along with < for input or > for output. At the end of each line it inserts +, a space, or [EOF]; a space indicates that there was a new line in the input or output, and [EOF] indicates the end of input or output.
  16 .PP
  17 \fBrecordio\fP prints every packet of input and output immediately. It does not attempt to combine packets into coherent lines. For example,
  18 .PP
  19 .nf
  20 .fam C
  21                 recordio sh -c 'cat /dev/fd/8 2>&1' > /dev/null
  22
  23 .fam T
  24 .fi
  25 could produce
  26 .PP
  27 .nf
  28 .fam C
  29                 5135 > cat: /dev/fd/8: Bad file descriptor
  30                 5135 > [EOF]
  31
  32 .fam T
  33 .fi
  34 or
  35 .PP
  36 .nf
  37 .fam C
  38                 5135 > cat: +
  39                 5135 > /dev/fd/8+
  40                 5135 > : +
  41                 5135 > Bad file descriptor
  42                 5135 > [EOF]
  43
  44 .fam T
  45 .fi
  46 if the cat program prints several packets.
  47 .PP
  48 \fBrecordio\fP uses several lines for long packets to guarantee that each line is printed atomically.
  49 \fBrecordio\fP runs as a child process of \fIprog\fP. It exits when it sees the end of \fIprog\fP's output.