Manpages

名 前

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 を 適 切 に 設 定 す る 。

エ ラ ー