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

FreeBSD Man Pages

Man Page or Keyword Search:
Man Architecture
Apropos Keyword Search (all sections) Output format
home | help
TCSETPGRP(3)	       FreeBSD Library Functions Manual		  TCSETPGRP(3)

NAME
     tcsetpgrp -- set foreground process group ID

LIBRARY
     Standard C	Library	(libc, -lc)

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

     int
     tcsetpgrp(int fd, pid_t pgrp_id);

DESCRIPTION
     If	the process has	a controlling terminal,	the tcsetpgrp()	function sets
     the foreground process group ID associated	with the terminal device to
     pgrp_id.  The terminal device associated with fd must be the controlling
     terminal 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 be the same as the process group ID of a process in the same
     session as	the calling process.

RETURN VALUES
     The tcsetpgrp() function returns the value	0 if successful; otherwise the
     value -1 is returned and the global variable errno	is set to indicate the
     error.

ERRORS
     The tcsetpgrp() function will fail	if:

     [EBADF]		The fd argument	is not a valid file descriptor.

     [EINVAL]		An invalid value of pgrp_id was	specified.

     [ENOTTY]		The calling process does not have a controlling	termi-
			nal, or	the file represented by	fd is not the control-
			ling terminal, or the controlling terminal is no
			longer associated with the session of the calling
			process.

     [EPERM]		The pgrp_id argument 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(3)

STANDARDS
     The tcsetpgrp() function is expected to be	compliant with the IEEE	Std
     1003.1-1988 (``POSIX.1'') specification.

FreeBSD	10.1			 June 4, 1993			  FreeBSD 10.1

NAME | LIBRARY | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | SEE ALSO | STANDARDS

Want to link to this manual page? Use this URL:
<http://www.freebsd.org/cgi/man.cgi?query=tcsetpgrp&sektion=3&manpath=FreeBSD+7.1-RELEASE>

home | help