From 97e393b1f1bab7a570262fe6b5dabaee43921208 Mon Sep 17 00:00:00 2001 From: elad Date: Tue, 16 May 2006 15:56:15 +0000 Subject: [PATCH] kill unused man-pages. prompted by Iain Hibbert. --- distrib/sets/lists/comp/mi | 34 ++++----- share/man/man9/Makefile | 12 +--- share/man/man9/cred.9 | 143 ------------------------------------- share/man/man9/suser.9 | 70 ------------------ 4 files changed, 20 insertions(+), 239 deletions(-) delete mode 100644 share/man/man9/cred.9 delete mode 100644 share/man/man9/suser.9 diff --git a/distrib/sets/lists/comp/mi b/distrib/sets/lists/comp/mi index 088ba8cc31f9..4c672d38905e 100644 --- a/distrib/sets/lists/comp/mi +++ b/distrib/sets/lists/comp/mi @@ -1,4 +1,4 @@ -# $NetBSD: mi,v 1.879 2006/05/14 22:11:47 elad Exp $ +# $NetBSD: mi,v 1.880 2006/05/16 15:56:15 elad Exp $ ./etc/mtree/set.comp comp-sys-root ./usr/bin/addr2line comp-debug-bin bfd ./usr/bin/ar comp-util-bin bfd @@ -5268,13 +5268,13 @@ ./usr/share/man/cat9/cpu_switch.0 comp-sys-catman .cat ./usr/share/man/cat9/cpu_sysctl.0 comp-obsolete obsolete ./usr/share/man/cat9/cpu_wait.0 comp-obsolete obsolete -./usr/share/man/cat9/crcopy.0 comp-sys-catman .cat -./usr/share/man/cat9/crcvt.0 comp-sys-catman .cat -./usr/share/man/cat9/crdup.0 comp-sys-catman .cat -./usr/share/man/cat9/cred.0 comp-sys-catman .cat -./usr/share/man/cat9/crfree.0 comp-sys-catman .cat -./usr/share/man/cat9/crget.0 comp-sys-catman .cat -./usr/share/man/cat9/crhold.0 comp-sys-catman .cat +./usr/share/man/cat9/crcopy.0 comp-obsolete .cat +./usr/share/man/cat9/crcvt.0 comp-obsolete .cat +./usr/share/man/cat9/crdup.0 comp-obsolete .cat +./usr/share/man/cat9/cred.0 comp-obsolete .cat +./usr/share/man/cat9/crfree.0 comp-obsolete .cat +./usr/share/man/cat9/crget.0 comp-obsolete .cat +./usr/share/man/cat9/crhold.0 comp-obsolete .cat ./usr/share/man/cat9/crypto_dispatch.0 comp-sys-catman .cat ./usr/share/man/cat9/crypto_done.0 comp-sys-catman .cat ./usr/share/man/cat9/crypto_freereq.0 comp-sys-catman .cat @@ -5775,7 +5775,7 @@ ./usr/share/man/cat9/sun3/isr_add_autovect.0 comp-sys-catman .cat ./usr/share/man/cat9/sun3/isr_add_custom.0 comp-sys-catman .cat ./usr/share/man/cat9/sun3/isr_add_vectored.0 comp-sys-catman .cat -./usr/share/man/cat9/suser.0 comp-sys-catman .cat +./usr/share/man/cat9/suser.0 comp-obsolete .cat ./usr/share/man/cat9/suspendsched.0 comp-sys-catman .cat ./usr/share/man/cat9/suswintr.0 comp-sys-catman .cat ./usr/share/man/cat9/susword.0 comp-sys-catman .cat @@ -9322,13 +9322,13 @@ ./usr/share/man/man9/cpu_switch.9 comp-sys-man .man ./usr/share/man/man9/cpu_sysctl.9 comp-obsolete obsolete ./usr/share/man/man9/cpu_wait.9 comp-obsolete obsolete -./usr/share/man/man9/crcopy.9 comp-sys-man .man -./usr/share/man/man9/crcvt.9 comp-sys-man .man -./usr/share/man/man9/crdup.9 comp-sys-man .man -./usr/share/man/man9/cred.9 comp-sys-man .man -./usr/share/man/man9/crfree.9 comp-sys-man .man -./usr/share/man/man9/crget.9 comp-sys-man .man -./usr/share/man/man9/crhold.9 comp-sys-man .man +./usr/share/man/man9/crcopy.9 comp-obsolete .man +./usr/share/man/man9/crcvt.9 comp-obsolete .man +./usr/share/man/man9/crdup.9 comp-obsolete .man +./usr/share/man/man9/cred.9 comp-obsolete .man +./usr/share/man/man9/crfree.9 comp-obsolete .man +./usr/share/man/man9/crget.9 comp-obsolete .man +./usr/share/man/man9/crhold.9 comp-obsolete .man ./usr/share/man/man9/crypto_dispatch.9 comp-sys-man .man ./usr/share/man/man9/crypto_done.9 comp-sys-man .man ./usr/share/man/man9/crypto_freereq.9 comp-sys-man .man @@ -9829,7 +9829,7 @@ ./usr/share/man/man9/sun3/isr_add_autovect.9 comp-sys-man .man ./usr/share/man/man9/sun3/isr_add_custom.9 comp-sys-man .man ./usr/share/man/man9/sun3/isr_add_vectored.9 comp-sys-man .man -./usr/share/man/man9/suser.9 comp-sys-man .man +./usr/share/man/man9/suser.9 comp-obsolete .man ./usr/share/man/man9/suspendsched.9 comp-sys-man .man ./usr/share/man/man9/suswintr.9 comp-sys-man .man ./usr/share/man/man9/susword.9 comp-sys-man .man diff --git a/share/man/man9/Makefile b/share/man/man9/Makefile index 8e253b69027b..b440c39a5f81 100644 --- a/share/man/man9/Makefile +++ b/share/man/man9/Makefile @@ -1,4 +1,4 @@ -# $NetBSD: Makefile,v 1.197 2006/05/14 22:07:22 elad Exp $ +# $NetBSD: Makefile,v 1.198 2006/05/16 15:56:15 elad Exp $ # Makefile for section 9 (kernel function and variable) manual pages. @@ -11,7 +11,7 @@ MAN= altq.9 arc4random.9 arp.9 audio.9 autoconf.9 \ cpu_lwp_fork.9 \ cpu_initclocks.9 cpu_number.9 cpu_reboot.9 cpu_rootconf.9 \ cpu_startup.9 cpu_swapout.9 \ - cred.9 ctxsw.9 curproc.9 \ + ctxsw.9 curproc.9 \ delay.9 disk.9 ddc.9 disklabel.9 dofileread.9 \ dopowerhooks.9 do_setresuid.9 doshutdownhooks.9 driver.9 \ edid.9 errno.9 ethersubr.9 evcnt.9 extattr.9 extent.9 \ @@ -36,7 +36,7 @@ MAN= altq.9 arc4random.9 arp.9 audio.9 autoconf.9 \ rt_timer.9 RUN_ONCE.9 \ SCHED_LOCK.9 scheduler.9 \ scsipi.9 setjmp.9 setrunqueue.9 shutdownhook_establish.9 \ - signal.9 softintr.9 spl.9 store.9 suser.9 suspendsched.9 \ + signal.9 softintr.9 spl.9 store.9 suspendsched.9 \ sysctl.9 tc.9 time.9 todr.9 uiomove.9 ucom.9 userret.9 \ vattr.9 vcons.9 vfs.9 vfs_hooks.9 vfsops.9 vfssubr.9 vme.9 \ vnfileops.9 vnode.9 vnodeops.9 vnsubr.9 \ @@ -160,12 +160,6 @@ MLINKS+=cpu_dumpconf.9 cpu_dump.9 cpu_dumpconf.9 cpu_dumpsize.9 \ cpu_dumpconf.9 dumpsys.9 MLINKS+=cpu_lwp_fork.9 child_return.9 cpu_lwp_fork.9 proc_trampoline.9 MLINKS+=cpu_swapout.9 cpu_swapin.9 -MLINKS+=cred.9 crfree.9 \ - cred.9 crhold.9 \ - cred.9 crcopy.9 \ - cred.9 crdup.9 \ - cred.9 crget.9 \ - cred.9 crcvt.9 MLINKS+=ctxsw.9 cpu_switch.9 ctxsw.9 mi_switch.9 MLINKS+=curproc.9 curcpu.9 MLINKS+=delay.9 DELAY.9 diff --git a/share/man/man9/cred.9 b/share/man/man9/cred.9 deleted file mode 100644 index 7686068324fd..000000000000 --- a/share/man/man9/cred.9 +++ /dev/null @@ -1,143 +0,0 @@ -.\" $NetBSD: cred.9,v 1.6 2005/12/26 19:48:12 perry Exp $ -.\" -.\" Copyright (c) 2002 The NetBSD Foundation, Inc. -.\" All rights reserved. -.\" -.\" This code is derived from software contributed to The NetBSD Foundation -.\" by Gregory McGarry. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" 3. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the NetBSD -.\" Foundation, Inc. and its contributors. -.\" 4. Neither the name of The NetBSD Foundation nor the names of its -.\" contributors may be used to endorse or promote products derived -.\" from this software without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS -.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED -.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR -.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS -.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR -.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF -.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS -.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN -.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) -.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE -.\" POSSIBILITY OF SUCH DAMAGE. -.\" -.Dd January 25, 2003 -.Dt CRED 9 -.Os -.Sh NAME -.Nm cred , -.Nm crcopy , -.Nm crcvt -.Nm crdup , -.Nm crfree , -.Nm crget , -.Nm crhold , -.Nd operations on user credentials -.Sh SYNOPSIS -.In sys/param.h -.In sys/ucred.h -.Ft struct ucred * -.Fn crcopy "struct ucred *cr" -.Ft void -.Fn crcvt "struct ucred *cr" "const struct uucred *ucr" -.Ft struct ucred * -.Fn crdup "struct ucred *cr" -.Ft void -.Fn crfree "struct ucred *cr" -.Ft struct ucred * -.Fn crget "void" -.Ft void -.Fn crhold "struct ucred *cr" -.Sh DESCRIPTION -A process must have the appropriate user credentials for the kernel to -perform an operation on its behalf. -The user credentials are stored along with the process in the following -structure: -.Pp -.Bd -literal -struct ucred { - uint32_t cr_ref; /* reference count */ - uid_t cr_uid; /* effective user id */ - gid_t cr_gid; /* effective group id */ - uint32_t cr_ngroups; /* number of groups */ - gid_t cr_groups[NGROUPS]; /* groups */ -}; -.Ed -.Pp -User credentials are controlled by the -.Xr group 5 -and -.Xr passwd 5 -files and manipulated using the -.Xr setregid 2 , -.Xr setgid 2 , -.Xr setegid 2 , -.Xr setgroups 2 , -and -.Xr getgroups 2 -system calls. -.Pp -References to user credentials are maintained from many different data -structures, including processes, file descriptors and vnodes. -The ucred member -.Em cr_ref -reflects the number of references to the credentials. -.Sh FUNCTIONS -The following functions operate on user credentials: -.Pp -.Bl -tag -width compact -.It Fn crcopy "cr" -Allocate a new credentials structure and copy the contents from -credentials -.Fa cr -to the new one. -The old credentials -.Fa cr -are freed. -The reference count on the returned credentials is guaranteed to be one. -.It Fn crcvt "cr" "ucr" -Convert from userland credentials -.Fa ucr -to kernel credentials -.Fa cr . -.It Fn crdup "cr" -Allocate a new credentials structure and copy the contents from -credentials -.Fa cr -to the new one. -The old credentials -.Fa cr -remain unchanged. -The reference count on the returned credentials is guaranteed to be one. -.It Fn crfree "cr" -Decrement the reference count on credentials -.Fa cr . -If the reference count drops to zero, then the credentials are freed. -.It Fn crget "void" -Allocate and return zeroed credentials. -.It Fn crhold "cr" -Increment the reference count on credentials -.Fa cr . -.El -.Sh SEE ALSO -.Xr suser 9 -.Sh BUGS -User credentials are sometimes allocated using -.Xr MALLOC 9 -and sometimes using the -.Xr pool 9 -facility. -This cannot be right. diff --git a/share/man/man9/suser.9 b/share/man/man9/suser.9 deleted file mode 100644 index 5b2dd4cc6315..000000000000 --- a/share/man/man9/suser.9 +++ /dev/null @@ -1,70 +0,0 @@ -.\" $NetBSD: suser.9,v 1.6 2005/09/06 20:12:43 kleink Exp $ -.\" -.\" Copyright (c) 2002 The NetBSD Foundation, Inc. -.\" All rights reserved. -.\" -.\" This code is derived from software contributed to The NetBSD Foundation -.\" by Gregory McGarry. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" 3. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the NetBSD -.\" Foundation, Inc. and its contributors. -.\" 4. Neither the name of The NetBSD Foundation nor the names of its -.\" contributors may be used to endorse or promote products derived -.\" from this software without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS -.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED -.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR -.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS -.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR -.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF -.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS -.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN -.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) -.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE -.\" POSSIBILITY OF SUCH DAMAGE. -.\" -.Dd January 25, 2003 -.Dt SUSER 9 -.Os -.Sh NAME -.Nm suser -.Nd test for super-user credentials -.Sh SYNOPSIS -.In sys/param.h -.In sys/ucred.h -.In sys/acct.h -.Ft int -.Fn suser "struct ucred *cred" "u_short *acflag" -.Sh DESCRIPTION -.Fn suser -tests whether the specified credentials -.Fa cred -imply super-user privilege. -The argument -.Fa acflag , -if non-NULL, is a pointer to the -.Em ac_flag -in the accounting structure. -If super-user privilege is implied by -the credentials, and -.Fa acflag -is not NULL, -the ASU flag is set in -.Fa acflag -to indicate the use of super-powers. -.Pp -.Fn suser -returns zero on success, or -.Er EPERM -if super-user privilege is not implied by the credentials.