Commit | Line | Data |
---|---|---|
eadcc84a | 1 | .\" Copyright (c) 1989, 1991 The Regents of the University of California. |
b64bd2a1 KM |
2 | .\" All rights reserved. |
3 | .\" | |
eadcc84a | 4 | .\" %sccs.include.redist.roff% |
b64bd2a1 | 5 | .\" |
eadcc84a | 6 | .\" @(#)exports.5 5.2 (Berkeley) %G% |
b64bd2a1 | 7 | .\" |
eadcc84a CL |
8 | .Dd |
9 | .Dt EXPORTS 5 | |
10 | .Os | |
11 | .Sh NAME | |
12 | .Nm exports | |
13 | .Nd define remote mount points for | |
14 | .Tn NFS | |
15 | mount requests | |
16 | .Sh SYNOPSIS | |
17 | .Nm exports | |
18 | .Sh DESCRIPTION | |
19 | The | |
20 | .Nm exports | |
21 | file | |
b64bd2a1 | 22 | specifies remote mount points for the |
eadcc84a | 23 | .Tn NFS |
b64bd2a1 | 24 | mount protocol per the |
eadcc84a | 25 | .Tn NFS |
b64bd2a1 | 26 | server specification; see |
eadcc84a CL |
27 | .%T "Network File System Protocol Specification \\*(tNRFC\\*(sP 1094" . |
28 | .Pp | |
b64bd2a1 KM |
29 | Each line in the file specifies one remote mount point. |
30 | The first field is the mount point directory path followed | |
31 | optionally by export options and specific hosts separated by white space. | |
32 | Only the first entry for a given local file system may specify the export | |
eadcc84a CL |
33 | options, since these are handled on a |
34 | .Em per local file system | |
35 | basis. | |
b64bd2a1 KM |
36 | If no specific hosts are specified, |
37 | the mount point is exported to all hosts. | |
eadcc84a | 38 | .Pp |
b64bd2a1 | 39 | The export options are as follows: |
eadcc84a CL |
40 | .Sm off |
41 | .Fl root No = Aq Sy uid | |
42 | .Sm on | |
b64bd2a1 | 43 | specifies how to map root's uid (default -2). |
eadcc84a CL |
44 | The option |
45 | .Fl r | |
46 | is synonyms for | |
47 | .Fl root | |
b64bd2a1 | 48 | in an effort to be backward compatible with older export file formats. |
eadcc84a CL |
49 | .Pp |
50 | .Fl ro | |
b64bd2a1 KM |
51 | specifies that the file system should be exported Read-only |
52 | (default Read/Write). | |
eadcc84a CL |
53 | The option |
54 | .Fl o | |
55 | is synonyms for | |
56 | .Fl ro | |
b64bd2a1 | 57 | in an effort to be backward compatible with older export file formats. |
eadcc84a | 58 | .Pp |
b64bd2a1 | 59 | For example: |
eadcc84a | 60 | .Bd -literal -offset indent |
b64bd2a1 | 61 | /usr -root=0 rickers snowhite.cis.uoguelph.ca |
b64bd2a1 | 62 | /usr/local 131.104.48.16 |
b64bd2a1 | 63 | /u -root=5 |
b64bd2a1 | 64 | /u2 -ro |
eadcc84a CL |
65 | .Ed |
66 | .Pp | |
67 | Given that | |
68 | .Sy /usr , | |
69 | .Sy /u | |
70 | and | |
71 | .Sy /u2 | |
72 | are | |
73 | local file system mount points, the above example specifies the following: | |
74 | .Bd -filled -offset indent | |
75 | .Sy /usr | |
76 | is exported to hosts | |
77 | .Em rickers | |
78 | and | |
79 | .Em snowhite.cis.uoguelph.ca | |
80 | with | |
b64bd2a1 | 81 | root mapped to root. |
eadcc84a CL |
82 | .Pp |
83 | .Sy /usr/local | |
84 | is exported to host | |
85 | .Em 131.104.48.16 | |
86 | with root mapped to root. | |
87 | .Pp | |
88 | .Sy /u | |
b64bd2a1 | 89 | is exported to all hosts with root mapped to uid 5. |
eadcc84a CL |
90 | .Pp |
91 | .Sy /u2 | |
b64bd2a1 | 92 | is exported to all hosts Read-only with root mapped to -2. |
eadcc84a CL |
93 | .Ed |
94 | .Pp | |
95 | Note that | |
96 | .Dq Li "/usr/local -root=5" | |
97 | would have been incorrect, | |
98 | since | |
99 | .Sy /usr | |
100 | and | |
101 | .Sy /usr/local | |
102 | reside in the same local file system. | |
103 | .Sh FILES | |
104 | .Bl -tag -width /etc/exports -compact | |
105 | .It Pa /etc/exports | |
106 | The remote mount point file | |
107 | .Nm exports | |
108 | resides in | |
109 | .Pa /etc . | |
110 | .El | |
111 | .Sh SEE ALSO | |
112 | .Xr mountd 8 , | |
113 | .Xr nfsd 8 , | |
114 | .Xr showmount 8 | |
115 | .Sh BUGS | |
b64bd2a1 | 116 | It would be nice if the export options were not tied to local mount points. |
eadcc84a CL |
117 | .Sh HISTORY |
118 | The | |
119 | .Nm | |
120 | file format is | |
121 | .Ud . |