tcsetpgrp(3)

tcsetpgrp − フォアグラウンド処理グループ ID の設定

標準 C ライブラリ (libc, −lc)

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

int

tcsetpgrp(int fd, pid_t pgrp_id);

解説

処理が制御する端末を持つ場合は、 tcsetpgrp() 関数はその端末デバイスと連携 したフォアグラウンド処理グループ ID を pgrp_id に設定します。 fd に連携し た端末デバイスは、呼び出し処理の制御端末でなければならず、またその制御端 末はその呼び出し側処理のセッションに現在連携していなければなりません。 pgrp_id の値は、同じセッションにおける処理の呼び出し側処理の処理グループ ID と同じでなければなりません。

関数 tcsetpgrp() は、処理が成功すると値 0 を返します。そうでない場合、値 -1 が返され、グローバル変数 errno が設定されてエラーを示します。

tcsetpgrp() は次の場合に失敗します。

引数 fd が有効なファイル記述子ではありません。

[EINVAL]
無効な pgrp_id の値が指定されました。

[ENOTTY]
呼び出し処理が制御端末を持っていないか、または fd で表 わされるファイルが制御端末ではないか、または制御端末が もはや呼び出し処理のセッションに結合されていません。

[EPERM]
引数 pgrp_id が、同じセッションにおける処理の呼び出し 側処理の処理グループ ID と一致しません。

関連項目

setpgid(2), setsid(2), tcgetpgrp(3)

tcsetpgprp() 関数は、 IEEE Std 1003.1-1988 (‘‘POSIX.1’’) 規格に適合してい るものと考えられます。

FreeBSD 10.0 June 4, 1993 FreeBSD 10.0