Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   10987 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

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 referenced
       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 ter‐
			     minal.

WARNINGS
       The error which is returned if the controlling terminal	has  no	 fore‐
       ground 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)

Vote for polarhome