OSF

NAME

setsid − Sets the process group ID

SYNOPSIS

#include <unistd.h>

#include <sys/types.h>

pid_t setsid( void );

DESCRIPTION

The setsid() function creates a new session when the calling process is not a process group leader.  The calling process then becomes the session leader of this session, becomes the process leader of the new process group, and has no controlling terminal.  The process group ID of the calling process is set equal to its process ID.  The calling process becomes the only process in the new process group and the only process in the new session. 

NOTES

AES Support Level:
Full use

RETURN VALUES

Upon successful completion, the value of the new process group ID is returned.  Otherwise, a value of -1 is returned and errno is set to indicate the error. 

ERRORS

If the setsid() function fails, errno may be set to the following value:

[EPERM]The calling process is already the process group leader, or the process group ID of a process other than the calling process matches the process ID of the calling process. 

RELATED INFORMATION

Functions: getpid(2), setpgid(2)