DragonFly On-Line Manual Pages

XIN(1)                            User Manual                           XIN(1)

NAME
       xin - split standard input and pipe into a command

SYNOPSIS
       xin [ -h | -v ]
       xin [ -b size | -l lines | -p size | -f code ] -e command [
       arguments...  ]

DESCRIPTION
       xin reads from standard input and splits the data up into sections,
       piping each section to a separate command.  If both -b and -l are used
       xin will split the section as soon as either limit is reached. A
       command will only be executed when there is data waiting to be written.

       If command exits or closes the pipe before the entire section is
       written an error will occur and xin will exit. There is no way of
       recovering from this situation without losing data since xin cannot
       know if the data has been read and processed - this is a limitation of
       pipes.

       A size may have a multiplier suffix: 'b' for 512, 'k' for 1024, and 'm'
       for 1024k.

OPTIONS
   -b, --bytes
       Limit each section to size bytes.

   -l, --lines
       Limit each section to lines lines.

   -p, --padding
       Zero extend any section of input written to command to a multiple of
       size bytes. This option can be used by itself for padding a data stream
       without splitting. The default is no padding.

   -f, --fatal-code
       When command exits with error code xin will exit with a fatal error.
       The default is 255.

   -e, --exec
       Use to denote the end of xin arguments and the beginning of command.

   -V, --version
       Display version and exit.

   -h, --help
       Display usage information and exit.

AUTHOR
       Mark Pulford <mark@kyne.com.au>

SEE ALSO
       split(1).

       http://www.kyne.com.au/~mark/software.html
       <http://www.kyne.com.au/~mark/software.html>

v1.0.0                          April 18, 2001                          XIN(1)