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

tcsetpgrp(3C)							 tcsetpgrp(3C)

NAME
       tcsetpgrp() - set foreground process group id

SYNOPSIS
DESCRIPTION
       If  the calling process has a controlling terminal, sets the foreground
       process group ID associated with the terminal referenced by  fildes  to
       pgrp_id.	  The file associated with fildes must be the controlling ter‐
       minal of the calling process and the controlling terminal must be  cur‐
       rently  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  ses‐
       sion as the calling process.

RETURN VALUE
       Upon  successful	 completion,  returns zero.  Otherwise, returns −1 and
       sets to indicate the error.

ERRORS
       fails if any of the following conditions are encountered:

	      [EBADF]	     fildes is not a valid file descriptor.

	      [EINVAL]	     The value of the pgrp_id  argument	 is  not  sup‐
			     ported.

	      [ENOTTY]	     The  calling  process does not have a controlling
			     terminal, or the fildes is	 not  the  controlling
			     terminal,	or  the	 controlling  terminal	is  no
			     longer associated with the session of the calling
			     process.

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

SEE ALSO
       setpgid(2), setsid(2), tcgetpgrp(3C), thread_safety(5), termio(7).

STANDARDS CONFORMANCE
								 tcsetpgrp(3C)

Vote for polarhome