MirOS Manual: setpgid(2), setpgrp(2)

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

NAME

     setpgid, setpgrp - set process group

SYNOPSIS

     #include <unistd.h>

     int
     setpgid(pid_t pid, pid_t pgrp);

     int
     setpgrp(pid_t pid, pid_t pgrp);

DESCRIPTION

     setpgid() sets the process group of the specified process pid to the
     specified pgrp. If pid is zero, then the call applies to the current pro-
     cess.

     If the invoker is not the superuser, then the affected process must have
     the same effective user ID as the invoker or be a descendant of the in-
     voking process.

RETURN VALUES

     setpgid() returns 0 when the operation was successful. If the request
     failed, -1 is returned and the global variable errno indicates the rea-
     son.

ERRORS

     setpgid() will fail and the process group will not be altered if:

     [EACCES]      The value of the pid argument matches the process ID of a
                   child process of the calling process, and the child process
                   has successfully executed one of the exec functions.

     [EINVAL]      The value of the pgrp argument is less than zero.

     [EPERM]       The effective user ID of the requested process is different
                   from that of the caller and the process is not a descendant
                   of the calling process.

     [ESRCH]       The value of the pid argument does not match the process ID
                   of the calling process or of a child process of the calling
                   process.

SEE ALSO

     getpgrp(2)

STANDARDS

     setpgrp() is identical to setpgid(), and is retained for calling conven-
     tion compatibility with historical versions of BSD.

     The setpgid() function conforms to IEEE Std 1003.1-1988 ("POSIX").

MirOS BSD #10-current            June 4, 1993                                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.