ОБЗОР

#define _BSD_SOURCE /* См. макрос feature_test(7) */
#include <netdb.h>

---

int rexec(char **ahost, int inport, const char *user,
const char *passwd, const char *cmd, int *fd2p);

---

int rexec_af(char **ahost, int inport, const char *user,
const char *passwd, const char *cmd, int *fd2p,
sa_family_t af);

ОПИСАНИЕ

Этот интерфейс устарел, используйте rcmd(3).

Функция rexec() ищет узел *ahost, используя gethostbyname(3), и возвращает -1, если узел не существует. В противном случае, *ahost присваивается стандартное имя узла. Если указаны имя пользователя и пароль, то они используются для аутентификации на другом узле; иначе происходит поиск соответствующей информации в окружении и затем в файле .netrc, находящемся в домашнем каталоге пользователя. Если всё это заканчивается с ошибкой, пользователь извещается об этом.

В inport указывается, какой хорошо известный (well-known) порт DARPA Internet нужно использовать для подключения; вызов getservbyname("exec", "tcp") (смотрите getservent(3)) вернёт указатель на структуру, которая содержит необходимый порт. Протокол подключения подробно описан в rexecd(8).

Если соединение успешно установлено, то вызывающему возвращается сокет в Интернет-домене типа SOCK_STREAM, который для удалённой команды считается stdin и stdout. Если fd2p не равно нулю, то устанавливается вспомогательный канал до управляющего процесса, а его файловый дескриптор будет помещён в *fd2p. Управляющий процесс возвращает диагностический вывод из команды (устройства 2) в этот канал, а также принимает байты из этого канала, считая их номерами сигналов UNIX, для их пересылки группе процессов команды. Возвращаемая диагностическая информация не содержит ошибки удалённой авторизации, так как второе подключение устанавливается после прохождения авторизации. Если fd2p равно 0, то stderr (устройство 2 удалённой команды) будет работать аналогично stdout и для отправки произвольных сигналов в удалённый процесс ничего не будет сделано, хотя вы сможете привлечь к себе внимание, используя внеполосную передачу данных.

rexec_af()

Функция rexec() работает по протоколу IPv4 (AF_INET). В отличие от неё, rexec_af() предоставляет ещё один аргумент, af, который позволяет вызывающему выбрать протокол. В этом аргументе можно указать значения AF_INET, AF_INET6 или AF_UNSPEC (чтобы позволить реализации выбирать протокол).

ВЕРСИИ

Функция rexec_af() впервые появилась в glibc 2.2.

АТРИБУТЫ

Описание терминов данного раздела смотрите в attributes(7).

Интерфейс	Атрибут	Значение
rexec(), rexec_af()	безвредность в нитях	небезопасно (MT-Unsafe)

СООТВЕТСТВИЕ СТАНДАРТАМ

Данные функции отсутствуют в POSIX.1. Функция rexec() впервые появилась в 4.2BSD, и есть в разных BSD, Solaris и других системах. Функция rexec_af() более новая и распространена гораздо меньше.