.\" -*- 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 19:19:11 1993 by Rik Faith (faith@cs.unc.edu)
.\" Modified Wed Oct 18 20:23:54 1995 by Martin Schulze <joey@infodrom.north.de>
.\" Modified Mon Apr 22 01:50:54 1996 by Martin Schulze <joey@infodrom.north.de>
.\" 2001-07-25 added a clause about NULL proto (Martin Michlmayr or David N. Welton)
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH getservent 3 "20. Juli 2023" "Linux man\-pages 6.05.01" 
.SH BEZEICHNUNG
getservent, getservbyname, getservbyport, setservent, endservent \- bestimmt
dienstspezifischen Datenbankeintrag
.SH BIBLIOTHEK
Standard\-C\-Bibliothek (\fIlibc\fP, \fI\-lc\fP)
.SH ÜBERSICHT
.nf
\fB#include <netdb.h>\fP
.PP
\fBstruct servent *getservent(void);\fP
.PP
\fBstruct servent *getservbyname(const char *\fP\fIname\fP\fB, const char *\fP\fIproto\fP\fB);\fP
\fBstruct servent *getservbyport(int \fP\fIport\fP\fB, const char *\fP\fIproto\fP\fB);\fP
.PP
\fBvoid setservent(int \fP\fIoffenhalten\fP\fB);\fP
\fBvoid endservent(void);\fP
.fi
.SH BESCHREIBUNG
Die Funktion \fBgetservent\fP() liest den nächsten Eintrag aus der
Dienste\-Datenbank (Services Database, siehe \fBservices\fP(5)) und gibt eine
Struktur \fIservent\fP zurück, welche die Felder des Eintrags enthält. Wenn
notwendig, wird eine Verbindung zur Datenbank hergestellt.
.PP
Die Funktion \fBgetservbyname\fP() gibt eine Struktur \fIservent\fP mit dem
Datenbank\-Eintrag für den Dienst \fIname\fP zurück, der das Protokoll \fIproto\fP
benutzt. Falls \fIproto\fP NULL ist, passt es auf jedes Protokoll. Wenn
notwendig, wird eine Verbindung zur Datenbank hergestellt.
.PP
Die Funktion \fBgetservbyport\fP() gibt eine Struktur \fIservent\fP mit dem
Datenbank\-Eintrag für das Protokoll \fIproto\fP auf dem \fIport\fP zurück. (Der
Port ist in Netzwerk\-Byte\-Ordnung angegeben). Falls \fIproto\fP NULL ist, passt
es auf jedes Protokoll. Wenn notwendig, wird eine Verbindung zur Datenbank
hergestellt.
.PP
Die Funktion \fBsetservent\fP() baut eine Datenbankverbindung auf und zeigt auf
deren ersten Eintrag. Wenn \fIoffenhalten\fP ungleich Null ist, wird die
Verbindung zwischen Aufrufen der \fBgetserv*\fP()\-Funktionen nicht geschlossen.
.PP
Die Funktion \fBendservent\fP() beendet die Datenbankverbindung.
.PP
Die Struktur \fIservent\fP ist in \fI<netdb.h>\fP wie folgt definiert:
.PP
.in +4n
.EX
struct servent {
    char  *s_name;       /* offizieller Dienstname */
    char **s_aliases;    /* Aliasliste */
    int    s_port;       /* Portnummer */
    char  *s_proto;      /* zu benutzendes Protokoll */
}
.EE
.in
.PP
Die Struktur \fIservent\fP besteht aus den folgenden Elementen:
.TP 
\fIs_name\fP
der offizielle Name der Dienstes
.TP 
\fIs_aliases\fP
eine mit Nullzeiger abgeschlossene Liste von alternativen Namen für den
Dienst
.TP 
\fIs_port\fP
die Portnummer des Dienstes (in Netzwerk\-Byte\-Ordnung)
.TP 
\fIs_proto\fP
Das Protokoll, das mit diesem Dienst anzuwenden ist.
.SH RÜCKGABEWERT
Die Funktionen \fBgetservent\fP(), \fBgetservbyname\fP() und \fBgetservbyport\fP()
geben einen Zeiger auf eine statisch zugewiesene Struktur \fIservent\fP
zurück. Tritt ein Fehler auf oder ist das Dateiende erreicht, wird NULL
zurückgegeben.
.SH DATEIEN
.TP 
\fI/etc/services\fP
Dienste\-Datenbankdatei
.SH ATTRIBUTE
Siehe \fBattributes\fP(7) für eine Erläuterung der in diesem Abschnitt
verwandten Ausdrücke.
.TS
allbox;
lb lb lbx
l l l.
Schnittstelle	Attribut	Wert
T{
.na
.nh
\fBgetservent\fP()
T}	Multithread\-Fähigkeit	T{
.na
.nh
MT\-Unsicher race:servent
race:serventbuf locale
T}
T{
.na
.nh
\fBgetservbyname\fP()
T}	Multithread\-Fähigkeit	T{
.na
.nh
MT\-Unsicher race:servbyname
locale
T}
T{
.na
.nh
\fBgetservbyport\fP()
T}	Multithread\-Fähigkeit	T{
.na
.nh
MT\-Unsicher race:servbyport
locale
T}
T{
.na
.nh
\fBsetservent\fP(),
\fBendservent\fP()
T}	Multithread\-Fähigkeit	T{
.na
.nh
MT\-Unsicher race:servent
locale
T}
.TE
.sp 1
In der obigen Tabelle bedeutet \fIservent\fP in \fIrace:servent\fP, dass, falls
eine der Funktionen \fBsetservent\fP(), \fBgetservent\fP() oder \fBendservent\fP() in
verschiedenen Threads eines Programms parallel verwandt werden,
konkurrierende Zugriffe auf Daten (»data races«) auftreten könnten.
.SH STANDARDS
POSIX.1\-2008.
.SH GESCHICHTE
POSIX.1\-2001, 4.3BSD.
.SH "SIEHE AUCH"
\fBgetnetent\fP(3), \fBgetprotoent\fP(3), \fBgetservent_r\fP(3), \fBservices\fP(5)
.PP
.SH ÜBERSETZUNG
Die deutsche Übersetzung dieser Handbuchseite wurde von
Patrick Rother <krd@gulu.net>,
Martin Eberhard Schauer <Martin.E.Schauer@gmx.de>
und
Dr. Tobias Quathamer <toddy@debian.org>
erstellt.
.PP
Diese Übersetzung ist Freie Dokumentation; lesen Sie die
.UR https://www.gnu.org/licenses/gpl-3.0.html
GNU General Public License Version 3
.UE
oder neuer bezüglich der
Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.
.PP
Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden,
schicken Sie bitte eine E-Mail an die
.MT debian-l10n-german@lists.debian.org
Mailingliste der Übersetzer
.ME .