.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk)
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\" References consulted:
.\"     Linux libc source code
.\"     Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991)
.\"     386BSD man pages
.\" Modified Sat Jul 24 21:48:06 1993 by Rik Faith (faith@cs.unc.edu)
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH getnetent 3 "2 maja 2024 r." "Linux man\-pages 6.8" 
.SH NAZWA
getnetent, getnetbyname, getnetbyaddr, setnetent, endnetent \- odczytuje wpis
dotyczący sieci
.SH BIBLIOTEKA
Standardowa biblioteka C (\fIlibc\fP, \fI\-lc\fP)
.SH SKŁADNIA
.nf
\fB#include <netdb.h>\fP
.P
\fBstruct netent *getnetent(void);\fP
.P
\fBstruct netent *getnetbyname(const char *\fP\fIname\fP\fB);\fP
\fBstruct netent *getnetbyaddr(uint32_t \fP\fInet\fP\fB, int \fP\fItype\fP\fB);\fP
.P
\fBvoid setnetent(int \fP\fIstayopen\fP\fB);\fP
\fBvoid endnetent(void);\fP
.fi
.SH OPIS
Funkcja \fBgetnetent\fP() odczytuje następny wpis z bazy danych sieci i zwraca
strukturę \fInetent\fP zawierającą pola powstałe z rozłożenia pól
wpisu. Połączenie do bazy danych jest otwierane, jeśli jest to potrzebne.
.P
Funkcja \fBgetnetbyname\fP() zwraca strukturę \fInetent\fP zawierającą ten wpis z
bazy danych, który odpowiada sieci \fIname\fP.
.P
Funkcja \fBgetnetbyaddr\fP() zwraca strukturę \fInetent\fP zawierającą ten wpis z
bazy danych, który odpowiada sieci o numerze \fInet\fP rodzaju
\fItype\fP. Argument \fInet\fP musi być w porządku bajtów lokalnego komputera
(host byte order).
.P
Funkcja \fBsetnetent\fP() otwiera połączenie do bazy danych i ustawia wskaźnik
kolejnego wpisu na pierwszy wpis. Jeśli \fIstayopen\fP jest niezerowy, to
połączenie do bazy danych nie będzie zamykane pomiędzy wywołaniami funkcji
\fBgetnet*\fP().
.P
Funkcja \fBendnetent\fP() zamyka połączenie do bazy danych.
.P
Struktura \fInetent\fP jest zdefiniowana w \fI<netdb.h>\fP następująco:
.P
.in +4n
.EX
struct netent {
    char      *n_name;     /* oficjalna nazwa sieci */
    char     **n_aliases;  /* lista aliasów */
    int        n_addrtype; /* rodzaj adresu sieci */
    uint32_t   n_net;      /* numer sieci */
}
.EE
.in
.P
Polami struktury \fInetent\fP są:
.TP 
\fIn_name\fP
Oficjalna nazwa sieci.
.TP 
\fIn_aliases\fP
Zakończona NULL\-em lista alternatywnych nazw tej sieci.
.TP 
\fIn_addrtype\fP
Rodzaj numeru sieci; zawsze \fBAF_INET\fP.
.TP 
\fIn_net\fP
Numer sieci w porządku bajtów hosta.
.SH "WARTOŚĆ ZWRACANA"
Funkcje \fBgetnetent\fP(), \fBgetnetbyname\fP() i \fBgetnetbyaddr\fP() zwracają
wskaźnik do statycznej struktury \fInetent\fP lub wskaźnik null, gdy wystąpi
błąd lub napotkany zostanie koniec pliku.
.SH PLIKI
.TP 
\fI/etc/networks\fP
plik bazy danych z sieciami
.SH ATRYBUTY
Informacje o pojęciach używanych w tym rozdziale można znaleźć w podręczniku
\fBattributes\fP(7).
.TS
allbox;
lb lb lbx
l l l.
Interfejs	Atrybut	Wartość
T{
.na
.nh
\fBgetnetent\fP()
T}	Bezpieczeństwo wątkowe	T{
.na
.nh
MT\-niebezpieczne race:netent
race:netentbuf env locale
T}
T{
.na
.nh
\fBgetnetbyname\fP()
T}	Bezpieczeństwo wątkowe	T{
.na
.nh
MT\-niebezpieczne race:netbyname
env locale
T}
T{
.na
.nh
\fBgetnetbyaddr\fP()
T}	Bezpieczeństwo wątkowe	T{
.na
.nh
MT\-niebezpieczne race:netbyaddr
locale
T}
T{
.na
.nh
\fBsetnetent\fP(),
\fBendnetent\fP()
T}	Bezpieczeństwo wątkowe	T{
.na
.nh
MT\-niebezpieczne race:netent env
locale
T}
.TE
.P
W powyższej tabeli, \fInetent\fP w \fIrace:netent\fP oznacza, że jeśli któraś z
funkcji \fBsetnetent\fP(), \fBgetnetent\fP() lub \fBendnetent\fP() jest używana
równolegle w różnych wątkach programu, może nastąpić sytuacja wyścigu
danych.
.SH STANDARDY
POSIX.1\-2008.
.SH HISTORIA
POSIX.1\-2001, 4.3BSD.
.P
Przed glibc 2.2, argument \fInet\fP funkcji \fBgetnetbyaddr\fP() był typu \fIlong\fP.
.SH "ZOBACZ TAKŻE"
.\" .BR networks (5)
\fBgetnetent_r\fP(3), \fBgetprotoent\fP(3), \fBgetservent\fP(3)
.br
RFC\ 1101
.PP
.SH TŁUMACZENIE
Autorami polskiego tłumaczenia niniejszej strony podręcznika są:
Andrzej Krzysztofowicz <ankry@green.mf.pg.gda.pl>,
Robert Luberda <robert@debian.org>
i
Michał Kułach <michal.kulach@gmail.com>
.
.PP
Niniejsze tłumaczenie jest wolną dokumentacją. Bliższe informacje o warunkach
licencji można uzyskać zapoznając się z
.UR https://www.gnu.org/licenses/gpl-3.0.html
GNU General Public License w wersji 3
.UE
lub nowszej. Nie przyjmuje się ŻADNEJ ODPOWIEDZIALNOŚCI.
.PP
Błędy w tłumaczeniu strony podręcznika prosimy zgłaszać na adres listy
dyskusyjnej
.MT manpages-pl-list@lists.sourceforge.net
.ME .
