.\" .\" Copyright (c) 1997-2006 Erez Zadok .\" Copyright (c) 1993 Jan-Simon Pendry. .\" Copyright (c) 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. All advertising materials mentioning features or use of this software .\" must display the following acknowledgment: .\" This product includes software developed by the University of .\" California, Berkeley and its contributors. .\" 4. Neither the name of the University nor the names of its contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" from: @(#)fsinfo.8 8.1 (Berkeley) 6/28/93 .\" $Id: fsinfo.8,v 1.13.2.1 2006/01/02 18:48:25 ezk Exp $ .\" $FreeBSD$ .\" .Dd January 2, 2006 .Dt FSINFO 8 .Os .Sh NAME .Nm fsinfo .Nd co-ordinate site-wide file system information .Sh SYNOPSIS .Nm .Op Fl qv .Op Fl a Ar autodir .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_prefix .Op Fl I Ar dir .Oo .Fl D .Ar name Ns Op = Ns Ar string .Oc .Op Fl U Ar name .Ar config ... .Sh DESCRIPTION The .Nm utility takes a set of system configuration information, and generates a coordinated set of .Xr amd 8 , .Xr mount 8 and .Xr mountd 8 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 file systems 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 Xo .Ar name Ns Op = Ns Ar string .Xc 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 . .El .Pp The .Nm command is fully described in the document .%T "Amd - The 4.4BSD Automounter" . .Sh SEE ALSO .Xr amd 8 , .Xr mount 8 , .Xr mountd 8 .Pp .Dq am-utils .Xr info 1 entry. .Rs .%A Erez Zadok .%B "Linux NFS and Automounter Administration" .%O ISBN 0-7821-2739-8 .%I Sybex .%D 2001 .Re .Pp .Pa http://www.am-utils.org/ .Rs .%T Amd \- The 4.4 BSD Automounter .Re .Sh HISTORY The .Nm command first appeared in .Bx 4.4 . .Sh AUTHORS .An Jan-Simon Pendry Aq jsp@doc.ic.ac.uk , Department of Computing, Imperial College, London, UK. .Pp .An Erez Zadok Aq ezk@cs.sunysb.edu , Computer Science Department, Stony Brook University, Stony Brook, New York, USA. .Pp Other authors and contributors to am-utils are listed in the .Pa AUTHORS file distributed with am-utils.