Resurrect the setre[ug]id() stubs.
This commit is contained in:
parent
23558a0acd
commit
601306abca
|
@ -1,4 +1,4 @@
|
|||
# $NetBSD: Makefile.inc,v 1.36 1996/04/23 10:42:30 mycroft Exp $
|
||||
# $NetBSD: Makefile.inc,v 1.37 1996/06/23 11:52:49 mycroft Exp $
|
||||
# @(#)Makefile.inc 8.1 (Berkeley) 6/17/93
|
||||
|
||||
# sys sources
|
||||
|
@ -29,7 +29,8 @@ ASM= accept.o access.o acct.o adjtime.o bind.o chdir.o chflags.o chmod.o \
|
|||
read.o readlink.o readv.o recvfrom.o recvmsg.o rename.o revoke.o \
|
||||
rmdir.o select.o semconfig.o semget.o semop.o sendmsg.o sendto.o \
|
||||
setegid.o seteuid.o setgid.o setgroups.o setitimer.o setpgid.o \
|
||||
setpriority.o setrlimit.o setsid.o setsockopt.o settimeofday.o \
|
||||
setpriority.o setregid.o setreuid.o \
|
||||
setrlimit.o setsid.o setsockopt.o settimeofday.o \
|
||||
setuid.o shmat.o shmctl.o shmdt.o shmget.o shutdown.o sigaction.o \
|
||||
sigaltstack.o socket.o socketpair.o stat.o statfs.o swapon.o \
|
||||
symlink.o sync.o sysarch.o umask.o undelete.o unlink.o unmount.o \
|
||||
|
@ -93,6 +94,7 @@ MAN+= accept.2 access.2 acct.2 adjtime.2 bind.2 brk.2 chdir.2 chflags.2 \
|
|||
mmap.2 mount.2 mprotect.2 msync.2 munmap.2 nfssvc.2 open.2 pathconf.2 \
|
||||
pipe.2 profil.2 ptrace.2 quotactl.2 read.2 readlink.2 reboot.2 recv.2 \
|
||||
rename.2 revoke.2 rmdir.2 select.2 send.2 setgroups.2 setpgid.2 \
|
||||
setregid.2 setreuid.2 \
|
||||
setsid.2 setuid.2 shutdown.2 sigaction.2 sigaltstack.2 sigpending.2 \
|
||||
sigprocmask.2 sigreturn.2 sigstack.2 sigsuspend.2 socket.2 \
|
||||
socketpair.2 stat.2 statfs.2 swapon.2 symlink.2 sync.2 sysarch.2 \
|
||||
|
|
|
@ -0,0 +1,107 @@
|
|||
.\" Copyright (c) 1996 Charles M. Hannum. All rights reserved.
|
||||
.\" Copyright (c) 1983, 1991 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.
|
||||
.\"
|
||||
.\" from: @(#)setregid.2 6.4 (Berkeley) 3/10/91
|
||||
.\" $Id: setregid.2,v 1.6 1996/06/23 11:52:53 mycroft Exp $
|
||||
.\"
|
||||
.Dd June 23, 1996
|
||||
.Dt SETREGID 2
|
||||
.Os BSD 4.2
|
||||
.Sh NAME
|
||||
.Nm setregid
|
||||
.Nd set real and effective group ID's
|
||||
.Sh SYNOPSIS
|
||||
.Fd #include <unistd.h>
|
||||
.Ft int
|
||||
.Fn setregid "int rgid" "int egid"
|
||||
.Sh DESCRIPTION
|
||||
The real and effective group ID's of the
|
||||
current process are set according to the arguments. If the real group ID
|
||||
is changed, the saved group ID is changed to the new value of the effective
|
||||
group ID.
|
||||
.Pp
|
||||
If
|
||||
.Fa rgid
|
||||
or
|
||||
.Fa egid
|
||||
is -1, the current gid is filled in by the system.
|
||||
Unprivileged users may change the real group
|
||||
ID to the effective group ID, and may change the effective group ID to the
|
||||
real group ID or the saved group ID; only the super-user may
|
||||
make other changes.
|
||||
.Pp
|
||||
The
|
||||
.Fn setregid
|
||||
function has been used to swap the real and effective group
|
||||
IDs in set-group-ID programs to temporarily relinquish the set-group-ID
|
||||
value. This purpose is now better served by the use of the
|
||||
.Fn setegid
|
||||
function (see
|
||||
.Xr setuid 2 ).
|
||||
.Pp
|
||||
When setting the real and effective group IDs to the same value, this
|
||||
function is equivalent to the
|
||||
.Fn setgid
|
||||
function.
|
||||
When setting only the effective group ID, this function is equivalent to
|
||||
the
|
||||
.Fn setegid
|
||||
function.
|
||||
.Sh RETURN VALUES
|
||||
Upon successful completion, a value of 0 is returned. Otherwise,
|
||||
a value of -1 is returned and
|
||||
.Va errno
|
||||
is set to indicate the error.
|
||||
.Sh ERRORS
|
||||
.Bl -tag -width Er
|
||||
.It Bq Er EPERM
|
||||
The current process is not the super-user and a change
|
||||
other than changing the effective group-id to the real group-id
|
||||
was specified.
|
||||
.El
|
||||
.Sh SEE ALSO
|
||||
.Xr getgid 2 ,
|
||||
.Xr setegid 2 ,
|
||||
.Xr setgid 2 ,
|
||||
.Xr setuid 2
|
||||
.Sh HISTORY
|
||||
The
|
||||
.Fn setregid
|
||||
function call appeared in
|
||||
.Bx 4.2
|
||||
and was dropped in
|
||||
.Bx 4.4 .
|
||||
It was reimplemented in
|
||||
.Nx 1.2
|
||||
in a way compatible with
|
||||
.Bx 4.3 ,
|
||||
SunOS and Linux.
|
|
@ -0,0 +1,107 @@
|
|||
.\" Copyright (c) 1996 Charles M. Hannum. All rights reserved.
|
||||
.\" Copyright (c) 1980, 1991 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.
|
||||
.\"
|
||||
.\" from: @(#)setreuid.2 6.4 (Berkeley) 3/10/91
|
||||
.\" $Id: setreuid.2,v 1.6 1996/06/23 11:52:56 mycroft Exp $
|
||||
.\"
|
||||
.Dd June 23, 1996
|
||||
.Dt SETREUID 2
|
||||
.Os BSD 4.2
|
||||
.Sh NAME
|
||||
.Nm setreuid
|
||||
.Nd set real and effective user ID's
|
||||
.Sh SYNOPSIS
|
||||
.Fd #include <unistd.h>
|
||||
.Ft int
|
||||
.Fn setreuid "int ruid" "int euid"
|
||||
.Sh DESCRIPTION
|
||||
The real and effective user ID's of the
|
||||
current process are set according to the arguments. If the real user ID
|
||||
is changed, the saved user ID is changed to the new value of the effective
|
||||
user ID.
|
||||
.Pp
|
||||
If
|
||||
.Fa ruid
|
||||
or
|
||||
.Fa euid
|
||||
is -1, the current uid is filled in by the system.
|
||||
Unprivileged users may change the real user
|
||||
ID to the effective user ID, and may change the effective user ID to the
|
||||
real user ID or the saved user ID; only the super-user may
|
||||
make other changes.
|
||||
.Pp
|
||||
The
|
||||
.Fn setreuid
|
||||
function has been used to swap the real and effective user
|
||||
IDs in set-user-ID programs to temporarily relinquish the set-user-ID
|
||||
value. This purpose is now better served by the use of the
|
||||
.Fn seteuid
|
||||
function (see
|
||||
.Xr setuid 2 ).
|
||||
.Pp
|
||||
When setting the real and effective user IDs to the same value, this
|
||||
function is equivalent to the
|
||||
.Fn setuid
|
||||
function.
|
||||
When setting only the effective user ID, this function is equivalent to
|
||||
the
|
||||
.Fn seteuid
|
||||
function.
|
||||
.Sh RETURN VALUES
|
||||
Upon successful completion, a value of 0 is returned. Otherwise,
|
||||
a value of -1 is returned and
|
||||
.Va errno
|
||||
is set to indicate the error.
|
||||
.Sh ERRORS
|
||||
.Bl -tag -width Er
|
||||
.It Bq Er EPERM
|
||||
The current process is not the super-user and a change
|
||||
other than changing the effective user-id to the real user-id
|
||||
was specified.
|
||||
.El
|
||||
.Sh SEE ALSO
|
||||
.Xr getuid 2 ,
|
||||
.Xr seteuid 2 ,
|
||||
.Xr setuid 2 ,
|
||||
.Xr setgid 2
|
||||
.Sh HISTORY
|
||||
The
|
||||
.Fn setreuid
|
||||
function call appeared in
|
||||
.Bx 4.2
|
||||
and was dropped in
|
||||
.Bx 4.4 .
|
||||
It was reimplemented in
|
||||
.Nx 1.2
|
||||
in a way compatible with
|
||||
.Bx 4.3 ,
|
||||
SunOS and Linux.
|
Loading…
Reference in New Issue