aboutsummaryrefslogtreecommitdiff
path: root/lib/libsys/mount.2
diff options
context:
space:
mode:
authorGleb Popov <arrowd@FreeBSD.org>2026-09-23 15:35:42 +0000
committerGleb Popov <arrowd@FreeBSD.org>2026-10-10 14:42:08 +0000
commitc3ac06161dd5b1ac61bcf097060d1e7ae5f0cd57 (patch)
tree876cd1df531600a6ec1a731ad4049a3e57d826f6 /lib/libsys/mount.2
parent21f2245de21931cf388120d8cb464442aaa84c6f (diff)
nmount: Introduce the "check_fsid" option
See the manpage addition for rationale Reviewed by: ziaee, kib Approved by: ziaee, kib Differential Revision: https://reviews.freebsd.org/D59930
Diffstat (limited to 'lib/libsys/mount.2')
-rw-r--r--lib/libsys/mount.234
1 files changed, 29 insertions, 5 deletions
diff --git a/lib/libsys/mount.2 b/lib/libsys/mount.2
index 62e82c0b8184..e9d420fac201 100644
--- a/lib/libsys/mount.2
+++ b/lib/libsys/mount.2
@@ -83,13 +83,33 @@ containing
.Fa niov
elements.
The following options are required by all file systems:
-.Bl -column fstype -offset indent
-.It
-.Li fstype Ta file system type name (e.g., Dq Li procfs )
-.It
-.Li fspath Ta mount point pathname (e.g., Dq Li /proc )
+.Bl -tag -width "check_fsid" -offset indent
+.It Li fstype
+file system type name
+.Pq e.g., Dq Li procfs
+.It Li fspath
+mount point pathname
+.Pq e.g., Dq Li /proc
.El
.Pp
+The following options may be specified when mounting any file system:
+.Bl -tag -width "check_fsid" -offset indent
+.It Li check_fsid
+FSID of a mount point being covered by the mount in the
+.Dq Li FSID:%d:%d
+format
+.El
+.Pp
+If the
+.Dq Li check_fsid
+option is specified, and the FSID of the mount point the covered vnode belongs
+to does not match the passed value, the
+.Fn nmount
+call will fail.
+.Dq Li check_fsid
+may also be passed when doing a mount update, in which case the caller should
+pass a FSID of the FS being updated, not the one covered.
+.Pp
Depending on the file system type, other options may be
recognized or required;
for example, most disk-based file systems require a
@@ -278,6 +298,10 @@ An I/O error occurred while reading data from
The backing store for
.Fa special
detected corrupted data while reading.
+.It Bq Er ENOENT
+The file system ID specified using
+.Fa check_fsid
+did not match the target path.
.El
.Pp
The following errors can occur for a