pgm_make_orphan()

PGM_$MAKE_ORPHAN                  Domain/OS                   PGM_$MAKE_ORPHAN


NAME
     pgm_$make_orphan - orphan a process

SYNOPSIS (C)
     #include <apollo/base.h>
     #include <apollo/pgm.h>

     void pgm_$make_orphan(
          pgm_$proc &process_handle,
          uid_$t *process_uid,
          status_$t *status)

SYNOPSIS (Pascal)
     %include '/sys/ins/base.ins.pas';
     %include '/sys/ins/pgm.ins.pas';

     procedure pgm_$make_orphan(
          in process_handle: pgm_$proc;
          out process_uid: uid_$t;
          out status: status_$t);

SYNOPSIS (FORTRAN)
     %include '/sys/ins/base.ins.ftn'
     %include '/sys/ins/pgm.ins.ftn'

           integer*4 process_handle, process_uid(2), status

           call pgm_$make_orphan(process_handle, process_uid, status)

DESCRIPTION
     Pgm_$make_orphan changes the process on process_handle from a child into
     an orphan process.  An orphan process executes in background mode, and
     runs independently of its parent process.  A parent process can use
     pgm_$make_orphan to change a child process invoked in default mode into a
     process running in background mode.  When pgm_$make_orphan returns,
     process_handle is no longer valid.

     process_handle
          The process handle of a child process.

     process_uid
          The process UID of the orphaned process.

     status
          The completion status.
Museum
