From f0b2caeae02d2ca2e9fdef7dcf5ceaa7f9524ef8 Mon Sep 17 00:00:00 2001 From: hsn <> Date: Wed, 16 Jul 2003 18:28:53 +0000 Subject: [PATCH] Initial revision --- man/fcatcmd.1 | 50 ++++++++++ man/fcdcmd.1 | 64 +++++++++++++ man/fducmd.1 | 82 ++++++++++++++++ man/ffindcmd.1 | 247 ++++++++++++++++++++++++++++++++++++++++++++++++ man/flscmd.1 | 66 +++++++++++++ man/fmkdir.1 | 28 ++++++ man/frmcmd.1 | 38 ++++++++ man/frmdircmd.1 | 38 ++++++++ man/fver.1 | 20 ++++ 9 files changed, 633 insertions(+) create mode 100644 man/fcatcmd.1 create mode 100644 man/fcdcmd.1 create mode 100644 man/fducmd.1 create mode 100644 man/ffindcmd.1 create mode 100644 man/flscmd.1 create mode 100644 man/fmkdir.1 create mode 100644 man/frmcmd.1 create mode 100644 man/frmdircmd.1 create mode 100644 man/fver.1 diff --git a/man/fcatcmd.1 b/man/fcatcmd.1 new file mode 100644 index 0000000..90b47fc --- /dev/null +++ b/man/fcatcmd.1 @@ -0,0 +1,50 @@ +.TH FCAT 1 "27 January 1993" FSP +.SH NAME +fcatcmd, fcat \- copy files in the FSP database to stdout +.SH SYNOPSIS +.B fcatcmd +[-r] +.I filename +\&.\|.\|. +.LP +.B fcat +[-r] +.I filename +\&.\|.\|. +.SH DESCRIPTION +.LP +For each file named in the argument list, +.B fcatcmd +reads the file and writes the content of the file to its +.B stdout. +.LP +.B fcatcmd +will perform +.B csh +file name globbing based on file and directory information +obtained from the FSP database. +.LP +Since user's command shells generally cannot do the proper globbing for +this program, it is recommended that user defines a shell alias or +function to turn off command shell globbing before running this program. +.B csh +example: +.LP +.nf +alias fcat \e(set noglob\e; exec fcatcmd \e!\e*\e) +.fi +.SH ARGUMENTS +.LP +.B -r +-- forces +.B fcatcmd +to recursively show all files in given directories. +.LP +.SH ENVIRONMENT +.LP +See fsp_env(7) for list of used environment variables. +.SH "SEE ALSO" +.PD +fcatcmd(1), fcdcmd(1), fgetcmd(1), fgrabcmd(1), flscmd(1), fmkdir(1), +fprocmd(1), fput(1), frmcmd(1), frmdircmd(1), fver(1), fducmd(1), +fhostcmd(1), fspd(1), fsp_prof(5), ffindcmd(1), fsp_env(7) diff --git a/man/fcdcmd.1 b/man/fcdcmd.1 new file mode 100644 index 0000000..fc948af --- /dev/null +++ b/man/fcdcmd.1 @@ -0,0 +1,64 @@ +.TH FCD 1 "8 December 1991" FSP +.SH NAME +fcdcmd, fcd \- change client's current working directory in the FSP database +.SH SYNOPSIS +.B fcdcmd +.I path +.LP +.B fcd +.I path +.SH DESCRIPTION +.LP +If no paths are given, / is used as the current working directory. If +.I path +begins with a /, +.B fcdcmd +uses it as the current working directory. Otherwise, +.B fcdcmd +appends +.I path +to the end of the current working directory. In both cases, +.B fcdcmd +simplifies the new path and writes it to the +.I stdout. +In order for the effect of +.B fcdcmd +to be felt in subsequent FSP transactions, user needs to save the +.I stdout +output in the +.I FSP_DIR +variable. If the change is successful, +.B fcdcmd +will display the protection setting of the new working directory. +.LP +.B fcdcmd +will perform +.B csh +file name globbing based on file and directory information +obtained from the FSP database. +.LP +Since user's command shells generally cannot do the proper globbing for +this program, it is recommended that user defines a shell alias or +function to turn off command shell globbing before running this program. +.B csh +example: +.LP +.nf +alias fcd setenv FSP_DIR \e`\e(set noglob\e; exec fcdcmd \e!\e*\e)\e` +.fi +.SH ENVIRONMENT +.LP +See fsp_env(7) for list of used environment variables. +.SH "SEE ALSO" +.PD +fcatcmd(1), fcdcmd(1), fgetcmd(1), fgrabcmd(1), flscmd(1), fmkdir(1), +fprocmd(1), fput(1), frmcmd(1), frmdircmd(1), fver(1), fducmd(1), +fhostcmd(1), fspd(1), fsp_prof(5), ffindcmd(1), fsp_env(7) +.br +.ne 5 +.SH BUGS +.LP +If more than one +.B path +is given, only the first one will be used. +The rest will be silently ignored. diff --git a/man/fducmd.1 b/man/fducmd.1 new file mode 100644 index 0000000..bd48f59 --- /dev/null +++ b/man/fducmd.1 @@ -0,0 +1,82 @@ +.TH FDU 1 "7 April 1993" FSP +.SH NAME +fducmd, fdu \- display the number of disk blocks used per directory or file +.SH SYNOPSIS +.B fducmd +[ +.B \-s +] +[ +.B \-a +] +[ +.B \-r +] +[ +.I filename +.B .\|.\|. +] +.LP +.B fdu +[ +.B \-s +] +[ +.B \-a +] +[ +.B \-r +] +[ +.I filename +.B .\|.\|. +] +.SH DESCRIPTION +.B fdu +gives the number of kilobytes contained in all files and, recursively, +directories within each specified directory or file +.IR filename . +If +.I filename +is missing, +.RB ` . ' +(the current directory) is used. +.LP +.SH OPTIONS +.TP +.B \-s +Only display the grand total for each of the specified +.IR filename s. +.TP +.B \-a +Generate an entry for each file. +Entries are generated only for each directory in the absence of this option. +.TP +.B \-r +Recursively go down in the directory tree and show deeper entries, too. +In absence of this option the deeper directory tree branches are only counted +belonging to their parent in the top level directory. +.LP +.B fducmd +will perform +.B csh +file name globbing based on file and directory information +obtained from the FSP database. +.LP +Since user's command shells generally cannot do the proper globbing for +this program, it is recommended that user defines a shell alias or +function to turn off command shell globbing before running this program. +.B csh +example: +.LP +.nf +alias fdu \e(set noglob\e; exec fducmd \e!\e*\e) +.fi +.SH ENVIRONMENT +.LP +See fsp_env(7) for list of used environment variables. +.SH "SEE ALSO" +.PD +fcatcmd(1), fcdcmd(1), fgetcmd(1), fgrabcmd(1), flscmd(1), fmkdir(1), +fprocmd(1), fput(1), frmcmd(1), frmdircmd(1), fver(1), fducmd(1), +fhostcmd(1), fspd(1), fsp_prof(5), ffindcmd(1), fsp_env(7) diff --git a/man/ffindcmd.1 b/man/ffindcmd.1 new file mode 100644 index 0000000..90b61b2 --- /dev/null +++ b/man/ffindcmd.1 @@ -0,0 +1,247 @@ +.TH FFIND 1 "14 April 1993" FSP +.SH NAME +ffindcmd, ffind \- find files by name or by other characteristics in FSP database +.SH SYNOPSIS +.B ffindcmd +.I pathname-list expression +.br +.B ffind +.I pathname-list expression +.LP +.SH DESCRIPTION +.B ffindcmd +recursively descends the directory hierarchy for each +pathname in the +.IR pathname-list , +seeking files that match a logical +.I expression +written using the operators listed below. +.SH USAGE +.SS Operators +In the descriptions, the argument +.I n +is used as a decimal integer where +.BI + n +means more than +.IR n , +.BI \- n +means less than +.IR n , +and +.I n +means exactly +.IR n . +All three maybe used if an integer argument is needed. +.I +.TP 15 +.BI \-name " filename" +True if the +.I filename +argument matches the current file name. +Shell argument syntax can be used if escaped (watch out for +.BR [ ", " +.BR ? " and " +.BR * ")." +.TP +.B \-prune +Always yields true. Has the side effect of pruning the search +tree at the file. That is, if the current path name is a directory, +.B ffindcmd +will not descend into that directory. +.TP +.BI \-type " c" +True if the type of the file is +.IR c , +where +.I c +is one of: +.RS +.RS +.TP +.PD 0 +.B d +for directory +.TP +.B f +for plain file +.RE +.RE +.PD +.TP +.BI \-size " n" +True if the file is +.I n +blocks long (512 bytes per block). +If +.I n +is followed by a +.BR c , +the size is in characters. +.TP +.BI \-time " n" +True if the file has been accessed/modified/changed in +.I n +days. +.TP +.BI \-exec " command" +True if the executed +.I command +returns a zero value as exit status. +The end of +.I command +must be punctuated by an escaped semicolon. +A command argument +.B {\|} +is replaced by the current pathname. +.TP +.BI \-ok " command" +Like +.B \-exec +except that the generated command is written on +the standard output, then the standard input is read +and the command executed only upon response +.BR y . +.TP +.B \-print +Always true; the current pathname is printed. +.TP +.B \-ls +Always true; +prints current pathname together +with its associated statistics. +These include +size in blocks (512 bytes), +protection mode, +number of hard links, +user, +group, +size in bytes, +and modification time. +.br +Note: formatting is done internally, +without executing the +.B fls +program. +.TP +.BI \-newer " file" +True if the current file has been modified more recently than the +argument +.IR filename . +.TP +.BI ( expression ) +True if the parenthesized +.I expression +is true. +.br +Note: Parentheses are special to the shell and must be escaped. +.TP +.BI ! primary +True if the +.I primary +is false +.RB ( ! +is the unary +.I not +operator). +.HP +.I primary1 +[ +.B \-a +] +.I primary2 +.br +True if both +.I primary1 +and +.I primary2 +are true. +The +.B \-a +is not required. It is implied by the juxtaposition of two +primaries. +.HP +.IB primary1 " \-o " primary2 +.br +True if either +.I primary1 +or +.I primary2 +is true +.RB "(" \-o " is the" +.I or +operator). +.LP +.B ffindcmd +will perform +.B csh +file name globbing based on file and directory information +obtained from the FSP database. +.LP +Since user's command shells generally cannot do the proper globbing for +this program, it is recommended that user defines a shell alias or +function to turn off command shell globbing before running this program. +.B csh +example: +.LP +.nf +alias ffind \e(set noglob\e; exec ffindcmd \e!\e*\e) +.fi +.SH EXAMPLE +To find all the files called +.B intro.ms +starting from the current +directory: +.LP +.nf +example% ffind . \-name intro.ms \-print +\&.\|/manuals/assembler/intro.ms +\&.\|/manuals/sun.core/intro.ms +\&.\|/manuals/driver.tut/intro.ms +\&.\|/manuals/sys.manager/uucp.impl/intro.ms +\&.\|/supplements/general.works/unix.introduction/intro.ms +\&.\|/supplements/programming.tools/sccs/intro.ms +example% +.fi +.LP +To recursively print all files names in the current directory and below, +but skipping +.SM SCCS +directories: +.LP +.nf +example% ffind . \-name \s-1SCCS\s0 \-prune \-o \-print +example% +.fi +.LP +To recursively print all files names in the current directory and below, +skipping the contents of +.SM SCCS +directories, but printing out the +.SM SCCS +directory name: +.nf +example% ffind . \-print \-name \s-1SCCS\s0 \-prune +example% +.fi +.LP +To remove files named +.B a.out +or +.B *.o +that have not been accessed for a week or more +.nf +example% ffind . \e( \-name a.out \-o \-name *.o \e) \-time +7 \-exec frm {\|} \e; +.fi +.SH ENVIRONMENT +.LP +See fsp_env(7) for list of used environment variables. +.SH "SEE ALSO" +.PD +fcatcmd(1), fcdcmd(1), fgetcmd(1), fgrabcmd(1), flscmd(1), fmkdir(1), +fprocmd(1), fput(1), frmcmd(1), frmdircmd(1), fver(1), fducmd(1), +fhostcmd(1), ffindcmd(1), fspd(1), fsp_prof(5) +.LP +.SH "BUGS" +There seems to be a problem using an alias as command to execute. +But since there is no globbing performed on the pathname +the original FSP commands may be used instead. diff --git a/man/flscmd.1 b/man/flscmd.1 new file mode 100644 index 0000000..064a753 --- /dev/null +++ b/man/flscmd.1 @@ -0,0 +1,66 @@ +.TH FLS 1 "8 December 1991" FSP +.SH NAME +flscmd, fls \- list the contents of a FSP database +.SH SYNOPSIS +.B flscmd +[ +.B unix ls flags +] +.I filename +\&.\|.\|. +.LP +.B fls +[ +.B unix ls flags +] +.I filename +\&.\|.\|. +.SH DESCRIPTION +.LP +.B flscmd +lists the content of the FSP database. All usual +flags and usages for the unix +.B ls +command are accepted. +.LP +.B flscmd +will perform +.B csh +file name globbing based on file and directory information +obtained from the FSP database. +.LP +Since user's command shells generally cannot do the proper globbing for +this program, it is recommended that user defines a shell alias or +function to turn off command shell globbing before running this program. +.B csh +example: +.LP +.nf +alias fls \e(set noglob\e; exec flscmd \e!\e*\e) +.fi +.SH ENVIRONMENT +.LP +See fsp_env(7) for list of used environment variables. +.SH BUGS +.LP +.B flscmd +is based on 4.3 +.B ls +code. It inherits any bugs found in 4.3 +.B ls. +In addition, only four pieces of information for each file and directory +are available through FSP: +.B name, +.B time, +.B size, +and +.B type. +All other information that +.B flscmd +display are for compatibility purposes only +and are forged locally. +.SH "SEE ALSO" +.PD +fcatcmd(1), fcdcmd(1), fgetcmd(1), fgrabcmd(1), flscmd(1), fmkdir(1), +fprocmd(1), fput(1), frmcmd(1), frmdircmd(1), fver(1), fducmd(1), +fhostcmd(1), fspd(1), fsp_prof(5), ffindcmd(1), fsp_env(7) diff --git a/man/fmkdir.1 b/man/fmkdir.1 new file mode 100644 index 0000000..b9ddd40 --- /dev/null +++ b/man/fmkdir.1 @@ -0,0 +1,28 @@ +.TH FMKDIR 1 "8 December 1991" FSP +.SH NAME +fmkdir \- create directories in the FSP database +.SH SYNOPSIS +.B fmkdir +.I name +\&.\|.\|. +.SH DESCRIPTION +.LP +For each +.I name +appearing in the argument list, +.B fmkdir +creates a directory in the client's current working directory +in the FSP database. The new directories are owned by the +client machine, and permission for other machines to create or +delete items in these directories are initially turned off. +The client may alter the permission states with the +.B fprocmd +command. +.SH ENVIRONMENT +.LP +See fsp_env(7) for list of used environment variables. +.SH "SEE ALSO" +.PD +fcatcmd(1), fcdcmd(1), fgetcmd(1), fgrabcmd(1), flscmd(1), fmkdir(1), +fprocmd(1), fput(1), frmcmd(1), frmdircmd(1), fver(1), fducmd(1), +fhostcmd(1), fspd(1), fsp_prof(5), ffindcmd(1), fsp_env(7) diff --git a/man/frmcmd.1 b/man/frmcmd.1 new file mode 100644 index 0000000..37045da --- /dev/null +++ b/man/frmcmd.1 @@ -0,0 +1,38 @@ +.TH FRM 1 "8 December 1991" FSP +.SH NAME +frmcmd, frm \- remove files from the FSP server +.SH SYNOPSIS +.B frmcmd +.I filename +\&.\|.\|. +.LP +.B frm +.I filename +\&.\|.\|. +.SH DESCRIPTION +.LP +.B frmcmd +deletes the named files from the FSP database. +.B frmcmd +will perform +.B csh +file name globbing based on file and directory information +obtained from the FSP database. +.LP +Since user's command shells generally cannot do the proper globbing for +this program, it is recommended that user defines a shell alias or +function to turn off command shell globbing before running this program. +.B csh +example: +.LP +.nf +alias frm \e(set noglob\e; exec frmcmd \e!\e*\e) +.fi +.SH ENVIRONMENT +.LP +See fsp_env(7) for list of used environment variables. +.SH "SEE ALSO" +.PD +fcatcmd(1), fcdcmd(1), fgetcmd(1), fgrabcmd(1), flscmd(1), fmkdir(1), +fprocmd(1), fput(1), frmcmd(1), frmdircmd(1), fver(1), fducmd(1), +fhostcmd(1), fspd(1), fsp_prof(5), ffindcmd(1), fsp_env(7) diff --git a/man/frmdircmd.1 b/man/frmdircmd.1 new file mode 100644 index 0000000..65035a9 --- /dev/null +++ b/man/frmdircmd.1 @@ -0,0 +1,38 @@ +.TH FRMDIR 1 "8 December 1991" FSP +.SH NAME +frmdircmd, frmdir \- remove directories from the FSP database +.SH SYNOPSIS +.B frmdircmd +.I directory +\&.\|.\|. +.LP +.B frmdir +.I directory +\&.\|.\|. +.SH DESCRIPTION +.LP +.B frmdircmd +deletes the named directories from the FSP database. +.B frmdircmd +will perform +.B csh +file name globbing based on file and directory information +obtained from the FSP database. +.LP +Since user's command shells generally cannot do the proper globbing for +this program, it is recommended that user defines a shell alias or +function to turn off command shell globbing before running this program. +.B csh +example: +.LP +.nf +alias frmdir \e(set noglob\e; exec frmdircmd \e!\e*\e) +.fi +.SH ENVIRONMENT +.LP +See fsp_env(7) for list of used environment variables. +.SH "SEE ALSO" +.PD +fcatcmd(1), fcdcmd(1), fgetcmd(1), fgrabcmd(1), flscmd(1), fmkdir(1), +fprocmd(1), fput(1), frmcmd(1), frmdircmd(1), fver(1), fducmd(1), +fhostcmd(1), fspd(1), fsp_prof(5), ffindcmd(1), fsp_env(7) diff --git a/man/fver.1 b/man/fver.1 new file mode 100644 index 0000000..f530816 --- /dev/null +++ b/man/fver.1 @@ -0,0 +1,20 @@ +.TH FVER 1 "8 December 1991" FSP +.SH NAME +fver \- displays the version number string of the FSP database +.SH SYNOPSIS +.B fver +.I [-l] +.SH DESCRIPTION +.LP +Without arguments, +.B fver +displays the version string of the FSP database. +Otherwise, the version string of the client utilities is displayed. +.SH ENVIRONMENT +.LP +See fsp_env(7) for list of used environment variables. +.SH "SEE ALSO" +.PD +fcatcmd(1), fcdcmd(1), fgetcmd(1), fgrabcmd(1), flscmd(1), fmkdir(1), +fprocmd(1), fput(1), frmcmd(1), frmdircmd(1), fver(1), fducmd(1), +fhostcmd(1), fspd(1), fsp_prof(5), ffindcmd(1), fsp_env(7)