Page Menu
Home
FreeBSD
Search
Configure Global Search
Log In
Files
F102698115
D44614.diff
No One
Temporary
Actions
View File
Edit File
Delete File
View Transforms
Subscribe
Mute Notifications
Flag For Later
Award Token
Size
2 KB
Referenced Files
None
Subscribers
None
D44614.diff
View Options
diff --git a/usr.sbin/mountd/exports.5 b/usr.sbin/mountd/exports.5
--- a/usr.sbin/mountd/exports.5
+++ b/usr.sbin/mountd/exports.5
@@ -25,7 +25,7 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd April 7, 2024
+.Dd April 16, 2024
.Dt EXPORTS 5
.Os
.Sh NAME
@@ -55,8 +55,8 @@
A long line may be split over several lines by ending all but the
last line with a backslash
.Pq Ql \e .
-A host may be specified only once for each local file or the NFSv4 tree root on the
-server and there may be only one default entry for each server
+A host may be specified only once for each local file system or the NFSv4 tree
+root on the server and there may be only one default entry for each server
file system that applies to all other hosts.
The latter exports the file system to the
.Dq world
@@ -66,7 +66,26 @@
In a mount entry,
the first field(s) specify the directory path(s) within a server file system
that can be mounted on by the corresponding client(s).
-There are three forms of this specification.
+Note well that exporting a directory on the server does not guarantee that only
+files below the exported directory will be accessible.
+This is true even in the absence of the
+.Fl alldirs
+flag.
+To provide this guarantee, the exported directories must be local file system
+mount points on the server.
+For example, if one exports
+.Pa /home ,
+and
+.Pa /home
+is not a file system mount point, then clients will be able to access arbitrary
+files on the root file system.
+As such, to avoid confusion with respect to what is exported, it may be prudent
+to limit exported directories to server local file system mount points.
+When exporting ZFS datasets with the
+.Sy sharenfs
+property, this is auomatically the case.
+.Pp
+There are three forms of the directory path specification.
The first is to list all mount points as absolute
directory paths separated by whitespace.
This list of directory paths should be considered an
@@ -597,6 +616,7 @@
.Xr strunvis 3 ,
.Xr nfsv4 4 ,
.Xr netgroup 5 ,
+.Xr zfsprops 7 ,
.Xr mountd 8 ,
.Xr nfsd 8 ,
.Xr rpc.tlsservd 8 ,
File Metadata
Details
Attached
Mime Type
text/plain
Expires
Sun, Nov 17, 12:26 AM (21 h, 46 m)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
14668208
Default Alt Text
D44614.diff (2 KB)
Attached To
Mode
D44614: exports.5: Clarify that exported dirs should be local mount points
Attached
Detach File
Event Timeline
Log In to Comment