dg_set_subsid(2)               DG/UX R4.11MU05              dg_set_subsid(2)


NAME
       dgsetsubsid - create a subsession and set process group ID

SYNOPSIS
       #include <sys/types.h>

       pidt dgsetsubsid ()

DESCRIPTION
       If the calling process is not a subsession leader, the dgsetsubsid
       function shall create a new subsession.  The calling process will be
       the subsession leader of the new subsession.  The subsession ID will
       be the equal to the process ID of the calling process.  The calling
       process will be the only process in the new subsession.

RETURN VALUE
       Upon successful completion, the function dgsetsubsid returns the
       subsession ID which is equal to the ID of the calling process;
       otherwise, it returns a value of (pidt)-1 and sets errno to indicate
       an error.

ACCESS CONTROL
       The calling process cannot already be a subsession leader and another
       process cannot be a member of the subsession.

DIAGNOSTICS
       Under the following conditions, the function dgsetsubsid fails and
       sets errno to:

       EPERM     The calling process is already a subsession leader or
                 another process is already a member of the subsession.

SEE ALSO
       exec(2), fork(2), getpid(2), setpgid(2), setsid(2), getsid(2),
       dggetsubsid(2).


Licensed material--property of copyright holder(s)