summaryrefslogtreecommitdiffstats
path: root/contrib/amd
diff options
context:
space:
mode:
authormpp <mpp@FreeBSD.org>1999-06-26 22:53:22 +0000
committermpp <mpp@FreeBSD.org>1999-06-26 22:53:22 +0000
commitdfe59f905801e0a55d75a6b477127999d44d42bc (patch)
treef1e880e09a5489f8ff727c76df8ae1cd0c06144c /contrib/amd
parentf5495f36789bcf7f45415006aed5f3e150c1f492 (diff)
downloadFreeBSD-src-dfe59f905801e0a55d75a6b477127999d44d42bc.zip
FreeBSD-src-dfe59f905801e0a55d75a6b477127999d44d42bc.tar.gz
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.
Diffstat (limited to 'contrib/amd')
-rw-r--r--contrib/amd/fsinfo/fsinfo.8132
1 files changed, 116 insertions, 16 deletions
diff --git a/contrib/amd/fsinfo/fsinfo.8 b/contrib/amd/fsinfo/fsinfo.8
index cbaad0d..c0a2a60 100644
--- a/contrib/amd/fsinfo/fsinfo.8
+++ b/contrib/amd/fsinfo/fsinfo.8
@@ -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 .
OpenPOWER on IntegriCloud