GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  XIN (1)

NAME

xin - split standard input and pipe into a command

CONTENTS

Synopsis
Description
Options
Author

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

Search for    or go to Top of page |  Section 1 |  Main Index


v1.0.0 XIN (1) April 18, 2001

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.