名前

       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/ に書かれている。