IPB
>  Man Pages > Linux > Suse Linux 10.1 > Section 2 > setregid man page

setregid man page

Section 2 - Suse Linux 10.1 Man Pages

Other operating system man pages available here


Advanced Search

Hopefully, this page is exactly what you are looking for, but if not, you can always find further assistance on Unix/Linux Forum!


SETREUID(2)                Linux Programmer's Manual               SETREUID(2)




NAME

       setreuid, setregid - set real and/or effective user or group ID


SYNOPSIS

       #include <sys/types.h>
       #include <unistd.h>

       int setreuid(uid_t ruid, uid_t euid);
       int setregid(gid_t rgid, gid_t egid);


DESCRIPTION

       setreuid() sets real and effective user IDs of the current process.

       Supplying a value of -1 for either the real or effective user ID forces
       the system to leave that ID unchanged.

       Unprivileged processes may only set the effective user ID to  the  real
       user ID, the effective user ID or the saved set-user-ID.

       POSIX:  It  is  unspecified  whether unprivileged processes may set the
       real user ID to the real user ID, the effective user ID  or  the  saved
       set-user-ID.

       Linux:  Unprivileged  users  may  only set the real user ID to the real
       user ID or the effective user ID.

       Linux: If the real user ID is set or the effective user ID is set to  a
       value  not  equal  to  the previous real user ID, the saved set-user-ID
       will be set to the new effective user ID.

       Completely analogously, setregid() sets real and effective  group  ID's
       of the current process, and all of the above holds with "group" instead
       of "user".



RETURN VALUE

       On success, zero is returned.  On error, -1 is returned, and  errno  is
       set appropriately.


ERRORS

       EPERM  The  current process is not privileged (Linux: does not have the
              CAP_SETUID capability in the case of setreuid(), or the CAP_SET
              GID  capability  in  the  case of setregid()) and a change other
              than (i) swapping the effective user (group) ID  with  the  real
              user  (group)  ID, or (ii) setting one to the value of the other
              or (iii) setting the effective user (group) ID to the  value  of
              the saved set-user-ID (saved set-group-ID) was specified.


NOTES

       Setting  the  effective user (group) ID to the saved set-user-ID (saved
       set-group-ID) is possible since Linux 1.1.37 (1.1.38).


CONFORMING TO

       4.3BSD (the setreuid() and setregid() function calls first appeared  in
       4.2BSD).


SEE ALSO

       getgid(2),  getuid(2),  seteuid(2), setgid(2), setresuid(2), setuid(2),
       capabilities(7)



Linux 2.6                         2004-07-04                       SETREUID(2)


Man(1) output converted with man2html and wrapped by fishsponge

This page was generated on Tue Feb 13 02:17:40 GMT 2007

Your favourite pages:

No pages logged yet.
Trying to save cookie...

Top 10 most popular pages:

sqlite3 man page (5323 hits)
(openSUSE 10.2)

svn man page (5178 hits)
(FreeBSD 6.2)

adv_cap_autoneg man page (4865 hits)
(Solaris 10 11_06)

CPAN man page (4602 hits)
(Suse Linux 10.1)

ssh man page (4337 hits)
(Suse Linux 10.1)

ssh-socks5-proxy-connect man page (2843 hits)
(Solaris 10 11_06)

netcat man page (2690 hits)
(Suse Linux 10.1)

pprosetup man page (2474 hits)
(Solaris 10 11_06)

startproc man page (2456 hits)
(Suse Linux 10.1)

signal man page (2395 hits)
(Suse Linux 10.1)

Useful Links

Go Back

Visitor Statistics


Valid XHTML 1.0 Transitional     Valid CSS!

Partners: Cambridge Plus :: Pyrenees Travel :: PCB Layout, CadStar :: <Link Available>
Unix Man Pages / Linux Man Pages :: HiFi Forum :: SIP VoIP Phone & Provider Reviews :: UNIX/Linux Forum Archives

More info on advertising on Unix/Linux Forum