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	termi-
		       nal, or the file	is not the controlling terminal.

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

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

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

SunOS 5.10			  14 Aug 2002			 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=3&manpath=SunOS+5.10>

home | help