MAN gethostname 2

Материал из Gentoo Linux Wiki

Вернуться в раздел мануалов

[править] Имя

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

[править] Комментарии к man файлу

Hey Emacs! This file is -*- nroff -*- source.

Copyright 1993 Rickard E. Faith (faith@cs.unc.edu)

Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
preserved on all copies.

Permission is granted to copy and distribute modified versions of this
manual under the conditions for verbatim copying, provided that the
entire resulting derived work is distributed under the terms of a
permission notice identical to this one

Since the Linux kernel and libraries are constantly changing, this
manual page may be incorrect or out-of-date. The author(s) assume no
responsibility for errors or omissions, or for damages resulting from
the use of the information contained herein. The author(s) may not
have taken the same level of care in the production of this manual,
which is licensed free of charge, as they might when working
professionally.

Formatted or processed versions of this manual, if unaccompanied by
the source, must acknowledge the copyright and authors of this work.

Modified 22 July 1995 by Michael Chastain <mec@duracef.shout.net>:
'gethostname' is real system call on Linux/Alpha.
Modified Fri Jan 31 16:30:53 1997 by Eric S. Raymond <esr@thyrsus.com>
Modified 2000-06-04, 2001-12-15 by aeb

Дата последней коррекции перевода 03.01.2004
Перевод с английского сделал Виктор Вислобоков <corochoone@perm.ru>
http://www.linuxshare.ru/projects/trans/mans.html