From 8026dd7ea9a1f08a3e55fc23289cc53bdb82b5b6 Mon Sep 17 00:00:00 2001 From: remko Date: Thu, 24 Feb 2011 13:03:47 +0000 Subject: Move the sticky manual from section 8 to section 7 like NetBSD has, since this is not a command on itself. PR: 124468 MFC after: 1 week --- share/man/man7/Makefile | 1 + share/man/man7/sticky.7 | 82 +++++++++++++++++++++++++++++++++++++++++++++++++ share/man/man8/Makefile | 1 - share/man/man8/sticky.8 | 82 ------------------------------------------------- 4 files changed, 83 insertions(+), 83 deletions(-) create mode 100644 share/man/man7/sticky.7 delete mode 100644 share/man/man8/sticky.8 (limited to 'share') diff --git a/share/man/man7/Makefile b/share/man/man7/Makefile index ab7e020..e279b37 100644 --- a/share/man/man7/Makefile +++ b/share/man/man7/Makefile @@ -25,6 +25,7 @@ MAN= adding_user.7 \ security.7 \ sprog.7 \ stdint.7 \ + sticky.7 \ tuning.7 MLINKS= intro.7 miscellaneous.7 diff --git a/share/man/man7/sticky.7 b/share/man/man7/sticky.7 new file mode 100644 index 0000000..0f06603 --- /dev/null +++ b/share/man/man7/sticky.7 @@ -0,0 +1,82 @@ +.\" Copyright (c) 1980, 1991, 1993 +.\" The Regents of the University of California. All rights reserved. +.\" +.\" 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 University of +.\" California, Berkeley and its contributors. +.\" 4. Neither the name of the University 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 REGENTS 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 REGENTS 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. +.\" +.\" @(#)sticky.8 8.1 (Berkeley) 6/5/93 +.\" $FreeBSD$ +.\" +.Dd June 5, 1993 +.Dt STICKY 7 +.Os +.Sh NAME +.Nm sticky +.Nd sticky text and append-only directories +.Sh DESCRIPTION +A special file mode, called the +.Em sticky bit +(mode S_ISTXT), +is used to indicate special treatment +for directories. +It is ignored for regular files. +See +.Xr chmod 2 +or +the file +.In sys/stat.h +for an explanation of file modes. +.Sh STICKY DIRECTORIES +A directory whose `sticky bit' is set +becomes an append-only directory, or, more accurately, +a directory in which the deletion of files is restricted. +A file in a sticky directory may only be removed or renamed +by a user if the user has write permission for the directory and +the user is the owner of the file, the owner of the directory, +or the super-user. +This feature is usefully applied to directories such as +.Pa /tmp +which must be publicly writable but +should deny users the license to arbitrarily +delete or rename each others' files. +.Pp +Any user may create a sticky directory. +See +.Xr chmod 1 +for details about modifying file modes. +.Sh HISTORY +A +.Nm +command appeared in +.At 32v . +.Sh BUGS +Neither +.Xr open 2 +nor +.Xr mkdir 2 +will create a file with the sticky bit set. diff --git a/share/man/man8/Makefile b/share/man/man8/Makefile index 3859253..f3de79d 100644 --- a/share/man/man8/Makefile +++ b/share/man/man8/Makefile @@ -10,7 +10,6 @@ MAN= crash.8 \ rc.sendmail.8 \ rc.subr.8 \ rescue.8 \ - sticky.8 \ yp.8 MLINKS= rc.8 rc.atm.8 \ diff --git a/share/man/man8/sticky.8 b/share/man/man8/sticky.8 deleted file mode 100644 index aa94a11..0000000 --- a/share/man/man8/sticky.8 +++ /dev/null @@ -1,82 +0,0 @@ -.\" Copyright (c) 1980, 1991, 1993 -.\" The Regents of the University of California. All rights reserved. -.\" -.\" 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 University of -.\" California, Berkeley and its contributors. -.\" 4. Neither the name of the University 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 REGENTS 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 REGENTS 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. -.\" -.\" @(#)sticky.8 8.1 (Berkeley) 6/5/93 -.\" $FreeBSD$ -.\" -.Dd June 5, 1993 -.Dt STICKY 8 -.Os -.Sh NAME -.Nm sticky -.Nd sticky text and append-only directories -.Sh DESCRIPTION -A special file mode, called the -.Em sticky bit -(mode S_ISTXT), -is used to indicate special treatment -for directories. -It is ignored for regular files. -See -.Xr chmod 2 -or -the file -.In sys/stat.h -for an explanation of file modes. -.Sh STICKY DIRECTORIES -A directory whose `sticky bit' is set -becomes an append-only directory, or, more accurately, -a directory in which the deletion of files is restricted. -A file in a sticky directory may only be removed or renamed -by a user if the user has write permission for the directory and -the user is the owner of the file, the owner of the directory, -or the super-user. -This feature is usefully applied to directories such as -.Pa /tmp -which must be publicly writable but -should deny users the license to arbitrarily -delete or rename each others' files. -.Pp -Any user may create a sticky directory. -See -.Xr chmod 1 -for details about modifying file modes. -.Sh HISTORY -A -.Nm -command appeared in -.At 32v . -.Sh BUGS -Neither -.Xr open 2 -nor -.Xr mkdir 2 -will create a file with the sticky bit set. -- cgit v1.1