git: c56c2f0fe29c - stable/13 - getfh: clarify that it is a privileged operation

From: Ed Maste <emaste_at_FreeBSD.org>
Date: Thu, 30 Dec 2021 00:31:06 UTC
The branch stable/13 has been updated by emaste:

URL: https://cgit.FreeBSD.org/src/commit/?id=c56c2f0fe29c91f40a3eab56c92edd9ebc211df5

commit c56c2f0fe29c91f40a3eab56c92edd9ebc211df5
Author:     Ed Maste <emaste@FreeBSD.org>
AuthorDate: 2021-12-23 15:24:27 +0000
Commit:     Ed Maste <emaste@FreeBSD.org>
CommitDate: 2021-12-30 00:27:34 +0000

    getfh: clarify that it is a privileged operation
    
    Reviewed by:    kib
    MFC after:      1 week
    Sponsored by:   The FreeBSD Foundation
    Differential Revision:  https://reviews.freebsd.org/D33629
    
    (cherry picked from commit 5bc2e6e22774f4663c971a4b5b7eaf4cb9a2485e)
---
 lib/libc/sys/getfh.2 | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/lib/libc/sys/getfh.2 b/lib/libc/sys/getfh.2
index cd3d54f54d7f..e042839a00c4 100644
--- a/lib/libc/sys/getfh.2
+++ b/lib/libc/sys/getfh.2
@@ -29,7 +29,7 @@
 .\"	@(#)getfh.2	8.1 (Berkeley) 6/9/93
 .\" $FreeBSD$
 .\"
-.Dd February 23, 2021
+.Dd December 23, 2021
 .Dt GETFH 2
 .Os
 .Sh NAME
@@ -130,6 +130,7 @@ is called with an absolute
 it ignores the
 .Fa fd
 argument.
+.Pp
 These system calls are restricted to the superuser.
 .Sh RETURN VALUES
 .Rv -std
@@ -141,6 +142,8 @@ and
 system calls
 fail if one or more of the following are true:
 .Bl -tag -width Er
+.It Bq Er EPERM
+The caller does not have appropriate privilege to perform the operation.
 .It Bq Er ENOTDIR
 A component of the path prefix of
 .Fa path