1.\"
2.\" Copyright (c) 1997-1999 Erez Zadok
3.\" Copyright (c) 1993 Jan-Simon Pendry.
4.\" Copyright (c) 1993
5.\" The Regents of the University of California. All rights reserved.
6.\"
7.\" Redistribution and use in source and binary forms, with or without
8.\" modification, are permitted provided that the following conditions
9.\" are met:
10.\" 1. Redistributions of source code must retain the above copyright
11.\" notice, this list of conditions and the following disclaimer.
12.\" 2. Redistributions in binary form must reproduce the above copyright
13.\" notice, this list of conditions and the following disclaimer in the
14.\" documentation and/or other materials provided with the distribution.
15.\" 3. All advertising materials mentioning features or use of this software
16.\" must display the following acknowledgment:
17.\" This product includes software developed by the University of
18.\" California, Berkeley and its contributors.
19.\" 4. Neither the name of the University nor the names of its contributors
20.\" may be used to endorse or promote products derived from this software
21.\" without specific prior written permission.
22.\"
23.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
24.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
25.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
26.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
27.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
28.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
29.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
30.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
31.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
32.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
33.\" SUCH DAMAGE.
34.\"
35.\" from: @(#)fsinfo.8 8.1 (Berkeley) 6/28/93
36.\" $Id: fsinfo.8,v 1.2 1999/01/10 21:54:28 ezk Exp $
| 1.\"
2.\" Copyright (c) 1997-1999 Erez Zadok
3.\" Copyright (c) 1993 Jan-Simon Pendry.
4.\" Copyright (c) 1993
5.\" The Regents of the University of California. All rights reserved.
6.\"
7.\" Redistribution and use in source and binary forms, with or without
8.\" modification, are permitted provided that the following conditions
9.\" are met:
10.\" 1. Redistributions of source code must retain the above copyright
11.\" notice, this list of conditions and the following disclaimer.
12.\" 2. Redistributions in binary form must reproduce the above copyright
13.\" notice, this list of conditions and the following disclaimer in the
14.\" documentation and/or other materials provided with the distribution.
15.\" 3. All advertising materials mentioning features or use of this software
16.\" must display the following acknowledgment:
17.\" This product includes software developed by the University of
18.\" California, Berkeley and its contributors.
19.\" 4. Neither the name of the University nor the names of its contributors
20.\" may be used to endorse or promote products derived from this software
21.\" without specific prior written permission.
22.\"
23.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
24.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
25.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
26.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
27.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
28.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
29.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
30.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
31.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
32.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
33.\" SUCH DAMAGE.
34.\"
35.\" from: @(#)fsinfo.8 8.1 (Berkeley) 6/28/93
36.\" $Id: fsinfo.8,v 1.2 1999/01/10 21:54:28 ezk Exp $
|
37.\" $FreeBSD: head/contrib/amd/fsinfo/fsinfo.8 71899 2001-02-01 17:12:45Z ru $
| 37.\" $FreeBSD: head/contrib/amd/fsinfo/fsinfo.8 107788 2002-12-12 17:26:04Z ru $
|
38.\"
39.Dd June 26, 1999
40.Dt FSINFO 8
41.Os
42.Sh NAME
43.Nm fsinfo
| 38.\"
39.Dd June 26, 1999
40.Dt FSINFO 8
41.Os
42.Sh NAME
43.Nm fsinfo
|
44.Nd co-ordinate site-wide filesystem information
| 44.Nd co-ordinate site-wide file system information
|
45.Sh SYNOPSIS
46.Nm
47.Op Fl qv
48.Op Fl a Ar autodir
49.Op Fl b Ar bootparams_prefix
50.Op Fl d Ar dumpsets_prefix
51.Op Fl e Ar exports_prefix
52.Op Fl f Ar fstabs_prefix
53.Op Fl h Ar hostname
54.Op Fl m Ar automounts_prefix
55.Op Fl I Ar dir
56.Oo
57.Fl D
58.Ar name Ns Op = Ns Ar string
59.Oc
60.Op Fl U Ar name
61.Ar config ...
62.Sh DESCRIPTION
63The
64.Nm
65utility takes a set of system configuration information, and generates
66a co-ordinated set of
67.Xr amd ,
68.Xr mount
69and
70.Xr mountd
71configuration files.
72.Pp
73The following options are available:
74.Bl -tag -width Fl
75.It Fl a Ar autodir
76Specifies the directory name in which to place the automounter's
77mount points. This defaults to
78.Pa /a .
79.It Fl b Ar bootparams_prefix
80Specifies the prefix for the
81.Pa bootparams
82file. If it is not given, then the file will not be generated.
83The file will be constructed for the destination machine and will be
84placed into a file named
85.Pa bootparams
86and prefixed by the
87.Ar bootparams_prefix
88string.
89The file generated contains a list of entries describing each
90diskless client that can boot from the destination machine.
91.It Fl d Ar dumpsets_prefix
92Specifies the prefix for the
93.Pa dumpsets
94file. If it is not specified, then the file will not be generated.
95The file will be for the destination machine and will be placed into a file
96named
97.Pa dumpsets
98prefixed by the
99.Ar dumpsets_prefix
100string.
101This file is for use by
102.Tn Imperial College's
103local backup system.
104.It Fl e Ar exports_prefix
105Defines the prefix for the
106.Pa exports
107files. If it is not given, then the file will not be generated.
108For each machine defined in the configuration files as having disks,
109and
110.Pa exports
111file is constructed and given a file name determined by the name of the
112machine, prefixed with the
113.Ar exports_prefix
114string.
115If a machine is defined as diskless, then no
116file will be created for it. The files contain entries
117for directories on the machine that may be exported to clients.
118.It Fl f Ar fstabs_prefix
119This defines the prefix for the
120.Pa fstab
121files. The files will only be created if this prefix is defined.
122For each machine defined in the configuration files, a
123.Pa fstab
124file is created with the file name determined by prefixing this
125.Ar fstabs_prefix
126string with the name of the machine. These files contain entries
| 45.Sh SYNOPSIS
46.Nm
47.Op Fl qv
48.Op Fl a Ar autodir
49.Op Fl b Ar bootparams_prefix
50.Op Fl d Ar dumpsets_prefix
51.Op Fl e Ar exports_prefix
52.Op Fl f Ar fstabs_prefix
53.Op Fl h Ar hostname
54.Op Fl m Ar automounts_prefix
55.Op Fl I Ar dir
56.Oo
57.Fl D
58.Ar name Ns Op = Ns Ar string
59.Oc
60.Op Fl U Ar name
61.Ar config ...
62.Sh DESCRIPTION
63The
64.Nm
65utility takes a set of system configuration information, and generates
66a co-ordinated set of
67.Xr amd ,
68.Xr mount
69and
70.Xr mountd
71configuration files.
72.Pp
73The following options are available:
74.Bl -tag -width Fl
75.It Fl a Ar autodir
76Specifies the directory name in which to place the automounter's
77mount points. This defaults to
78.Pa /a .
79.It Fl b Ar bootparams_prefix
80Specifies the prefix for the
81.Pa bootparams
82file. If it is not given, then the file will not be generated.
83The file will be constructed for the destination machine and will be
84placed into a file named
85.Pa bootparams
86and prefixed by the
87.Ar bootparams_prefix
88string.
89The file generated contains a list of entries describing each
90diskless client that can boot from the destination machine.
91.It Fl d Ar dumpsets_prefix
92Specifies the prefix for the
93.Pa dumpsets
94file. If it is not specified, then the file will not be generated.
95The file will be for the destination machine and will be placed into a file
96named
97.Pa dumpsets
98prefixed by the
99.Ar dumpsets_prefix
100string.
101This file is for use by
102.Tn Imperial College's
103local backup system.
104.It Fl e Ar exports_prefix
105Defines the prefix for the
106.Pa exports
107files. If it is not given, then the file will not be generated.
108For each machine defined in the configuration files as having disks,
109and
110.Pa exports
111file is constructed and given a file name determined by the name of the
112machine, prefixed with the
113.Ar exports_prefix
114string.
115If a machine is defined as diskless, then no
116file will be created for it. The files contain entries
117for directories on the machine that may be exported to clients.
118.It Fl f Ar fstabs_prefix
119This defines the prefix for the
120.Pa fstab
121files. The files will only be created if this prefix is defined.
122For each machine defined in the configuration files, a
123.Pa fstab
124file is created with the file name determined by prefixing this
125.Ar fstabs_prefix
126string with the name of the machine. These files contain entries
|
127for filesystems and partitions to mount at boot time.
| 127for file systems and partitions to mount at boot time.
|
128.It Fl h Ar hostname
129Defines the hostname of the destination machine to process for.
130If this is not specified, it defaults to the local machine name,
131as returned by
132.Xr gethostname 3 .
133.It Fl m Ar automounts_prefix
134Defines the prefix for the automounter files. The maps will
135only be produced if this option is specified. The mount maps
136suitable for the network defined by the configuration files will
137be placed into files with names calculated by prefixing the
138.Ar automounts_prefix
139string to the name of each map.
140.It Fl q
141Selects quite mode. Only error messages that are generated will
142be displayed.
143.It Fl v
144Selects verbose mode. When this is activated, more messages
145will be displayed, and all information discovered when performing the semantic
146analysis phase will be displayed. Each verbose message
147is output to the standard output on a line starting with a `#'
148character.
149.It Fl D Xo
150.Ar name Ns Op = Ns Ar string
151.Xc
152Defines a symbol
153.Ar name
154for the preprocessor when reading the configuration files.
155Equivalent to the
156.Em #define
157directive.
158.It Fl I Ar dir
159This option is passed into the preprocessor for the configuration
160files. It specifies directories in which to find include files.
161.It Fl U Ar name
162Removes and initial definition of the symbol
163.Ar name .
164Inverse of the
165.Fl D
166option.
167.It Ar config
168One or more configuration files to be passed as input to
169.Nm fsinfo .
170.El
171.Pp
172The
173.Nm
174command is fully described in the document
175.%T "Amd - The 4.4BSD Automounter"
176and in the
177.Nm amd
178section in
179.Xr info 1 .
180.Sh "SEE ALSO"
181.Xr amd 8 ,
182.Xr mount 8 ,
183.Xr mountd 8
184.Sh HISTORY
185The
186.Nm
187command first appeared in
188.Bx 4.4 .
| 128.It Fl h Ar hostname
129Defines the hostname of the destination machine to process for.
130If this is not specified, it defaults to the local machine name,
131as returned by
132.Xr gethostname 3 .
133.It Fl m Ar automounts_prefix
134Defines the prefix for the automounter files. The maps will
135only be produced if this option is specified. The mount maps
136suitable for the network defined by the configuration files will
137be placed into files with names calculated by prefixing the
138.Ar automounts_prefix
139string to the name of each map.
140.It Fl q
141Selects quite mode. Only error messages that are generated will
142be displayed.
143.It Fl v
144Selects verbose mode. When this is activated, more messages
145will be displayed, and all information discovered when performing the semantic
146analysis phase will be displayed. Each verbose message
147is output to the standard output on a line starting with a `#'
148character.
149.It Fl D Xo
150.Ar name Ns Op = Ns Ar string
151.Xc
152Defines a symbol
153.Ar name
154for the preprocessor when reading the configuration files.
155Equivalent to the
156.Em #define
157directive.
158.It Fl I Ar dir
159This option is passed into the preprocessor for the configuration
160files. It specifies directories in which to find include files.
161.It Fl U Ar name
162Removes and initial definition of the symbol
163.Ar name .
164Inverse of the
165.Fl D
166option.
167.It Ar config
168One or more configuration files to be passed as input to
169.Nm fsinfo .
170.El
171.Pp
172The
173.Nm
174command is fully described in the document
175.%T "Amd - The 4.4BSD Automounter"
176and in the
177.Nm amd
178section in
179.Xr info 1 .
180.Sh "SEE ALSO"
181.Xr amd 8 ,
182.Xr mount 8 ,
183.Xr mountd 8
184.Sh HISTORY
185The
186.Nm
187command first appeared in
188.Bx 4.4 .
|