The OpenNET Project / Index page

[ новости /+++ | форум | wiki | теги | ]

Интерактивная система просмотра системных руководств (man-ов)

 ТемаНаборКатегория 
 
 [Cписок руководств | Печать]

gethostname (2)
  • >> gethostname (2) ( Русские man: Системные вызовы )
  • gethostname (2) ( Linux man: Системные вызовы )
  • gethostname (3) ( Solaris man: Библиотечные вызовы )
  • gethostname (3) ( FreeBSD man: Библиотечные вызовы )
  • gethostname (3) ( POSIX man: Библиотечные вызовы )
  •  

    ИМЯ

    gethostname, sethostname - получить/установить имя машины  

    ОБЗОР

    #include <unistd.h>

    int gethostname(char *name, size_t len);
    int sethostname(const char *name, size_t len);  

    ОПИСАНИЕ

    Эти функции используются для доступа к имени машины или для его изменения. Функция gethostname() возвращает имя машины (которое ранее было установлено вызовом sethostname()) в виде строки name, которая имеет длину len байт и завершается нулевым символом. Если завершающий нулевой символ не встретился в len байтах, то ошибки не будет, но имя машины будет усечено. При этом не факт, что усечённое имя будет завершаться нулевым символом.  

    ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ

    В случае успеха, возвращается 0. При ошибке возвращается -1 и значение errno будет установлено соответствующим образом.  

    ОШИБКИ

    EINVAL
    len имеет отрицательное значение или для sethostname, длина len больше, чем максимально допустимое значение, или для gethostname на Linux/i386, длина len меньше, чем фактический размер. (В это случае glibc 2.1 использует ENAMETOOLONG.)
    EPERM
    Вызвавший sethostname, не является суперпользователем.
    EFAULT
    name является неправильным адресом.
     

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

    SVr4, 4.4BSD (данная функция впервые появилась в 4.2BSD). POSIX 1003.1-2001 определяет gethostname но не sethostname.  

    ОШИБКИ РЕАЛИЗАЦИИ

    Для многих комбинаций ядер Linux / libc функция gethostname будет возвращать ошибку вместо усечённого имени машины.  

    ЗАМЕЧАНИЯ

    SUSv2 гарантирует, что `Длина имени машины ограничивается 255-ми байтами'. POSIX 1003.1-2001 гарантирует, что `Длина имени машины (не включая завершающий нулевой символ) ограничивается HOST_NAME_MAX байтами'.  

    СМОТРИТЕ ТАКЖЕ

    getdomainname(2), setdomainname(2), uname(2)  

    ПЕРЕВОД

    Перевёл с английского Виктор Вислобоков <corochoone@perm.ru> 2003


     

    Index

    ИМЯ
    ОБЗОР
    ОПИСАНИЕ
    ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
    ОШИБКИ
    СООТВЕТСТВИЕ СТАНДАРТАМ
    ОШИБКИ РЕАЛИЗАЦИИ
    ЗАМЕЧАНИЯ
    СМОТРИТЕ ТАКЖЕ
    ПЕРЕВОД


    Поиск по тексту MAN-ов: 




    Спонсоры:
    Inferno Solutions
    Hosting by Hoster.ru
    Хостинг:

    Закладки на сайте
    Проследить за страницей
    Created 1996-2020 by Maxim Chirkov
    Добавить, Поддержать, Вебмастеру