Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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

v1.0.0				 April 18, 2001 			  XIN(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=xin&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help