Content-type: text/html Manpage of XCAT

XCAT

Section: Pups commands (1)
Updated: 21st April 2005
Index Return to Main Contents
 

NAME


xcat  the dynamic pipeline insertion point marker  

SYNOPSIS

xcat [ -nice cardinal ][ -argf argument_file ][ -growth_protection ][ -help ][ -usage ][ -version ][ -slots ][ -slotinfo ] < <stdin> > <stdout> >& <log file>

 

DESCRIPTION

xcat provides a mechanism for inserting processes (and sub-pipelines) into a running process pipeline dynamically. Typically, a process wishing to insert itself into a running pipeline would open a PSRP channel to xcat(1) and then replac xcat(1) in the pipeline via the PSRP overlay (builtin) command. This facility allows the user to dynamically insert monitoring filters (which may require transient facilities like an X display) into a running pipeline.

   

OPTIONS


  -help invokes the on-line context help system for the file system watcher. This "man" page is displayed. The process then exits.

-usage displays shortform usage string.

-growth_protection <retrys> causes the system to retry an sbrk(3) call up to retrys times. This option permits the program to wait until the core that it requires is available rather than simply exiting if sbrk(3) fails.

-version displays program version number.

-slots displays short form pups(3) library dependencies.

-slotinfo displays long form pups(3) library dependencies.

-argf argument_file tells the filter to take its command line arguments from the specified argument_file. The data format of the argument file is:

# ... optional comment line ...
-argflag [1]
argument_parameter [1,1]
argument_parameter [1,2]

argument_parameter [1,n]

# ... optional comment line ...
-argflag [2]
argument_parameter [1,1]
argument_parameter [1,2]

argument_parameter [1,n]

  -nice cardinal determimes the niceness at which the filter is scheduled. In keeping with all UNIX user processes, nice must be a cardinal between 0 and 20. The default niceness for xcat(1) is 4.

-usage displays program shortform usage.

-version displays program version number.

 

PSRP OPTIONS

dataflow off | stdout | psrp | ptap switches the output of xcat(1) to the specified stream. If ptap is specified output is sent to both standard output and psrp streams.

 

LIBRARIES

xcat(1) uses the PUPS libraries, see pups(3)

 

COPYRIGHT

(C) Tumbling Dice Ltd, Gosforth.

 

PROGRAMMER

M.A. O'Neill.

 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
PSRP OPTIONS
LIBRARIES
COPYRIGHT
PROGRAMMER
This document was created by man2html, using the manual pages.
Time: 13:53:35 GMT, January 11, 2008