|This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.|
Make a terminal device a controlling device
#include <termios.h> int tcsetsid( int fd, pid_t pid );
- A file descriptor that's associated with the device that you want to make a controlling device.
- The ID of the process that you want to associate with the controlling device.
Use the -l c option to qcc to link against this library. This library is usually included automatically.
The tcsetsid() function makes the terminal device associated with the file descriptor argument fd into a controlling terminal that's associated with the process pid. If successful, this call causes subsequent hangup conditions on the terminal device fd to generate a SIGHUP signal on the given process.
This call is equivalent to calling ioctl( fd, TIOCSCTTY ) to set the controlling terminal to the current process. You can clear the controlling terminal by passing -1 as fd.
- Failure; errno is set.
- Invalid file descriptor.
- The argument pid is invalid.
- ENOSYS, ENOTTY
- The argument fd isn't associated with a terminal device.