Manpages

名 前

setpgid, getpgid, setpgrp, getpgrp − プ ロ セ ス グ ル ー プ の 設 定 /取 得 を 行 う

書 式

#include <unistd.h>

int setpgid(pid_t pid, pid_t pgid);
pid_t getpgid(pid_t pid);

pid_t getpgrp(void); /* POSIX.1 version */
pid_t getpgrp(pid_t pid);            /* BSD version */

int setpgrp(void); /* System V version */
int setpgrp(pid_t pid, pid_t pgid);  /* BSD version */

glibc 向 け の 機 能 検 査 マ ク ロ の 要 件 (feature_test_macros(7) 参 照 ):

getpgid():

_XOPEN_SOURCE >= 500 || _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED
|| /* glibc 2.12 以 降 : */ _POSIX_C_SOURCE >= 200809L

setpgrp() (POSIX.1):
_SVID_SOURCE || _XOPEN_SOURCE >= 500 ||
_XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED
|| /* glibc 2.19 以 降 : */ _BSD_SOURCE

setpgrp() (BSD), getpgrp() (BSD) [glibc 2.19 よ り 前 ]:
_BSD_SOURCE &&
! (_POSIX_SOURCE || _POSIX_C_SOURCE || _XOPEN_SOURCE ||
_XOPEN_SOURCE_EXTENDED || _GNU_SOURCE || _SVID_SOURCE)

説 明

こ れ ら の イ ン タ ー フ ェ ー ス す べ て が Linux で 利 用 可 能 で 、 こ れ ら を 使 っ て プ ロ セ ス の プ ロ セ ス グ ル ー プ ID (PGID) の 取 得 や 設 定 が で き る 。 推 奨 の 、 POSIX.1 で 規 定 さ れ た 方 法 で は 、 getpgrp(void) で 呼 び 出 し 元 プ ロ セ ス の PGID を 取 得 し 、 setpgid() で 設 定 す る 。

setpgid() は pid で 指 定 し た プ ロ セ ス の PGID に pgid を 設 定 す る 。 pid が ゼ ロ な ら ば 、 呼 び 出 し 元 プ ロ セ ス の プ ロ セ ス ID が pid と し て 使 用 さ れ る 。 pgid が ゼ ロ な ら ば 、 pid で 指 定 さ れ た プ ロ セ ス の PGID が そ の プ ロ セ ス の プ ロ セ ス ID と 同 じ に 設 定 さ れ る 。 setpgid() を プ ロ セ ス を あ る プ ロ セ ス グ ル ー プ か ら 別 の グ ル ー プ へ 移 動 す る た め に 使 用 す る 場 合 は (一 部 の シ ェ ル は パ イ プ ラ イ ン を 生 成 す る 時 に こ れ を 行 う )、 両 方 の プ ロ セ ス グ ル ー プ は 同 じ セ ッ シ ョ ン の 一 部 で な け れ ば な ら な い (setsid(2) と credentials(7) 参 照 )。 こ の 場 合 は pgid は 参 加 す べ き 既 存 の プ ロ セ ス グ ル ー プ を 指 定 し 、 そ の セ ッ シ ョ ン ID は 参 加 す る プ ロ セ ス の セ ッ シ ョ ン ID に 一 致 し な け れ ば な ら な い 。

POSIX.1 バ ー ジ ョ ン の getpgrp() は 引 き 数 を 一 つ も と ら ず 、 呼 び 出 し 元 プ ロ セ ス の PGID を 返 す 。

getpgid() は pid で 指 定 さ れ た プ ロ セ ス の PGID を 返 す 。 pid が ゼ ロ な ら ば 、 呼 び 出 し 元 プ ロ セ ス の プ ロ セ ス ID が pid と し て 使 用 さ れ る 。 (呼 び 出 し 元 プ ロ セ ス 以 外 の プ ロ セ ス の PGID の 取 得 が 必 要 に な る こ と は め っ た に な く 、 呼 び 出 し 元 プ ロ セ ス の PGID を 取 得 す る に は POSIX.1 バ ー ジ ョ ン の getpgrp() を 使 う の が 望 ま し い 。 )

System V バ ー ジ ョ ン の setpgrp() は 引 き 数 を 一 つ も と ら ず 、 setpgid(0, 0) と 等 価 で あ る 。

BSD 仕 様 の setpgrp() は pid と pgid を 引 き 数 に と り 、 以 下 を 呼 び 出 す ラ ッ パ ー 関 数 で あ る 。

setpgid(pid, pgid)

glibc 2.19 以 降 、 BSD 固 有 の setpgrp() 関 数 は も は や <unistd.h> で は 公 開 さ れ な い 。 こ の 関 数 の 呼 び 出 し は 上 記 の setpgid() の 呼 び 出 し で 置 き 換 え る べ き で あ る 。

BSD 仕 様 の getpgrp() は pid だ け を 引 き 数 に と り 、 以 下 を 呼 び 出 す ラ ッ パ ー 関 数 で あ る 。

getpgid(pid)

glibc 2.19 以 降 、 BSD 固 有 の getpgrp() 関 数 は も は や <unistd.h> で は 公 開 さ れ な い 。 こ の 関 数 の 呼 び 出 し は 、 引 き 数 を 取 ら な い POSIX.1 の getpgrp() の 呼 び 出 し (呼 び 出 し 元 の PGID を 取 得 す る 目 的 の 場 合 )、 も し く は 上 記 の getpgid() の 呼 び 出 し で 置 き 換 え る べ き で あ る 。

返 り 値

setpgid() と setpgrp() は 成 功 し た 場 合 、 ゼ ロ を 返 す 。 エ ラ ー の 場 合 は −1 を 返 し 、 errno が 適 切 に 設 定 さ れ る 。

POSIX.1 バ ー ジ ョ ン の getpgrp() は 常 に 呼 び 出 し プ ロ セ ス の PGID を 返 す 。

getpgid() と BSD 仕 様 の getpgrp() は 成 功 し た 場 合 プ ロ セ ス グ ル ー プ を 返 す 。 エ ラ ー の 場 合 は −1 を 返 し 、 errno が 適 切 に 設 定 さ れ る 。

エ ラ ー

と し た が 、 す で に そ の 子 プ ロ セ ス は execve(2) を 実 行 し て い た 。 (setpgid(), setpgrp())