hpux man page for tcgetpgrp

Query: tcgetpgrp

OS: hpux

Section: 3c

Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar

tcgetpgrp(3C)															     tcgetpgrp(3C)

NAME
tcgetpgrp() - get foreground process group id
SYNOPSIS
DESCRIPTION
returns the value of the process group ID of the foreground process group associated with the terminal referenced by fildes. is allowed from a process that is a member of a background process group (see termio(7)); however, the information can be subsequently changed by a process that is a member of a foreground process group.
RETURN VALUE
Upon successful completion, returns the value of the process group ID of the foreground process group associated with the terminal refer- enced by fildes. Otherwise, returns a value of -1 and sets to indicate the error.
ERRORS
fails if any of the following conditions are encountered: The file associated with fildes is the controlling terminal of the calling process, however, there is no foreground process group defined for the controlling terminal. fildes is not a valid file descriptor. The file associated with fildes is not the controlling terminal or the calling process does not have a controlling terminal.
WARNINGS
The error which is returned if the controlling terminal has no foreground process group, might not be returned in future releases, depend- ing on the course taken by the POSIX standard. Portable applications therefore should not rely on this error condition.
SEE ALSO
setpgid(2), setsid(2), tcsetpgrp(3C), thread_safety(5), termio(7).
STANDARDS CONFORMANCE
tcgetpgrp(3C)
Related Man Pages
tcgetpgrp(3c) - opensolaris
tcsetpgrp(3) - linux
tcsetpgrp(3) - debian
tcgetpgrp(3c) - sunos
tcgetpgrp(3) - osx
Similar Topics in the Unix Linux Community
backgroud process
Help!
Cannot catch SIGINT while serial break condition occurs
Move shell script from foreground to background
Getting the process ID of the terminal in Unix/Linux