Linux Certif

Toute la documentation sur la certification Linux LPI

Rechercher une page de manuel

sethostname

NAZWA

gethostname, sethostname - pobranie/ustawienie nazwy hosta

SK£ADNIA

#include <unistd.h>

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

OPIS

Funkcje te s³u¿± do zmiany nazwy hosta obecnego procesora. Funkcja gethostname() zwraca w tablicy name o d³ugo¶ci len bajtów zakoñczon± znakiem NUL nazwê hosta (ustawion± uprzednio przez sethostname()). W przypadku, gdy zakoñczona znakiem NUL nazwa hosta siê nie mie¶ci, nie jest zwracany b³±d ale nazwa hosta jest obcinana. Nie jest okre¶lone, czy obciêta nazwa hosta bêdzie zakoñczona znakiem NUL.

WARTO¦Æ ZWRACANA

Po pomy¶lnym zakoñczeniu zwracane jest zero. Po b³êdzie zwracane jest -1 i odpowiednio ustawiane jest errno .

B£ÊDY

EINVAL

len jest ujemne, lub dla sethostname, len jest wiêksze od maksymalnej dozwolonej warto¶ci, lub dla gethostname na Linuksie/i386 len jest mniejsze ni¿ w³a¶ciwy rozmiar. (W tym ostatnim przypadku glibc 2.1 zwraca ENAMETOOLONG.)

EPERM

Dla sethostname, wywo³uj±cy nie by³ superu¿ytkownikiem.

EFAULT

name jest nieprawid³owym adresem.

ZGODNE Z

SVr4, 4.4BSD (funkcja pierwotnie pojawi³a siê w 4.2BSD). POSIX 1003.1-2001 definiuje gethostname ale nie sethostname.

USTERKI

Dla wielu kombinacji j±der Linuksa / libc gethostname zwraca b³±d zamiast zwróciæ obciêt± nazwê hosta.

UWAGI

SUSv2 gwarantuje, ¿e `nazwy hostów s± ograniczone do 255 bajtów'. POSIX 1003.1-2001 gwarantuje, ¿e `nazwy hostów (bez koñcz±cego NUL) s± ograniczone do HOST_NAME_MAX bajtów'.

ZOBACZ TAK¯E

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