aboutsummaryrefslogtreecommitdiff
path: root/usr.sbin/mountd
diff options
context:
space:
mode:
authorMateusz Piotrowski <0mp@FreeBSD.org>2022-08-16 13:03:20 +0000
committerMateusz Piotrowski <0mp@FreeBSD.org>2023-10-04 11:11:13 +0000
commit6d5f98380ecf7544c50a156928219c684ac73205 (patch)
tree3003ae9325030eda454053eb00979850f22a76d5 /usr.sbin/mountd
parentb10a23df1cc231aa8ae2ae345b12823afa658979 (diff)
exports.5: Clean up EXAMPLES and STANDARDS
There was a missing sentence in the description of the second mount entry in the example. Fix that and some other bits in the EXAMPLES section. Also, make the STANDARDS section a bit more readable. MFC after: 1 week Sponsored by: Klara Inc. (cherry picked from commit f9572577cf5f28d8e7592b4f1fb24c54e8e79783)
Diffstat (limited to 'usr.sbin/mountd')
-rw-r--r--usr.sbin/mountd/exports.548
1 files changed, 29 insertions, 19 deletions
diff --git a/usr.sbin/mountd/exports.5 b/usr.sbin/mountd/exports.5
index 714e5e72b884..56facef29a12 100644
--- a/usr.sbin/mountd/exports.5
+++ b/usr.sbin/mountd/exports.5
@@ -27,7 +27,7 @@
.\"
.\" @(#)exports.5 8.3 (Berkeley) 3/29/95
.\"
-.Dd November 9, 2021
+.Dd August 16, 2022
.Dt EXPORTS 5
.Os
.Sh NAME
@@ -411,6 +411,13 @@ file.
the default remote mount-point file
.El
.Sh EXAMPLES
+Given that
+.Pa /usr , /u , /a
+and
+.Pa /u2
+are
+local file system mount points, let's consider the following example:
+.Pp
.Bd -literal -offset indent
/usr /usr/local -maproot=0:10 friends
/usr -maproot=daemon grumpy.cis.uoguelph.ca 131.104.48.16
@@ -427,27 +434,21 @@ V4: / -sec=krb5:krb5i:krb5p -network 131.104.48 -mask 255.255.255.0
V4: / -sec=sys:krb5:krb5i:krb5p grumpy.cis.uoguelph.ca
.Ed
.Pp
-Given that
-.Pa /usr , /u , /a
-and
-.Pa /u2
-are
-local file system mount points, the above example specifies the following:
-.Pp
-The file system rooted at
+The file systems rooted at
.Pa /usr
-is exported to hosts
-.Em friends
-where friends is specified in the netgroup file
+and
+.Pa /usr/local
+are exported to hosts within the
+.Dq friends
+network group
with users mapped to their remote credentials and
root mapped to UID 0 and group 10.
-It is exported read-write and the hosts in
-.Dq friends
-can mount either
+They are exported read-write and the hosts in
+.Dq friends .
+.Pp
+The file system rooted at
.Pa /usr
-or
-.Pa /usr/local .
-It is exported to
+is exported to
.Em 131.104.48.16
and
.Em grumpy.cis.uoguelph.ca
@@ -590,12 +591,21 @@ afterwards, whereas NFSv3 rejects the mount request.
.Xr rpc.tlsservd 8 ,
.Xr showmount 8
.Sh STANDARDS
-The implementation is based on the specification in
+The implementation is based on the following documents:
+.Bl -dash
+.It
.Rs
.%T "Network File System Protocol Specification, Appendix A, RFC 1094"
+.Re
+.It
+.Rs
.%T "NFS: Network File System Version 3, Appendix I, RFC 1813"
+.Re
+.It
+.Rs
.%T "Towards Remote Procedure Call Encryption By Default, RFC nnnn"
.Re
+.El
.Sh BUGS
The export options are tied to the local mount points in the kernel and
must be non-contradictory for any exported subdirectory of the local