setpgid()

Присоединиться к группе процессов или создать группу процессов

Прототип:

#include <process.h>
int setpgid( pid_t pid,
pid_t pgid );

Аргументы:

pid
0, или идентификатор процесса, который будет работать с группой процессов.
pgid
0, или идентификатор группы процессов, к которой необходимо присоединиться или ее создать.

Библиотека:

libc

Описание:

Функция setpgid() используется либо для присоединения к существующей группе процессов, либо для создания новой группу процессов в сеансе вызывающего процесса. Идентификатор группы процессов для лидера сеанса не изменяется.

Принятые определения:

Процесс
Исполняющаяся программа, идентифицируемая неотрицательным целым числом - идентификатором процесса (process ID или PID).
Группа процессов
Набор из одного или нескольких процессов, имеющий уникальный идентификатор - идентификатор группы процессов. Идентификатор группы процессов является положительным целым числом.

В случае успешного завершения, идентификатор группы процессов для процесса PID равным pid устанавливается в значение pgid. Если задать pid или pgid равными нулю, то это будет соответствовать идентификатору вызывающего процесса.

Возвращаемое значение:

0
Успешное завершение.
-1
Возникла ошибка. Код ошибки записан в errno.

Коды ошибок:

EACCES
Параметр pid соответствует идентификатору процесса - потомка для вызывающего процесса, и этот потомок успешно выполнил одну из функций семейства exec*().
EINVAL
Значение параметра pgid меньше нуля.
ENOSYS
Функция setpgid() не поддерживается в текущей реализации (данный тип ошибки включен для соответствия POSIX).
EPERM
Вызывающий процесс не имеет достаточных привилегий для установки идентификатора группы pgid процессу с идентификатором pid.
ESRCH
Процесса с идентификатором pid не существует.

Примеры:

/*
* Процесс присоединяется к группе процессов 0.
*/
#include <stdio.h>
#include <sys/types.h>
#include <unistd.h>
#include <stdlib.h>
#include <process.h>
int main( void )
{
if ( setpgid( getpid(), 0 ) == -1 )
{
perror( "setpgid" );
}
printf( "%d принадлежит к группе процессов %d\n", getpid(), getpgrp() );
return (EXIT_SUCCESS);
}

Классификация:

POSIX 1003.1

Точка остановки потока
Нет
Обработчик прерываний
Нет
Обработчик сигналов
Да
В потоке
Да

Тематические ссылки:

errno, getpgid(), getsid(), setsid()




Предыдущий раздел: Описание API системной библиотеки