4.4BSD/usr/share/man/cat3/tcsetpgrp.0

TCSETPGRP(3)                BSD Programmer's Manual               TCSETPGRP(3)

NNAAMMEE
     ttccsseettppggrrpp - set foreground process group ID

SSYYNNOOPPSSIISS
     ##iinncclluuddee <<ssyyss//ttyyppeess..hh>>
     ##iinncclluuddee <<uunniissttdd..hh>>

     _i_n_t
     ttccsseettppggrrpp(_i_n_t _f_d, _p_i_d___t _p_g_r_p___i_d);

DDEESSCCRRIIPPTTIIOONN
     If the process has a controlling terminal, the ttccsseettppggrrpp function sets
     the foreground process group ID associated with the terminal device to
     _p_g_r_p___i_d. The terminal device associated with _f_d must be the controlling
     terminal of the calling process and the controlling terminal must be cur-
     rently associated with the session of the calling process.  The value of
     _p_g_r_p___i_d must be the same as the process group ID of a process in the same
     session as the calling process.

     Upon successful completion, ttccsseettppggrrpp returns a value of zero.

EERRRROORRSS
     If an error occurs, ttccggeettppggrrpp returns -1 and the global variable _e_r_r_n_o is
     set to indicate the error, as follows:

     [EBADF]       The _f_d argument is not a valid file descriptor.

     [EINVAL]      An invalid value of _p_g_r_p___i_d was specified.

     [ENOTTY]      The calling process does not have a controlling terminal,
                   or the file represented by _f_d is not the controlling termi-
                   nal, or the controlling terminal is no longer associated
                   with the session of the calling process.

     [EPERM]       The _p_g_r_p___i_d argument does not match the process group ID of
                   a process in the same session as the calling process.

SSEEEE AALLSSOO
     setpgid(3),  setsid(2),  tcgetpgrp(3)

SSTTAANNDDAARRDDSS
     The ttccsseettppggpprrpp function is expected to be compliant with the IEEE
     Std1003.1-1988 (``POSIX'') specification.

4.4BSD                           June 4, 1993                                1