diff options
| author | Gleb Popov <arrowd@FreeBSD.org> | 2026-09-23 15:35:42 +0000 |
|---|---|---|
| committer | Gleb Popov <arrowd@FreeBSD.org> | 2026-10-10 14:42:08 +0000 |
| commit | c3ac06161dd5b1ac61bcf097060d1e7ae5f0cd57 (patch) | |
| tree | 876cd1df531600a6ec1a731ad4049a3e57d826f6 /lib/libsys/mount.2 | |
| parent | 21f2245de21931cf388120d8cb464442aaa84c6f (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.2 | 34 |
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 |
