名前

       tcgetpgrp, tcsetpgrp - 端末のフォアグラウンドプロセスグループの 取得/設定を行う

書式

       #include <unistd.h>

       pid_t tcgetpgrp(int fd);

       int tcsetpgrp(int fd, pid_t pgrp);

説明

       関数  tcgetpgrp()   は、  fd に対応する端末のフォアグラウンドプロセスグループの プロセスグ
       ループ ID を返す。 fd で指定された端末は、呼び出しを行うプロセスの制御端末でなければならな
       い。

       関数  tcsetpgrp()  は、プロセスグループID が pgrp のプロセスグループを fd に対応する端末の
       フォアグラウンドプロセスグループにする。 このとき、 fd は tcsetpgrp() を呼び出すプロセスの
       制御端末でなければならない。 さらに、 pgrp は、呼び出しを行うプロセスと同じセッションに 属
       する (メンバが空でない) プロセスグループでなければならない。

       tcsetpgrp()    がセッションに属するバックグラウンドグループプロセスのメンバから   呼び出さ
       れ、かつ呼び出しを行うプロセスが SIGTTOU をブロックしたり 無視したりするようになっていない
       場合、 SIGTTOU シグナルは バックグラウンドプロセスグループの全てのメンバに送られる。

返り値

       fd が呼び出しを行ったプロセスの制御端末を参照している場合、関数 tcgetpgrp() は、その制御端
       末のフォアグラウンドプロセスグループがあれば そのプロセスグループの ID を返す。 そのような
       プロセスグループがなければ、現在プロセスグループ ID  として使用されていない、1より大きな何
       らかの値が返される。 fd が呼び出しを行ったプロセスの制御端末を参照していない場合、 -1 が返
       され、 errno が適切に設定される。

       成功した場合、 tcsetpgrp()  は 0 を返す。そうでない場合、 -1 を返し、 errno を適切に設定す
       る。

エラー

       EBADF  fd が適切なファイルディスクリプターでない。

       EINVAL pgrp が無効な値である。

       ENOTTY 呼び出しを行ったプロセスが制御端末を持っていない、もしくは   制御端末を持っているが
              fd で参照されるものとは異なる、 tcsetpgrp()  の場合は、 fd で指定された制御端末がす
              でに呼び出しを行ったプロセスのセッション と関係のないものになっている際にも、このエ
              ラーとなる。

       EPERM  pgrp が有効な値だが、呼び出しを行ったプロセスと同じセッションに属する  プロセスのプ
              ロセスグループ ID には該当するものがない。

属性

       この節で使用されている用語の説明については、 attributes(7) を参照。

       ┌─────────────────────────┬───────────────┬─────────┐
       │インターフェース         │ 属性          │ 値      │
       ├─────────────────────────┼───────────────┼─────────┤
       │tcgetpgrp(), tcsetpgrp() │ Thread safety │ MT-Safe │
       └─────────────────────────┴───────────────┴─────────┘

準拠

       POSIX.1-2001, POSIX.1-2008.

注意

       この関数は TIOCGPGRP と TIOCGSID の ioctl 経由で実現されている。

   歴史
       これらの ioctl は 4.2BSD で登場した。 これらの関数は POSIX で考案されたものである。

関連項目

       setpgid(2), setsid(2), credentials(7)

この文書について

       この man ページは Linux man-pages プロジェクトのリリース 5.10 の一部である。プロジェクトの
       説明とバグ報告に関する情報は https://www.kernel.org/doc/man-pages/ に書かれている。