Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
tcgetpgrp(3C)		 Standard C Library Functions		 tcgetpgrp(3C)

NAME
       tcgetpgrp - get foreground process group	ID

SYNOPSIS
       #include	<sys/types.h>
       #include	<unistd.h>

       pid_t tcgetpgrp(int fildes);

DESCRIPTION
       The  tcgetpgrp()	function will return the value of the process group ID
       of the foreground process group associated with the terminal.

       If there	is no foreground process group,	tcgetpgrp()  returns  a	 value
       greater than 1 that does	not match the process group ID of any existing
       process group.

       The tcgetpgrp() function	is allowed from	a process that is a member  of
       a  background  process  group;  however,	 the information may be	subse-
       quently changed by a process that is a member of	a  foreground  process
       group.

RETURN VALUES
       Upon  successful	 completion,  tcgetpgrp()  returns  the	 value	of the
       process group ID	of the foreground process associated with  the	termi-
       nal.  Otherwise,	-1 is returned and errno is set	to indicate the	error.

ERRORS
       The tcgetpgrp() function	will fail if:

       EBADF The fildes	argument is not	a valid	file descriptor.

       ENOTTY
	     The  calling process does not have	a controlling terminal,	or the
	     file is not the controlling terminal.

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-------------------------------+
       |      ATTRIBUTE	TYPE	     |	     ATTRIBUTE VALUE	     |
       +-----------------------------+-------------------------------+
       |MT-Level		     |MT-Safe, and Async-Signal-Safe |
       +-----------------------------+-------------------------------+

SEE ALSO
       setpgid(2), setsid(2), tcsetpgrp(3C), attributes(5), termio(7I)

SunOS 5.9			  29 Dec 1996			 tcgetpgrp(3C)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | ATTRIBUTES | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=tcgetpgrp&sektion=3c&manpath=SunOS+5.9>

home | help