Actually describe all of the command line options in fsinfo(8).
Most of the text was take from the fsinfo section in info(1). Also included a pointer to that information, since there is so much detail about the format of the configuration files there.
This commit is contained in:
mpp
parent
f5495f3678
commit
dfe59f9058
@ -33,49 +33,149 @@
|
||||
.\" SUCH DAMAGE.
|
||||
.\"
|
||||
.\" from: @(#)fsinfo.8 8.1 (Berkeley) 6/28/93
|
||||
.\" $Id: fsinfo.8,v 1.1.1.1 1998/08/23 22:07:20 obrien Exp $
|
||||
.\" $Id: fsinfo.8,v 1.2 1998/09/12 04:04:58 obrien Exp $
|
||||
.\"
|
||||
.Dd June 28, 1993
|
||||
.Dd June 26, 1999
|
||||
.Dt FSINFO 8
|
||||
.Os
|
||||
.Sh NAME
|
||||
.Nm fsinfo
|
||||
.Nd co-ordinate site-wide filesystem information
|
||||
.Sh SYNOPSIS
|
||||
.Nm \&fsinfo
|
||||
.Op Fl v
|
||||
.Nm
|
||||
.Op Fl qv
|
||||
.Op Fl a Ar autodir
|
||||
.Op Fl b Ar bootparams
|
||||
.Op Fl d Ar dumpsets
|
||||
.Op Fl e Ar exports
|
||||
.Op Fl f Ar fstabs
|
||||
.Op Fl b Ar bootparams_prefix
|
||||
.Op Fl d Ar dumpsets_prefix
|
||||
.Op Fl e Ar exports_prefix
|
||||
.Op Fl f Ar fstabs_prefix
|
||||
.Op Fl h Ar hostname
|
||||
.Op Fl m Ar automounts
|
||||
.Op Fl m Ar automounts_prefix
|
||||
.Op Fl I Ar dir
|
||||
.Op Fl D Ar string[=string]]
|
||||
.Op Fl U Ar string[=string]]
|
||||
.Ar config
|
||||
\&...
|
||||
.Op Fl D Ar name[=string]]
|
||||
.Op Fl U Ar name
|
||||
.Ar config ...
|
||||
.Sh DESCRIPTION
|
||||
The
|
||||
.Nm
|
||||
utility takes a set of system configuration information, and generates
|
||||
a co-ordinated set of
|
||||
.Xr amd ,
|
||||
.Xr mount ,
|
||||
.Xr mount
|
||||
and
|
||||
.Xr mountd
|
||||
configuration files.
|
||||
.Pp
|
||||
The following options are available:
|
||||
.Bl -tag -width Fl
|
||||
.It Fl a Ar autodir
|
||||
Specifies the directory name in which to place the automounter's
|
||||
mount points. This defaults to
|
||||
.Pa /a .
|
||||
.It Fl b Ar bootparams_prefix
|
||||
Specifies the prefix for the
|
||||
.Pa bootparams
|
||||
file. If it is not given, then the file will not be generated.
|
||||
The file will be constructed for the destination machine and will be
|
||||
placed into a file named
|
||||
.Pa bootparams
|
||||
and prefixed by the
|
||||
.Ar bootparams_prefix
|
||||
string.
|
||||
The file generated contains a list of entries describing each
|
||||
diskless client that can boot from the destination machine.
|
||||
.It Fl d Ar dumpsets_prefix
|
||||
Specifies the prefix for the
|
||||
.Pa dumpsets
|
||||
file. If it is not specified, then the file will not be generated.
|
||||
The file will be for the destination machine and will be placed into a file
|
||||
named
|
||||
.Pa dumpsets
|
||||
prefixed by the
|
||||
.Ar dumpsets_prefix
|
||||
string.
|
||||
This file is for use by
|
||||
.Tn Imperial College's
|
||||
local backup system.
|
||||
.It Fl e Ar exports_prefix
|
||||
Defines the prefix for the
|
||||
.Pa exports
|
||||
files. If it is not given, then the file will not be generated.
|
||||
For each machine defined in the configuration files as having disks,
|
||||
and
|
||||
.Pa exports
|
||||
file is constructed and given a file name determined by the name of the
|
||||
machine, prefixed with the
|
||||
.Ar exports_prefix
|
||||
string.
|
||||
If a machine is defined as diskless, then no
|
||||
file will be created for it. The files contain entries
|
||||
for directories on the machine that may be exported to clients.
|
||||
.It Fl f Ar fstabs_prefix
|
||||
This defines the prefix for the
|
||||
.Pa fstab
|
||||
files. The files will only be created if this prefix is defined.
|
||||
For each machine defined in the configuration files, a
|
||||
.Pa fstab
|
||||
file is created with the file name determined by prefixing this
|
||||
.Ar fstabs_prefix
|
||||
string with the name of the machine. These files contain entries
|
||||
for filesystems and partitions to mount at boot time.
|
||||
.It Fl h Ar hostname
|
||||
Defines the hostname of the destination machine to process for.
|
||||
If this is not specified, it defaults to the local machine name,
|
||||
as returned by
|
||||
.Xr gethostname 3 .
|
||||
.It Fl m Ar automounts_prefix
|
||||
Defines the prefix for the automounter files. The maps will
|
||||
only be produced if this option is specified. The mount maps
|
||||
suitable for the network defined by the configuration files will
|
||||
be placed into files with names calculated by prefixing the
|
||||
.Ar automounts_prefix
|
||||
string to the name of each map.
|
||||
.It Fl q
|
||||
Selects quite mode. Only error messages that are generated will
|
||||
be displayed.
|
||||
.It Fl v
|
||||
Selects verbose mode. When this is activated, more messages
|
||||
will be displayed, and all information discovered when performing the semantic
|
||||
analysis phase will be displayed. Each verbose message
|
||||
is output to the standard output on a line starting with a `#'
|
||||
character.
|
||||
.It Fl D Ar name[=string]
|
||||
Defines a symbol
|
||||
.Ar name
|
||||
for the preprocessor when reading the configuration files.
|
||||
Equivalent to the
|
||||
.Em #define
|
||||
directive.
|
||||
.It Fl I Ar dir
|
||||
This option is passed into the preprocessor for the configuration
|
||||
files. It specifies directories in which to find include files.
|
||||
.It Fl U Ar name
|
||||
Removes and initial definition of the symbol
|
||||
.Ar name .
|
||||
Inverse of the
|
||||
.Fl D
|
||||
option.
|
||||
.It Ar config
|
||||
One or more configuration files to be passed as input to
|
||||
.Nm fsinfo .
|
||||
.Pp
|
||||
The
|
||||
.Nm
|
||||
command is fully described in the document
|
||||
.%T "Amd - The 4.4BSD Automounter"
|
||||
and in the
|
||||
.Nm amd
|
||||
section in
|
||||
.Xr info 1 .
|
||||
.Sh "SEE ALSO"
|
||||
.Xr amd 8 ,
|
||||
.Xr mount 8 ,
|
||||
.Xr mountd 8 .
|
||||
.Xr mountd 8
|
||||
.Sh HISTORY
|
||||
The
|
||||
.Nm
|
||||
command first appeared in 4.4BSD.
|
||||
command first appeared in
|
||||
.Bx 4.4 .
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user