Content-type: text/html Manpage of XTEE

XTEE

Section: PUPS commands (1)
Updated: 21st August 1999
Index Return to Main Contents
 

NAME

xtee  extended tee command

 

SYNOPSIS

xtee [ -pipe command pipeline ] | [ -tee_file <tee_file_name> ][ -nice cardinal ][ -argf argument_file ][ -help ][ -usage ][ -verbose ][ -growth_protection retries ][ -slots ][ -slotinfo ][ -compress ][ -pipe ] < stdin > stdout >& <log file>

 

DESCRIPTION

xtee is a filter which is based on the standard UNIX filter tee(1). xtee(1) takes data from stdin and writes it to stdout(1). In addition, the data is also written to the file or command pipeline specified by the xtee(1) command tail options.

 

OPTIONS


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

-growth_protection retrys causes the system to retry an sbrk(2) 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(2) fails.

-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 xtee(1) is 4.

-usage displays program shortform usage.

-version displays program version number.

-slots displays the pups(3) libraries used in application in short form.

-verbose turns on error logging (to standard error).

-slotinfo displays the pups(3) libraries used in application in long form giving version, source language, programmer and copyright.

-pipe command pipeline specifies a command pipeline to which stdin is to be copied.

-tee_file tee_file_name specifies the name of the tee file to which data is to be diverted. This option is only valid if -pipe has not been specified.

-fifo specifies that the tee file te_file_name will be created as a System V FIFO [named pipe] rather than a regular file. This option is only valid if -pipe has not been specified.

-compress uses the pipestream functions [see pups(3) ] to compress the output to the tee file. If this option is selected, the tee file must be a regular file. This option is only valid if -pipe has not been specified.

 

LIBRARIES

xtee(1) makes use of PUPS libraries [Portable UNIX Programming System], see pups(3)

 

COPYRIGHT

(C) Tumbling Dice Ltd, Gosforth.

 

PROGRAMMER

M.A. O'Neill.


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
LIBRARIES
COPYRIGHT
PROGRAMMER

This document was created by man2html, using the manual pages.
Time: 13:53:35 GMT, January 11, 2008