Все эти функции возвращают

в случае ошибки и — в случае успеха, если только не указано иначе. Большинство их прототипов находятся в . Те, что расположены где-то еще, отмечены ниже.

int setreuid(uid_t ruid, uid_t euid);	Устанавливает действительный uid текущего процесса в ruid и эффективный uid процесса в euid . Если оба параметра равны – 1 , то uid остаются неизменными.
int setregid(gid_t rgid, gid_t egid);	Устанавливает действительный gid текущего процесса в rgid и эффективный gid процесса в egid. Если оба параметра равны – 1 , то gid остаются неизменными.
int setuid(uid t uid);	Если применяется обычным пользователем, то устанавливает эффективный uid текущего процесса в значение параметра uid . Если используется процессом с эффективным uid, равным 0, то устанавливает действительный, эффективный и сохраненный uid в значение параметра uid .
int setgid(gid_t gid);	Если применяется обычным пользователем, то устанавливает эффективный gid текущего процесса в значение параметра gid . Если используется процессом с эффективным gid, равным 0, то устанавливает действительный, эффективный и сохраненный gid в значение параметра gid .
int seteuid(uid_t uid);	Эквивалент setreuid(-1, uid) .
int setegid(gid_t gid);	Эквивалент setregid(-1, gid) .
int setfsuid(uid_t fsuid);	Устанавливает fsuid текущего процесса в значение параметра fsuid . Прототип находится в <sys/fsuid.h> . Возвращает предшествующий fsuid.
int setfsgid(gid_t fsgid);	Устанавливает fsgid текущего процесса в значение параметра fsgid . Прототип находится в <sys/fsuid.h> . Возвращает предшествующий fsgid.
int setgroups(size_t num, const gid_t * list);	Устанавливает дополнительные группы текущего процесса из списка, переданного в массиве list , который должен содержать num элементов. Макрос SC_NGROUPS_MAX указывает, сколько групп может быть в списке (от 32 до 65536, в зависимости от работающей у вас версии Linux).
uid_t getuid;	Возвращает действительный uid процесса.
uid_t geteuid;	Возвращает эффективный uid процесса.
gid_t getgid;	Возвращает действительный gid процесса.
gid_t getegid;	Возвращает эффективный gid процесса.
size_t getgroups (size_t size, gid_t list[]);	Возвращает текущий набор дополнительных групп процесса в массиве list . Параметр size сообщает, сколько элементов типа gid_t может содержать list . Если размер list недостаточен, чтобы вместить все группы, возвращается – 1 , а errno устанавливается в EINVAL . В противном случае возвращается фактическое количество групп в list . Если size равен 0 , возвращается количество групп, но list не затрагивается. Прототип функции getgroups находится в <grp.h> .

Ядро предоставляет значительное количество информации о каждом процессе и часть ее передается новым программам во время их загрузки. Вся эта информация образует среду выполнения для процесса.

Есть два типа значений, передаваемых новым программам при их запуске: аргументы командной строки и переменные окружения. Для их использования установлено множество соглашений, но система сама по себе не придерживается их автоматически. Однако хорошим тоном считается придерживаться этих соглашений, чтобы помочь вашим программам попасть в мир Unix.

Аргументы командной строки — это набор строк, передаваемый программе. Обычно они представляют собой текст, набранный вслед за именем команды в оболочке, с необязательными аргументами, начинающимися с символа "минус"

).

Переменные окружения — это набор пар "имя-значение". Каждая пара представляет отдельную строку в форме

, и набор таких строк образует окружение (environment) программы. Например, домашний каталог текущего пользователя обычно указан в переменной окружения HOME, поэтому программы, скажем, пользователя Joe часто запускаются, имея в своем окружении .

И аргументы, и окружение становятся доступными программе при запуске. Аргументы командной строки передаются в виде параметров главной функции программы —

, в то время как указатель на окружение помещается в глобальную переменную , которая определена в [18] .

Ниже представлен полный прототип функции

в мире Linux, Unix и языка ANSI/ISO С.

Возможно, вас удивит, что

возвращает значение (отличное от ). Это значение, возвращаемое функцией main, передается родительскому процессу после завершения данного. По соглашению 0 означает, что процесс завершен успешно, а ненулевое значение означает возникновение сбоя. При этом принимаются во внимание только младшие 8 бит из этого кода возврата. Отрицательные значения от -1 до -128 зарезервированы для ненормального завершения процессов по инициативе другого процесса или ядра системы. Код выхода 0 сигнализирует об успешном завершении, а значения от 1 до 127 говорят о том, что программа завершена по ошибке.

Первый параметр,

, содержит количество аргументов командной строки, переданных программе, тогда как — массив указателей на строки — хранит сами аргументы. Первый элемент в массиве, , содержит имя вызванной программы (хотя и не обязательно полный путь к ней). В элементе расположен указатель на завершающий аргумент командной строки, а содержит .

Чтобы получить прямой доступ к окружению, используйте следующую глобальную переменную:

Это представляет

как массив указателей на каждый элемент программного окружения (помните, каждый элемент — это пара ), и финальный элемент массива содержит . Это объявление находится в , поэтому вам не обязательно объявлять его самостоятельно.

Наиболее общий способ проверки элементов окружения — это вызов

, который исключает непосредственное обращение к переменной .

Единственный параметр

— это имя переменной окружения, значение которой интересует. Если переменная существует, вернет указатель на ее значение. Если переменная не существует в текущем окружении (то есть окружении, на которое указывает ), функция вернет .

Linux предоставляет два способа добавления строк в программное окружение:

и . POSIX определяет только , что делает его более переносимым.