Content-type: text/html Manpage of FSW

FSW

Section: Pups commands (1)
Updated: 17th July 1999
Index Return to Main Contents
 

NAME


fsw  the file system watcher - intelligent pipe o/p filter  

SYNOPSIS

fsw [ -nice cardinal ][ -argf argument_file ][ -growth_protection ][ -help ][ -usage ][ -version ][ -slots ][ -slotinfo ][ -fs_blocks block_count ][ -homeostatic output file name [ -guard ]] < <stdin> > <stdout> >& <log file>

 

DESCRIPTION

fsw provides a mechanism for watching a file system which is being written to by a pipeline. If the file system becomes full, this is detected by fsw(1) which will then suspend the pipeline processes until space is once more available on the target output file system.


   

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

-fs_blocks block_cnt specifies the number of blocks remaining on the target filesystem below which fsw(1) will suspend its pipeline.

-homeostatic output file name tells fsw(1) to use the standard PUPS file system homeostat to protect the output file. Although output file name can be any file on the system, applications using fsw(1) expect it to be the same file that fsw(1) standard output is redirected to.

-guard tells itg(1) to persist after all data is written to output file name in order to provide homeostatic protection for it. Only valid with -homeostatic directive.

 

LIBRARIES

fsw(1) uses the PUPS libraries, 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