.\" Copyright 1993 Rickard E. Faith (faith@cs.unc.edu) .\" .\" Updated with additions from Mitchum DSouza .\" Portions Copyright 1993 Mitchum DSouza .\" .\" %%%LICENSE_START(VERBATIM) .\" 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. .\" %%%LICENSE_END .\" .\" Modified Tue Oct 22 00:22:35 EDT 1996 by Eric S. Raymond .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .\" This file is distributed under the same license as original manpage .\" Copyright of the original manpage: .\" Copyright © 1993 David Metcalfe .\" Copyright © of Polish translation: .\" Przemek Borys (PTM) , 1998. .\" Andrzej M. Krzysztofowicz (PTM) , 2002. .\" Robert Luberda , 2017. .TH GETHOSTID 3 2016\-03\-15 Linux "Podręcznik programisty Linuksa" .SH NAZWA gethostid, sethostid \- pobranie lub ustawienie unikatowego identyfikatora obecnej maszyny .SH SKŁADNIA \fB#include \fP .sp \fBlong gethostid(void);\fP .br \fBint sethostid(long \fP\fIhostid\fP\fB);\fP .sp .in -4n Wymagane ustawienia makr biblioteki glibc (patrz \fBfeature_test_macros\fP(7)): .in .sp .ad l .br \fBgethostid\fP(): .RS 4 .\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED _BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 .RE \fBsethostid\fP(): .nf .\" commit 266865c0e7b79d4196e2cc393693463f03c90bd8 Od glibc 2.21: _DEFAULT_SOURCE W glibc 2.19 i 2.20: _DEFAULT_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE\ <\ 500) Do glibc 2.19 włącznie: _BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE\ <\ 500) .fi .ad b .SH OPIS \fBgethostid\fP() oraz \fBsethostid\fP odpowiednio pobiera lub ustawia unikatowy 32\-bitowy identyfikator obecnej maszyny. 32\-bitowy identyfikator powinien być niepowtarzalny wśród wszystkich istniejących systemów uniksowych. Normalnie jest to podobne do adresu internetowego lokalnej maszyny, zwracanego przez \fBgethostbyname\fP(3) i dlatego zwykle nie musi być ustawiane. Wywołanie \fBsethostid\fP() jest zastrzeżone dla superużytkownika. .SH "WARTOŚĆ ZWRACANA" \fBgethostid\fP() zwraca 32\-bitowy identyfikator obecnej maszyny, jaki został ustawiony przez \fBsethostid\fP(). W przypadku powodzenia \fBsethostid\fP() zwraca zero. W razie wystąpienia błędu zwracane jest \-1 i ustawiana jest odpowiednia wartość zmiennej \fIerrno\fP. .SH BŁĘDY \fBsethostid\fP() może zawieść z powodu następujących błędów: .TP \fBEACCES\fP Proces wywołujący nie ma prawa zapisu do pliku używanego do przechowywania identyfikatora bieżącej maszyny. .TP \fBEPERM\fP Efektywny identyfikator użytkownika lub grupy procesu wywołującego nie jest taki sam jak odpowiadający mu identyfikator rzeczywisty. .SH ATRYBUTY Informacje o pojęciach używanych w tym rozdziale można znaleźć w podręczniku \fBattributes\fP(7). .TS allbox; lb lb lbw25 l l l. Interfejs Atrybut Wartość T{ \fBgethostid\fP() T} Bezpieczeństwo wątkowe MT\-Safe hostid env locale T{ \fBsethostid\fP() T} Bezpieczeństwo wątkowe MT\-Unsafe const:hostid .TE .SH "ZGODNE Z" 4.2BSD. Funkcje te porzucono w 4.4BSD. SVr4 zawiera \fBgethostid\fP(), lecz brak tam \fBsethostid\fP(). POSIX.1\-2001 i POSIX.1\-2008 zawiera \fBgethostid\fP(), ale nie \fBsethostid\fP(). .SH UWAGI .\" libc5 used /etc/hostid; libc4 didn't have these functions W implementacji biblioteki glibc \fIhostid\fP jest przechowywane w pliku \fI/etc/hostid\fP. (W wersjach glibc wcześniejszych niż 2.2 był używany plik \fI/var/adm/hostid\fP). W implementacji glibc, jeśli \fBgethostid\fP() nie może otworzyć pliku zawierającego ID maszyny, to pobiera jej nazwę, używając \fBgethostname\fP(2), następnie przekazuje ją do \fBgethostbyname_r\fP(3), aby dostać adres IPv4 komputera, by w końcu zwrócić wartość utworzoną przez pomieszanie bitów adresu IPv4. (Taka wartość może nie być unikatowa). .SH BŁĘDY Nie da się zapewnić, że ten identyfikator jest globalnie niepowtarzalny. .SH "ZOBACZ TAKŻE" \fBhostid\fP(1), \fBgethostbyname\fP(3) .SH "O STRONIE" Angielska wersja tej strony pochodzi z wydania 4.07 projektu Linux \fIman\-pages\fP. Opis projektu, informacje dotyczące zgłaszania błędów można oraz najnowszą wersję oryginału można znaleźć pod adresem \%https://www.kernel.org/doc/man\-pages/. .SH TŁUMACZENIE Autorami polskiego tłumaczenia niniejszej strony podręcznika man są: Przemek Borys (PTM) , Andrzej M. Krzysztofowicz (PTM) i Robert Luberda . .PP Polskie tłumaczenie jest częścią projektu manpages-pl; uwagi, pomoc, zgłaszanie błędów na stronie http://sourceforge.net/projects/manpages-pl/. Jest zgodne z wersją \fB 4.07 \fPoryginału.