TCGETPGRP(3P) — UNIX Programmer’s Manual

NAME

tcgetpgrp, tcsetpgrp − get and set foreground process group ID

SYNOPSIS

#include <sys/types.h>

int tcgetpgrp(int fildes);

int tcsetpgrp(int fildes, pid_t pgrp_id);

DESCRIPTION

Tcgetpgrp returns the value of the process group ID of the foreground process group associated with the terminal, indicated through fildes. It may be called from a process that is a member of a background process group; however, the information may be changed by a process that is a member of a foreground process group.

Tcsetpgrp sets the foreground process group ID associated with the controlling terminal, indicated through fildes, to pgrp_id. The controlling terminal must be currently associated with the session of the calling process. The value of pgrp_id must match a process group ID of a process in the same session as the calling process.

RETURN VALUE

Upon successful completion tcgetpgrp and tcsetpgrp return a value of zero. Otherwise, a value of -1 is returned and errno is set to indicate the error.

ERRORS

Tcgetpgrp and tcsetpgrp shall return −1 and set errno to the corresponding value:

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

[ENOTTY] The calling process does not have a controlling terminal.

[ENOTTY] The file given through fildes is not the controlling terminal.

The following errors may be associated with tcsetpgrp:

[EINVAL] The value of the pgrp_id argument is not valid.

[ENOTTY] The controlling terminal is no longer associated with the session of the calling process.

[EPERM] The value of pgrp_id is a valid value, but does not match the process group ID of a process in the same session as the calling process.

Museum