NAME

       recordio - record the input and output of a program

SYNTAX

       recordio program [ arg ...  ]

DESCRIPTION

       recordio runs program with the given arguments.  It prints lines to
       stderr showing the input and output of program.

       At the beginning of each line on stderr, recordio inserts the program
       process ID, along with < for input or > for output.  At the end of each
       line it inserts a space, a plus sign, or [EOF]; a space indicates that
       there was a newline in the input or output, and [EOF] indicates the end
       of input or output.

       recordio prints every packet of input and output immediately.  It does
       not attempt to combine packets into coherent stderr lines.  For
       example,

            recordio sh -c 'cat /dev/fd/8 2>&1' > /dev/null

       could produce

            5135 > cat: /dev/fd/8: Bad file descriptor
            5135 > [EOF]

       or

            5135 > cat: +
            5135 > /dev/fd/8+
            5135 > : +
            5135 > Bad file descriptor
            5135 > [EOF]

       recordio uses several lines for long packets to guarantee that each
       line is printed atomically to stderr.

       recordio runs as a child of program.  It exits when it sees the end of
       program's output.

SEE ALSO

       tcpserver(1)