sethostname()

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

Прототип:

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

Аргументы:

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

Библиотека:

libc

Описание:

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


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

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

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

Коды ошибок:

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

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

Unix

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

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

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

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

gethostname()




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