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:
Mike Pritchard 1999-06-26 22:53:22 +00:00
parent c64dca10ab
commit cc708d2d5f
Notes: svn2git 2020-12-20 02:59:44 +00:00
svn path=/head/; revision=48258

View file

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