Sun Microsystems, Inc.
spacerspacer
spacer   www.sun.com docs.sun.com | | |  
spacer
black dot
   
A   B   C   D   E   F   G   H   I   J   K   L   M   N   O   P   Q   R   S   T   U   V   W   X   Y   Z
    
 
Standard C Library Functionstcsetpgrp(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 associated 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 calling 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 terminal, 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 TYPEATTRIBUTE VALUE
MT-LevelMT-Safe, and Async-Signal-Safe

SEE ALSO

 

tcgetpgrp(3C), attributes(5), termio(7I)


SunOS 5.9Go To TopLast Changed 11 Dec 1998

 
      
      
Copyright 2002 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.