summaryrefslogtreecommitdiffstats
path: root/usr.sbin/mountd
diff options
context:
space:
mode:
authordanger <danger@FreeBSD.org>2008-06-30 08:29:02 +0000
committerdanger <danger@FreeBSD.org>2008-06-30 08:29:02 +0000
commit10977336ce5006706e46852a70669062fbd10b64 (patch)
treeb40e82550bc18aae6f56049c6807c2c558109945 /usr.sbin/mountd
parentb64893bda70709f212d6c9fc12cdb6e7e0a647cd (diff)
downloadFreeBSD-src-10977336ce5006706e46852a70669062fbd10b64.zip
FreeBSD-src-10977336ce5006706e46852a70669062fbd10b64.tar.gz
- add some missing words
- we don't have ne(4), replace it with re(4) - fix markup - bump date Submitted by: ru MFC after: 3 days
Diffstat (limited to 'usr.sbin/mountd')
-rw-r--r--usr.sbin/mountd/exports.569
1 files changed, 44 insertions, 25 deletions
diff --git a/usr.sbin/mountd/exports.5 b/usr.sbin/mountd/exports.5
index 1b7c9a2..e04b756 100644
--- a/usr.sbin/mountd/exports.5
+++ b/usr.sbin/mountd/exports.5
@@ -28,7 +28,7 @@
.\" @(#)exports.5 8.3 (Berkeley) 3/29/95
.\" $FreeBSD$
.\"
-.Dd March 29, 1995
+.Dd June 30, 2008
.Dt EXPORTS 5
.Os
.Sh NAME
@@ -83,9 +83,9 @@ option is used on
.Xr mountd 8 .
The pathnames must not have any symbolic links in them and should not have
any
-.Dq .
+.Dq Pa \&.
or
-.Dq ..
+.Dq Pa ..
components.
Mount points for a file system may appear on multiple lines each with
different sets of hosts and export options.
@@ -93,13 +93,13 @@ different sets of hosts and export options.
The second component of a line specifies how the file system is to be
exported to the host set.
The option flags specify whether the file system
-is exported read-only or read-write and how the client uid is mapped to
+is exported read-only or read-write and how the client UID is mapped to
user credentials on the server.
.Pp
Export options are specified as follows:
.Pp
.Sm off
-.Fl maproot No = Sy user
+.Fl maproot No Li = Sy user
.Sm on
The credential of the specified user is used for remote access by root.
The credential includes all the groups to which the user is a member
@@ -108,7 +108,7 @@ on the local machine (see
The user may be specified by name or number.
.Pp
.Sm off
-.Fl maproot No = Sy user:group1:group2:...
+.Fl maproot No Li = Sy user:group1:group2:...
.Sm on
The colon separated list is used to specify the precise credential
to be used for remote access by root.
@@ -117,13 +117,13 @@ Note that user: should be used to distinguish a credential containing
no groups from a complete credential for that user.
.Pp
.Sm off
-.Fl mapall No = Sy user
+.Fl mapall No Li = Sy user
.Sm on
or
.Sm off
-.Fl mapall No = Sy user:group1:group2:...
+.Fl mapall No Li = Sy user:group1:group2:...
.Sm on
-specifies a mapping for all client uids (including root)
+specifies a mapping for all client UIDs (including root)
using the same semantics as
.Fl maproot .
.Pp
@@ -165,7 +165,7 @@ be done with the
.Fl public
flag.
However, this flag in itself allows r/w access to all files in
-the file system, not requiring reserved ports and not remapping uids.
+the file system, not requiring reserved ports and not remapping UIDs.
It
is only provided to conform to the spec, and should normally not be used.
For a
@@ -220,7 +220,9 @@ The first way is to list the host name(s) separated by white space.
addresses may be used in place of names.)
The second way is to specify a
.Dq netgroup
-as defined in the netgroup file (see
+as defined in the
+.Pa netgroup
+file (see
.Xr netgroup 5 ) .
The third way is to specify an Internet subnetwork using a network and
network mask that is defined as the set of all hosts with addresses within
@@ -239,7 +241,7 @@ Using the full domain specification for a hostname can normally
circumvent the problem of a host that has the same name as a netgroup.
The third case is specified by the flag
.Sm off
-.Fl network No = Sy netname Op No / Ar prefixlength
+.Fl network No Li = Sy netname Op No Li / Ar prefixlength
.Sm on
and optionally
.Sm off
@@ -262,8 +264,12 @@ section below.
Scoped IPv6 address must carry scope identifier as documented in
.Xr inet6 4 .
For example,
-.Dq fe80::%ne2/10
-is used to specify fe80::/10 on ne2 interface.
+.Dq Li fe80::%re2/10
+is used to specify
+.Li fe80::/10
+on
+.Li re2
+interface.
.Pp
The
.Xr mountd 8
@@ -303,18 +309,20 @@ the default remote mount-point file
.Pp
Given that
.Pa /usr ,
-.Pa /u
+.Pa /u ,
+.Pa /a
and
.Pa /u2
are
local file system mount points, the above example specifies the following:
.Pp
+The file system rooted at
.Pa /usr
is exported to hosts
.Em friends
where friends is specified in the netgroup file
with users mapped to their remote credentials and
-root mapped to uid 0 and group 10.
+root mapped to UID 0 and group 10.
It is exported read-write and the hosts in
.Dq friends
can mount either
@@ -332,17 +340,19 @@ it is exported to the rest of the world as read-only with
all users mapped to the user and groups associated with
.Dq nobody .
.Pp
+The file system rooted at
.Pa /u
is exported to all hosts on the subnetwork
.Em 131.104.48
-with root mapped to the uid for
+with root mapped to the UID for
.Dq bin
and with no group access.
.Pp
+The file system rooted at
.Pa /u2
is exported to the hosts in
.Dq friends
-with root mapped to uid and groups
+with root mapped to UID and groups
associated with
.Dq root ;
it is exported to all hosts on network
@@ -350,22 +360,31 @@ it is exported to all hosts on network
allowing mounts at any
directory within /u2.
.Pp
+The file system rooted at
.Pa /a
is exported to the network 192.168.0.0, with a netmask of 255.255.255.0.
-However, the netmask length in the entry for /a is not specified through
-a -mask option, but through the /prefix notation.
+However, the netmask length in the entry for
+.Pa /a
+is not specified through a
+.Fl mask
+option, but through the
+.Li / Ns Ar prefix
+notation.
.Pp
+The file system rooted at
.Pa /a
-is also exported to the IPv6 network 3ffe:1ce1:1:fe80:: address, using
-the upper 64 bits as the prefix.
+is also exported to the IPv6 network
+.Li 3ffe:1ce1:1:fe80::
+address, using the upper 64 bits as the prefix.
Note that, unlike with IPv4 network addresses, the specified network
address must be complete, and not just contain the upper bits.
-With IPv6 addresses, the -mask option must not
-be used.
+With IPv6 addresses, the
+.Fl mask
+option must not be used.
.Pp
The file system rooted at
.Pa /cdrom
-will exported read-only to the entire network 192.168.33.0/24, including
+will be exported read-only to the entire network 192.168.33.0/24, including
all its subdirectories.
Since
.Pa /cdrom
OpenPOWER on IntegriCloud