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 [ argu-
       ments...	 ]

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  com-
       mand will only be executed when there is	data waiting to	be written.

       If  command exits or closes the pipe before the entire section is writ-
       ten an error will occur and xin will exit. There	is no way of  recover-
       ing  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)

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