Initial revision

This commit is contained in:
hsn 2003-07-16 18:28:53 +00:00
parent 5887b37b8d
commit f0b2caeae0
9 changed files with 633 additions and 0 deletions

50
man/fcatcmd.1 Normal file
View File

@ -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)

64
man/fcdcmd.1 Normal file
View File

@ -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.

82
man/fducmd.1 Normal file
View File

@ -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)

247
man/ffindcmd.1 Normal file
View File

@ -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.

66
man/flscmd.1 Normal file
View File

@ -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)

28
man/fmkdir.1 Normal file
View File

@ -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)

38
man/frmcmd.1 Normal file
View File

@ -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)

38
man/frmdircmd.1 Normal file
View File

@ -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)

20
man/fver.1 Normal file
View File

@ -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)