sethostname()

Установить имя текущего узла

Прототип:

#include <unistd.h>
                                       
int sethostname( const char *name, 
                 size_t namelen );

Аргументы:

name: Имя, которое необходимо установить узлу (host машине). Длина имени узла ограничена значением MAXHOSTNAMELEN, определенном в <sys/param.h>.
namelen: Длина имени.

Библиотека:

libc

Описание:

Функция sethostname() устанавливает имя узла в значение name. Данную функцию может вызывать только суперпользователь. Как правило, имя узла устанавливается на этапе загрузки системы.

Данная функция устанавливает значение строки конфигурации _CS_HOSTNAME, а не значение переменной окружения HOSTNAME.

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

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

Коды ошибок:

EFAULT: Параметры name или namelen указывают на некорректный адрес.
EPERM: Вызывающий процесс не имеет прав суперпользователя.

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

Unix

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

Предостережения:

Данная функция доступна только для процесса - суперпользователя и обычно используется только во время загрузки системы.

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

gethostname()

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