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

FreeBSD Manual Pages

  
 
  

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

NAME
       tcsetpgrp - set foreground process group	ID

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

       int tcsetpgrp(int fildes, pid_t pgid_id);

DESCRIPTION
       If  the	process	 has  a	controlling terminal, tcsetpgrp() will set the
       foreground process group	ID associated with the	terminal  to  pgid_id.
       The file	associated with	fildes must be the controlling terminal	of the
       calling process and the controlling terminal must be currently  associ-
       ated with the session of	the calling process. The value of pgid_id must
       match a process group ID	of a process in	the same session as the	 call-
       ing process.

RETURN VALUES
       Upon  successful	 completion,  0	is returned. Otherwise,	-1 is returned
       and errno is set	to indicate the	error.

ERRORS
       The tcsetpgrp() function	will fail if:

       EBADF	       The fildes argument is not a valid file descriptor.

       EINVAL	       This implementation does	not support the	value  in  the
		       pgid_id argument.

       ENOTTY	       The  calling process does not have a controlling	termi-
		       nal, or the file	is not the  controlling	 terminal,  or
		       the  controlling	 terminal is no	longer associated with
		       the session of the calling process.

       EIO	       The process is not ignoring or holding SIGTTOU and is a
		       member of an orphaned process group.

       EPERM	       The  value  of pgid_id does not match the process group
		       ID of a process in the  same  session  as  the  calling
		       process.

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
       tcgetpgrp(3C), attributes(5), standards(5), termio(7I)

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

home | help