setpgrp()

Set the process group

Synopsis:

#include <unistd.h>

pid_t setpgrp( void );

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

If the calling process isn't already a session leader, setpgrp() makes it one by setting its process group ID and session ID to the value of its process ID, and releases its controlling terminal.

Note: In order to successfully call this function, your process must have the PROCMGR_AID_PGRP ability enabled. This ability is enabled by default (for POSIX conformance). You can disable it completely or restrict it to specific pid ranges. For more information, see procmgr_ability().

Returns:

The new process group ID.

Classification:

POSIX 1003.1 OB XSI. This function is marked as obsolescent, and may be removed from a future version of the standard.

Safety:
Cancellation point	No
Interrupt handler	No
Signal handler	Yes
Thread	Yes