Skip site navigation (1)Skip section navigation (2) 
Date:      Mon, 27 Jul 2026 16:12:36 +0000
From:      Konstantin Belousov <kib@FreeBSD.org>
To:        src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org
Subject:   git: 4090d103b0c3 - main - mknod.2: update the man page
Message-ID:  <6a678374.1dc9d.66a594c2@gitrepo.freebsd.org>
index | next in thread | raw e-mail 

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
home | help

Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?6a678374.1dc9d.66a594c2>