aboutsummaryrefslogtreecommitdiffstats
path: root/man/auto.master.5
blob: 339c8d1d62ec749485f9ae1834aa4d00eae22d60 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
.\" t
.\" $Id$
.TH AUTO.MASTER 5 "19 Jun 2000"
.SH NAME
/etc/auto.master \- Master Map for automounter
.SH "DESCRIPTION"
The
.B auto.master
map is consulted when the
.BR autofs (8)
script is invoked to set up the necessary mount points for the automounter.
Each line in this file describes a mount point and points to another file
describing the file systems to be mounted under this mountpoint. The access
to those maps is governed by a key.
.P
Access to an automounted file system is customarily done using the path scheme:
.P
.RI / mountpoint / key / path / file ,
.P
where the
.I mountpoint
will be listed in the
.B auto.master
configuration file. The
.I key
is matched in the map file pointed to by the
master map (See
.BR autofs (5)).
The path and the file are referring to the file on the file system mounted.
.SH "FORMAT"
The file has three fields separated by an arbitrary number of blanks or
tabs. Lines beginning with # are comments. The first field is the mount
point. Second field is the map file to be consulted for this mount-point.
This field is of the form 
.IR [maptype:]mapname ,
where
.I maptype
is one of the supported map types (file, program, yp, nisplus, hesiod,
userhome, ldap), and
.I mapname
is the name of the map.  If the map type is omitted, it will be
guessed.  The third field is optional and can contain options to be
applied to all entries in the map.  Options are cumulative, which is a
difference from the behavior of the SunOS automounter.
.PP
In addition, the maptype
.I multi
can be used to combine information from several maps.  To use it, specify:
.P
\fBmulti\fP \fImaptype\fP \fImapname\fP [\fIoptions\fP] \fB\-\-\fP 
\fImaptype\fP \fImapname\fP [\fIoptions\fP] ...
.P
For each lookup 

The format of the map file and the options are described in
.BR autofs (5).
.SH EXAMPLE
.sp
.RS +.2i
.ta 1.0i
.nf
/home	/etc/auto.home
/misc	/etc/auto.misc
/nis	yp:nis.map
/multi	multi file /etc/auto.home -- yp nis.map
.fi
.RE
.sp
This will generate four mountpoints 
.IR /home ,
.IR /misc ,
.IR /nis ,
and
.IR /multi .
All accesses to
.I /home
will lead to the consultation of the map in
.IR /etc/auto.home ,
all accesses to
.I /misc
will consult the map in
.IR /etc/auto.misc ,
and all accesses to
.I /nis
will consult the NIS map
.IR nis.map .
Finally, accesses to
.I /multi
will consult
.I both
the file
.I /etc/auto.home
and the NIS map
.IR nis.map .
.SH "SEE ALSO"
.BR automount (8),
.BR autofs (5),
.BR autofs (8).
.SH AUTHOR
This manual page was written by Christoph Lameter <chris@waterf.org>,
for the Debian GNU/Linux system.  Edited by <hpa@transmeta.com>.