git: 4090d103b0c3 - main - mknod.2: update the man page
- Go to: [ bottom of page ] [ top of archives ] [ this month ]
Date: Mon, 27 Jul 2026 16:12:36 UTC
The branch main has been updated by kib:
URL: https://cgit.FreeBSD.org/src/commit/?id=4090d103b0c31b44b269e0ccf758be5cfba3f60c
commit 4090d103b0c31b44b269e0ccf758be5cfba3f60c
Author: Konstantin Belousov <kib@FreeBSD.org>
AuthorDate: 2026-07-27 14:14:51 +0000
Commit: Konstantin Belousov <kib@FreeBSD.org>
CommitDate: 2026-07-27 16:12:13 +0000
mknod.2: update the man page
State that FIFOs can be created, document the requirement that
dev must be zero then. Mention whiteouts.
PR: 297082
Reviewed by: emaste
Sponsored by: The FreeBSD Foundation
MFC after: 3 days
Differential revision: https://reviews.freebsd.org/D58478
---
lib/libsys/mknod.2 | 23 ++++++++++++++++-------
1 file changed, 16 insertions(+), 7 deletions(-)
diff --git a/lib/libsys/mknod.2 b/lib/libsys/mknod.2
index f4327262b46b..7dd4985e9cb9 100644
--- a/lib/libsys/mknod.2
+++ b/lib/libsys/mknod.2
@@ -53,13 +53,20 @@ indicates a block or character special file,
.Fa dev
is a configuration dependent specification denoting a particular device
on the system.
-Otherwise,
+Otherwise, if
+.Fa mode
+indicates the request to create a FIFO
+.Pq see Xr mkfifo 2
+the
+.Fa dev
+argument must be zero.
+For creating whiteouts, the
.Fa dev
-is ignored.
+argument is ignored.
.Pp
The
.Fn mknod
-system call
+system call, when called to create special files,
requires super-user privileges.
.Pp
The
@@ -132,10 +139,12 @@ The
argument
points outside the process's allocated address space.
.It Bq Er EINVAL
-Creating anything else than a block or character special
-file (or a
-.Em whiteout )
-is not supported.
+Creating anything other than a block or character special
+file, whiteout, or FIFO, is not supported.
+.It Bq Er EINVAL
+Non-zero
+.Fa dev
+specified when creating FIFO.
.El
.Pp
In addition to the errors returned by the