git: 29f208b78f53 - stable/13 - cr_canseeotheruids(), cr_canseeothergids(): Man pages: Impacts of rename
- Go to: [ bottom of page ] [ top of archives ] [ this month ]
Date: Thu, 21 Dec 2023 13:43:26 UTC
The branch stable/13 has been updated by olce:
URL: https://cgit.FreeBSD.org/src/commit/?id=29f208b78f5369288dcb4f8ec991543bd3a50b33
commit 29f208b78f5369288dcb4f8ec991543bd3a50b33
Author: Olivier Certner <olce.freebsd@certner.fr>
AuthorDate: 2023-08-17 23:54:39 +0000
Commit: Olivier Certner <olce@FreeBSD.org>
CommitDate: 2023-12-21 13:36:24 +0000
cr_canseeotheruids(), cr_canseeothergids(): Man pages: Impacts of rename
When these functions were renamed 7 years ago, their man pages were not.
Rename the latter in accordance and fix the names inside them. Fix
references to them as well. Add the old man pages to the list of
obsolete files.
Reviewed by: mhorne
Sponsored by: Kumacom SAS
Differential Revision: https://reviews.freebsd.org/D40630
(cherry picked from commit c59ab75c04fa32bc6d292596ff5e4593a05a6b1b)
Approved by: markj (mentor)
---
ObsoleteFiles.inc | 4 ++++
share/man/man9/Makefile | 4 ++--
share/man/man9/cr_cansee.9 | 8 ++++----
share/man/man9/{cr_seeothergids.9 => cr_canseeothergids.9} | 8 ++++----
share/man/man9/{cr_seeotheruids.9 => cr_canseeotheruids.9} | 8 ++++----
share/man/man9/p_candebug.9 | 8 ++++----
6 files changed, 22 insertions(+), 18 deletions(-)
diff --git a/ObsoleteFiles.inc b/ObsoleteFiles.inc
index fd4e1d98e631..ce8ac946b2a7 100644
--- a/ObsoleteFiles.inc
+++ b/ObsoleteFiles.inc
@@ -51,6 +51,10 @@
# xargs -n1 | sort | uniq -d;
# done
+# 20230927: Man pages renamed to match the actual functions
+OLD_FILES+=usr/share/man/man9/cr_seeothergids.9.gz
+OLD_FILES+=usr/share/man/man9/cr_seeotheruids.9.gz
+
# 20230911: caroot bundle updated
OLD_FILES+=usr/share/certs/trusted/E-Tugra_Certification_Authority.pem
OLD_FILES+=usr/share/certs/trusted/E-Tugra_Global_Root_CA_ECC_v3.pem
diff --git a/share/man/man9/Makefile b/share/man/man9/Makefile
index f1c7c2622e86..5ce5a46c3a78 100644
--- a/share/man/man9/Makefile
+++ b/share/man/man9/Makefile
@@ -67,9 +67,9 @@ MAN= accept_filter.9 \
counter.9 \
cpuset.9 \
cr_cansee.9 \
+ cr_canseeothergids.9 \
+ cr_canseeotheruids.9 \
critical_enter.9 \
- cr_seeothergids.9 \
- cr_seeotheruids.9 \
crypto.9 \
crypto_asym.9 \
crypto_buffer.9 \
diff --git a/share/man/man9/cr_cansee.9 b/share/man/man9/cr_cansee.9
index 8e058eb4e3e5..4824a231170b 100644
--- a/share/man/man9/cr_cansee.9
+++ b/share/man/man9/cr_cansee.9
@@ -50,9 +50,9 @@ variables
and
.Va security.bsd.see_other_uids ,
as per the description in
-.Xr cr_seeothergids 9
+.Xr cr_canseeothergids 9
and
-.Xr cr_seeotheruids 9
+.Xr cr_canseeotheruids 9
respectively.
.Sh RETURN VALUES
This function returns zero if the object with credential
@@ -84,7 +84,7 @@ does not belong to the same jail as
The MAC subsystem denied visibility.
.El
.Sh SEE ALSO
-.Xr cr_seeothergids 9 ,
-.Xr cr_seeotheruids 9 ,
+.Xr cr_canseeothergids 9 ,
+.Xr cr_canseeotheruids 9 ,
.Xr mac 9 ,
.Xr p_cansee 9
diff --git a/share/man/man9/cr_seeothergids.9 b/share/man/man9/cr_canseeothergids.9
similarity index 94%
rename from share/man/man9/cr_seeothergids.9
rename to share/man/man9/cr_canseeothergids.9
index bd8eb5d2e9d9..79269533ae5c 100644
--- a/share/man/man9/cr_seeothergids.9
+++ b/share/man/man9/cr_canseeothergids.9
@@ -26,14 +26,14 @@
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
.Dd November 11, 2003
-.Dt CR_SEEOTHERGIDS 9
+.Dt CR_CANSEEOTHERGIDS 9
.Os
.Sh NAME
-.Nm cr_seeothergids
+.Nm cr_canseeothergids
.Nd determine visibility of objects given their group memberships
.Sh SYNOPSIS
.Ft int
-.Fn cr_seeothergids "struct ucred *u1" "struct ucred *u2"
+.Fn cr_canseeothergids "struct ucred *u1" "struct ucred *u2"
.Sh DESCRIPTION
This function determines the visibility of objects in the
kernel based on the group IDs in the credentials
@@ -76,5 +76,5 @@ or
.Er ESRCH
otherwise.
.Sh SEE ALSO
-.Xr cr_seeotheruids 9 ,
+.Xr cr_canseeotheruids 9 ,
.Xr p_candebug 9
diff --git a/share/man/man9/cr_seeotheruids.9 b/share/man/man9/cr_canseeotheruids.9
similarity index 94%
rename from share/man/man9/cr_seeotheruids.9
rename to share/man/man9/cr_canseeotheruids.9
index 2cefd0f9dc8e..80acc2d7a6ca 100644
--- a/share/man/man9/cr_seeotheruids.9
+++ b/share/man/man9/cr_canseeotheruids.9
@@ -26,14 +26,14 @@
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
.Dd November 11, 2003
-.Dt CR_SEEOTHERUIDS 9
+.Dt CR_CANSEEOTHERUIDS 9
.Os
.Sh NAME
-.Nm cr_seeotheruids
+.Nm cr_canseeotheruids
.Nd determine visibility of objects given their user credentials
.Sh SYNOPSIS
.Ft int
-.Fn cr_seeotheruids "struct ucred *u1" "struct ucred *u2"
+.Fn cr_canseeotheruids "struct ucred *u1" "struct ucred *u2"
.Sh DESCRIPTION
This function determines the visibility of objects in the
kernel based on the real user IDs in the credentials
@@ -76,5 +76,5 @@ or
.Er ESRCH
otherwise.
.Sh SEE ALSO
-.Xr cr_seeothergids 9 ,
+.Xr cr_canseeothergids 9 ,
.Xr p_candebug 9
diff --git a/share/man/man9/p_candebug.9 b/share/man/man9/p_candebug.9
index ffa4fedb6172..e80d313de55c 100644
--- a/share/man/man9/p_candebug.9
+++ b/share/man/man9/p_candebug.9
@@ -113,9 +113,9 @@ Process
is not visible to thread
.Fa td
as determined by
-.Xr cr_seeotheruids 9
+.Xr cr_canseeotheruids 9
or
-.Xr cr_seeothergids 9 .
+.Xr cr_canseeothergids 9 .
.It Bq Er ESRCH
Thread
.Fa td
@@ -129,8 +129,8 @@ The MAC subsystem denied debuggability.
.Sh SEE ALSO
.Xr jail 2 ,
.Xr sysctl 8 ,
-.Xr cr_seeothergids 9 ,
-.Xr cr_seeotheruids 9 ,
+.Xr cr_canseeothergids 9 ,
+.Xr cr_canseeotheruids 9 ,
.Xr mac 9 ,
.Xr p_cansee 9 ,
.Xr prison_check 9