MirOS Manual: issetugid(2)

ISSETUGID(2)               BSD Programmer's Manual                ISSETUGID(2)

NAME

     issetugid - is current executable running setuid or setgid

SYNOPSIS

     #include <unistd.h>

     int
     issetugid(void);

DESCRIPTION

     The issetugid() function returns 1 if the process was made setuid or set-
     gid as the result of the last or other previous execve() system calls.
     Otherwise it returns 0.

     This system call exists so that library routines (inside libtermlib,
     libc, or other libraries) can guarantee safe behavior when used inside
     setuid or setgid programs. Some library routines may be passed insuffi-
     cient information and hence not know whether the current program was
     started setuid or setgid because higher level calling code may have made
     changes to the uid, euid, gid, or egid. Hence these low-level library
     routines are unable to determine if they are being run with elevated or
     normal privileges.

     In particular, it is wise to use this call to determine if a pathname re-
     turned from a getenv() call may safely be used to open() the specified
     file. Quite often this is not wise because the status of the effective
     uid is not known.

     The issetugid() system call's result is unaffected by calls to setuid(),
     setgid(), or other such calls. In case of a fork(), the child process in-
     herits the same status.

     The status of issetugid() is only affected by execve(). If a child pro-
     cess executes a new executable file, a new issetugid status will be
     determined. This status is based on the existing process's uid, euid,
     gid, and egid permissions and on the modes of the executable file. If the
     new executable file modes are setuid or setgid, or if the existing pro-
     cess is executing the new image with uid != euid or gid != egid, the new
     process will be considered issetugid.

ERRORS

     The issetugid() function is always successful, and no return value is
     reserved to indicate an error.

SEE ALSO

     execve(2), setegid(2), seteuid(2), setgid(2), setuid(2)

HISTORY

     The issetugid() function call first appeared in OpenBSD 2.0.

MirOS BSD #10-current          August 25, 1996                               1

Generated on 2014-07-04 21:17:45 by $MirOS: src/scripts/roff2htm,v 1.79 2014/02/10 00:36:11 tg Exp $

These manual pages and other documentation are copyrighted by their respective writers; their source is available at our CVSweb, AnonCVS, and other mirrors. The rest is Copyright © 2002‒2014 The MirOS Project, Germany.
This product includes material provided by Thorsten Glaser.

This manual page’s HTML representation is supposed to be valid XHTML/1.1; if not, please send a bug report – diffs preferred.