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¶
Uwaga! To tłumaczenie może być nieaktualne!
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)
Powyższe tłumaczenie pochodzi z nieistniejącego już
Projektu Tłumaczenia Manuali i
może nie być
aktualne. W razie zauważenia różnic między
powyższym opisem a rzeczywistym zachowaniem opisywanego programu lub
funkcji, prosimy o zapoznanie się z oryginalną
(angielską) wersją strony podręcznika za pomocą
polecenia:
- man --locale=C 2 gethostname
Prosimy o pomoc w aktualizacji stron man - więcej informacji można
znaleźć pod adresem
http://sourceforge.net/projects/manpages-pl/.