manpages-de - en to de translation catalogue (74 entries)

note: type: TH
en: 2017-09-15
de: 15. September 2017

note: type: TH
en: Linux Programmer's Manual
de: Linux-Programmierhandbuch

note: type: SH
en: NAME
de: BEZEICHNUNG

note: type: Plain text
en: gethostbyname, gethostbyaddr, sethostent, gethostent, endhostent, h_errno, herror, hstrerror, gethostbyaddr_r, gethostbyname2, gethostbyname2_r, gethostbyname_r, gethostent_r - get network host entry
de: gethostbyname, gethostbyaddr, sethostent, gethostent, endhostent, h_errno, herror, hstrerror, gethostbyaddr_r, gethostbyname2, gethostbyname2_r, gethostbyname_r, gethostent_r - ermittelt den Netzwerkeintrag für einen Host

note: type: SH
en: SYNOPSIS
de: ÜBERSICHT

note: type: Plain text
en: B<#include E<lt>sys/socket.hE<gt>>       /* for AF_INET */
    B<struct hostent *gethostbyaddr(const void *>I<addr>B<,>
    B<                              socklen_t >I<len>B<, int >I<type>B<);>
de: B<#include E<lt>sys/socket.hE<gt>>       /* für AF_INET */
    B<struct hostent *gethostbyaddr(const void *>I<addr>B<,>
    B<                              socklen_t >I<len>B<, int >I<type>B<);>

note: type: Plain text
en: /* System V/POSIX extension */
    B<struct hostent *gethostent(void);>
de: /* System V-/POSIX-Erweiterung */
    B<struct hostent *gethostent(void);>

note: type: Plain text
en: /* GNU extensions */
    B<struct hostent *gethostbyname2(const char *>I<name>B<, int >I<af>B<);>
de: /* GNU-Erweiterungen */
    B<struct hostent *gethostbyname2(const char *>I<name>B<, int >I<af>B<);>

note: type: Plain text
en: Feature Test Macro Requirements for glibc (see B<feature_test_macros>(7)):
de: Mit Glibc erforderliche Makros (siehe B<feature_test_macros>(7)):

note: type: TP
en: Since glibc 2.19:
de: Seit Glibc 2.19:

note: type: TP
en: Glibc versions up to and including 2.19:
de: Glibc-Versionen bis einschließlich 2.19:

note: type: TP
en: Glibc 2.8 to 2.19:
de: Glibc 2.8 bis 2.19:

note: type: TP
en: Before glibc 2.8:
de: Vor Glibc 2.8:

note: type: TP
en: Since glibc 2.19
de: Seit Glibc 2.19:

note: type: TP
en: Glibc 2.12 to 2.19:
de: Glibc 2.12 bis 2.19:

note: type: TP
en: Before glibc 2.12:
de: Vor Glibc 2.12:

note: type: SH
en: DESCRIPTION
de: BESCHREIBUNG

note: type: Plain text
en: The B<gethostbyname*>(), B<gethostbyaddr*>(), B<herror>(), and B<hstrerror>()  functions are obsolete.  Applications should use B<getaddrinfo>(3), B<getnameinfo>(3), and B<gai_strerror>(3)  instead.
de: Die Funktionen B<gethostbyname*>(), B<gethostbyaddr*>(), B<herror>() und B<hstrerror>() sind veraltet. Anwendungen sollten stattdessen B<getaddrinfo>(3), B<getnameinfo>(3) und B<gai_strerror>(3) verwenden.

note: type: Plain text
en: The B<gethostbyname>()  function returns a structure of type I<hostent> for the given host I<name>.  Here I<name> is either a hostname or an IPv4 address in standard dot notation (as for B<inet_addr>(3)).  If I<name> is an IPv4 address, no lookup is performed and B<gethostbyname>()  simply copies I<name> into the I<h_name> field and its I<struct in_addr> equivalent into the I<h_addr_list[0]> field of the returned I<hostent> structure.  If I<name> doesn't end in a dot and the environment variable B<HOSTALIASES> is set, the alias file pointed to by B<HOSTALIASES> will first be searched for I<name> (see B<hostname>(7)  for the file format).  The current domain and its parents are searched unless I<name> ends in a dot.
de: Die Funktion B<gethostbyname>() gibt eine Struktur vom Typ I<hostent> für den angegebenen Host I<name> zurück. Darin ist I<name> entweder ein Host-Name oder eine IPv4-Adresse in der Standard-Punktnotation. Falls I<name> eine IPv4-Adresse ist, wird nicht gesucht und B<gethostbyname>() kopiert einfach nur den I<name>n und dessen I<struct in_addr>-Äquivalent in das Feld I<h_addr_list[0]> der zurückgegebenen I<hostent>-Struktur. Falls I<name> nicht mit einem Punkt endet und die Umgebungsvariable B<HOSTALIASES> gesetzt ist, wird zuerst die von I<HOSTALIASES> bestimmte Aliasdatei nach dem I<name>n durchsucht (siehe B<hostname>(7) für das Dateiformat). Falls der I<name> nicht mit einem Punkt endet, werden die aktuelle Domain und ihre übergeordneten Domains durchsucht.

note: type: Plain text
en: The B<gethostbyaddr>()  function returns a structure of type I<hostent> for the given host address I<addr> of length I<len> and address type I<type>.  Valid address types are B<AF_INET> and B<AF_INET6>.  The host address argument is a pointer to a struct of a type depending on the address type, for example a I<struct in_addr *> (probably obtained via a call to B<inet_addr>(3))  for address type B<AF_INET>.
de: Die Funktion B<gethostbyaddr>() gibt für die angegebene Adresse I<addr> eine Struktur vom Typ I<hostent> mit der Länge I<len> und dem Adresstyp I<type> zurück. Mögliche Adresstypen sind B<AF_INET> und B<AF_INET6>. Das Argument I<addr> ist ein Zeiger auf eine Struktur, die vom Adresstyp abhängt, beispielsweise eine I<struct in_addr *> (möglicherweise ermittelt durch einen Aufruf von B<inet_addr>(3)) für den Adresstyp B<AF_INET>.

note: type: Plain text
en: The B<sethostent>()  function specifies, if I<stayopen> is true (1), that a connected TCP socket should be used for the name server queries and that the connection should remain open during successive queries.  Otherwise, name server queries will use UDP datagrams.
de: Falls I<stayopen> wahr (B<true>(1)) ist, legt die Funktion B<sethostent>() fest, dass eine bestehende TCP-Verbindung für Nameserveranfragen genutzt werden soll und dass die Verbindung für die nachfolgenden Anfragen bestehen bleiben soll. Ansonsten werden für Nameserveranfragen UDP-Datagramme benutzt.

note: type: Plain text
en: The B<endhostent>()  function ends the use of a TCP connection for name server queries.
de: Die Funktion B<endhostent>() beendet die Nutzung einer TCP-Verbindung für Namerserveranfragen.

note: type: Plain text
en: The (obsolete)  B<herror>()  function prints the error message associated with the current value of I<h_errno> on I<stderr>.
de: Die (veraltete) Funktion B<herror>() gibt die zum aktuellen Wert von I<h_errno> gehörende Fehlermeldung auf I<stderr> aus.

note: type: Plain text
en: The (obsolete)  B<hstrerror>()  function takes an error number (typically I<h_errno>) and returns the corresponding message string.
de: Die (veraltete) Funktion B<hstrerror>() ermittelt zu einer Fehlernummer (normalerweise I<h_errno>) die zugehörige Zeichenkette mit der Fehlermeldung.

note: type: Plain text
en: The domain name queries carried out by B<gethostbyname>()  and B<gethostbyaddr>()  rely on the Name Service Switch (B<nsswitch.conf>(5))  configured sources or a local name server (B<named>(8)).  The default action is to query the Name Service Switch (B<nsswitch.conf(5))> configured sources, failing that, a local name server (B<named>(8)).
de: Die durch B<gethostbyname>() und B<gethostbyaddr>() durchgeführten Domain-Name-Abfragen verlassen sich auf die konfigurierten Quellen des »Name Service Switch« (B<nsswitch.conf>(5)) oder einen lokalen Name-Server (B<named>(8)). Standardmäßig werden die Quellen des »Name Service Switch« (B<nsswitch.conf(5)>) abgefragt und, falls das fehlschlägt, der lokale Name-Server (B<named>(8)).

note: type: SS
en: Historical
de: Geschichtliches

note: type: Plain text
en: The B<nsswitch.conf>(5)  file is the modern way of controlling the order of host lookups.
de: Die Datei B<nsswitch.conf>(5) ist die moderne Art, um die Reihenfolge der Rechnerermittlungen zu steuern.

note: type: Plain text
en: In glibc 2.4 and earlier, the I<order> keyword was used to control the order of host lookups as defined in I</etc/host.conf> (B<host.conf>(5)).
de: In Glibc 2.4 und älter wurde das Schlüsselwort I<order> verwandt, um die Reihenfolge der Rechnerermittlungen, wie sie in I</etc/host.conf> (B<host.conf>(5)) definiert sind, zu steuern.

note: type: Plain text
en: The I<hostent> structure is defined in I<E<lt>netdb.hE<gt>> as follows:
de: Die Struktur I<hostent> ist in I<E<lt>netdb.hE<gt>> wie folgt definiert:

note: type: Plain text
en: struct hostent {
        char  *h_name;            /* official name of host */
        char **h_aliases;         /* alias list */
        int    h_addrtype;        /* host address type */
        int    h_length;          /* length of address */
        char **h_addr_list;       /* list of addresses */
    }
    #define h_addr h_addr_list[0] /* for backward compatibility */
de: struct hostent {
        char  *h_name;            /* offizieller Name des Rechners */
        char **h_aliases;         /* Aliasliste */
        int    h_addrtype;        /* Host-Adresstyp */
        int    h_length;          /* Länge der Adresse */
        char **h_addr_list;       /* Adressliste */
    }
    #define h_addr h_addr_list[0] /* für Abwärtskompatibilität */

note: type: Plain text
en: The members of the I<hostent> structure are:
de: Die Elemente der I<hostent>-Struktur sind:

note: type: Plain text
en: The official name of the host.
de: der offizielle Name des Rechners

note: type: Plain text
en: An array of alternative names for the host, terminated by a null pointer.
de: Ein Feld mit den alternativen Namen des Rechners, gefolgt von einem NULL-Zeiger.

note: type: Plain text
en: The type of address; always B<AF_INET> or B<AF_INET6> at present.
de: der Adresstyp, z.Zt. immer B<AF_INET> oder B<AF_INET6>

note: type: Plain text
en: The length of the address in bytes.
de: die Länge der Adresse in Bytes

note: type: Plain text
en: An array of pointers to network addresses for the host (in network byte order), terminated by a null pointer.
de: ein Feld von Zeigern auf Netzwerkadressen für den Rechner (in der Netzwerk-Bytereihenfolge), gefolgt von einem Null-Zeiger

note: type: Plain text
en: The first address in I<h_addr_list> for backward compatibility.
de: die erste Adresse in I<h_addr_list>, für Abwärtskompatibilität

note: type: SH
en: RETURN VALUE
de: RÜCKGABEWERT

note: type: Plain text
en: The B<gethostbyname>()  and B<gethostbyaddr>()  functions return the I<hostent> structure or a null pointer if an error occurs.  On error, the I<h_errno> variable holds an error number.  When non-NULL, the return value may point at static data, see the notes below.
de: Die Funktionen B<gethostbyname>() und B<gethostbyaddr>() geben eine I<hostent>-Struktur zurück. Bei einem Fehler wird ein Null-Zeiger zurückgegeben. In diesem Fall enthält die Variable I<h_errno> die Fehlernummer. Falls der Zeiger von NULL verschieden ist, kann der Rückgabewert auf statische Daten weisen; siehe die folgenden Anmerkungen.

note: type: SH
en: ERRORS
de: FEHLER

note: type: Plain text
en: The variable I<h_errno> can have the following values:
de: Die Variable I<h_errno> kann folgende Werte annehmen:

note: type: Plain text
en: The specified host is unknown.
de: Der angegebene Rechner ist unbekannt.

note: type: Plain text
en: The requested name is valid but does not have an IP address.  Another type of request to the name server for this domain may return an answer.  The constant B<NO_ADDRESS> is a synonym for B<NO_DATA>.
de: Der angeforderte Name ist gültig aber verfügt über keine IP-Adresse. Ein anderer Anfragetyp beim Nameserver für diese Domain könnte eine Antwort liefern. Die Konstante B<NO_ADDRESS> ist ein Synonym für B<NO_DATA>.

note: type: Plain text
en: A nonrecoverable name server error occurred.
de: Ein nichtbehebbarer Nameserverfehler ist aufgetreten.

note: type: Plain text
en: A temporary error occurred on an authoritative name server.  Try again later.
de: Beim maßgebenden Nameserver ist ein vorübergehender Fehler aufgetreten. Versuchen Sie es später noch einmal.

note: type: SH
en: FILES
de: DATEIEN

note: type: Plain text
en: resolver configuration file
de: Konfigurationsdatei des Resolvers (Namensauflöser)

note: type: Plain text
en: host database file
de: Host-Datenbankdatei

note: type: Plain text
en: name service switch configuration
de: Konfigurationsdatei für »name service switch«

note: type: SH
en: ATTRIBUTES
de: ATTRIBUTE

note: type: Plain text
en: For an explanation of the terms used in this section, see B<attributes>(7).
de: Siehe B<attributes>(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke.

note: type: tbl table
en: Interface
de: Schnittstelle

note: type: tbl table
en: Attribute
de: Attribut

note: type: tbl table
en: Value
de: Wert

note: type: tbl table
en: Thread safety
de: Multithread-Fähigkeit

note: type: Plain text
en: In the above table, I<hostent> in I<race:hostent> signifies that if any of the functions B<sethostent>(), B<gethostent>(), B<gethostent_r>(), or B<endhostent>()  are used in parallel in different threads of a program, then data races could occur.
de: In der obigen Tabelle bedeutet I<hostent> in I<race:hostent>, dass, falls eine der Funktionen B<sethostent>(), B<gethostent>(), B<gethostent_r>() oder B<endhostent>() in verschiedenen Threads eines Programms parallel verwandt werden, konkurrierende Zugriffe auf Daten (»data races«) auftreten könnten.

note: type: SH
en: CONFORMING TO
de: KONFORM ZU

note: type: Plain text
en: POSIX.1-2001 specifies B<gethostbyname>(), B<gethostbyaddr>(), B<sethostent>(), B<endhostent>(), B<gethostent>(), and I<h_errno>; B<gethostbyname>(), B<gethostbyaddr>(), and I<h_errno> are marked obsolescent in that standard.  POSIX.1-2008 removes the specifications of B<gethostbyname>(), B<gethostbyaddr>(), and I<h_errno>, recommending the use of B<getaddrinfo>(3)  and B<getnameinfo>(3)  instead.
de: POSIX.1-2001 beschreibt B<gethostbyname>(), B<gethostbyaddr>(), B<sethostent>(), B<endhostent>(), B<gethostent>() und I<h_errno>; B<gethostbyname>(), B<gethostbyaddr>() und I<h_errno> sind in diesem Standard als allmählich außer Dienst stellend gekennzeichnet. POSIX.1-2008 entfernt die Beschreibungen von B<gethostbyname>(), B<gethostbyaddr>() nd I<h_errno> und empfiehlt stattdessen die Verwendung von B<getaddrinfo>(3) und B<getnameinfo>(3).

note: type: SH
en: NOTES
de: ANMERKUNGEN

note: type: Plain text
en: The functions B<gethostbyname>()  and B<gethostbyaddr>()  may return pointers to static data, which may be overwritten by later calls.  Copying the I<struct hostent> does not suffice, since it contains pointers; a deep copy is required.
de: Die Funktionen B<gethostbyname>() und B<gethostbyaddr>() können Zeiger auf statische Daten zurückgeben, welche bei späteren Aufrufen überschrieben werden könnten. Das Kopieren von I<struct hostent> ist nicht ausreichend, weil sie Zeiger enthält. Eine tiefe Kopie ist erforderlich.

note: type: Plain text
en: In the original BSD implementation the I<len> argument of B<gethostbyname>()  was an I<int>.  The SUSv2 standard is buggy and declares the I<len> argument of B<gethostbyaddr>()  to be of type I<size_t>.  (That is wrong, because it has to be I<int>, and I<size_t> is not.  POSIX.1-2001 makes it I<socklen_t>, which is OK.)  See also B<accept>(2).
de: In der ursprünglichen BSD-Implementierung von B<gethostbyname>() war das Argument  I<len> ein I<int>. Der Standard SUSv2 ist fehlerhaft und weist dem Argument I<len> von B<gethostbyaddr>() den Typ I<size_t> zu. (Das ist falsch, weil es I<int> sein muss und das für I<size_t> nicht der Fall ist. POSIX.1-2001 macht es zuI<socklen_t>, was in Ordnung ist.) Siehe auch B<accept>(2).

note: type: Plain text
en: The BSD prototype for B<gethostbyaddr>()  uses I<const char\ *> for the first argument.
de: Der BSD-Prototyp für B<gethostbyaddr>() verwendet I<const char\ *> als Datentyp für das erste Argument.

note: type: SS
en: System V/POSIX extension
de: System V/POSIX-Erweiterung

note: e.g., Linux, FreeBSD, UnixWare, HP-UX e.g., FreeBSD, AIX type: Plain text
en: POSIX requires the B<gethostent>()  call, which should return the next entry in the host data base.  When using DNS/BIND this does not make much sense, but it may be reasonable if the host data base is a file that can be read line by line.  On many systems, a routine of this name reads from the file I</etc/hosts>.  It may be available only when the library was built without DNS support.  The glibc version will ignore ipv6 entries.  This function is not reentrant, and glibc adds a reentrant version B<gethostent_r>().
de: POSIX verlangt die Existenz der Funktion B<gethostent>(), die den nächsten Eintrag in der Host-Datenbank zurückgeben sollte. Bei der Verwendung von DNS/BIND ergibt das nicht viel Sinn, aber es kann sinnvoll sein, wenn die Host-Datenbank eine Datei ist, die Zeile für Zeile gelesen werden kann. Auf vielen Systemen liest eine Routine mit diesem Namen aus der Datei I</etc/hosts>. Es kann sein, dass sie nur verfügbar ist, wenn die Bibliothek ohne DNS-Unterstützung gebaut wurde. Die Glibc-Version ignoriert Ipv6-Einträge. Diese Funktion ist nicht ablaufinvariant. Glibc stellt die ablaufinvariante Version B<gethostent_r>() bereit.

note: type: SS
en: GNU extensions
de: GNU-Erweiterungen

note: type: Plain text
en: Glibc2 also has a B<gethostbyname2>()  that works like B<gethostbyname>(), but permits to specify the address family to which the address must belong.
de: Glibc2 enthält auch B<gethostbyname2>(), welche wie B<gethostbyname>() arbeitet, ermöglicht aber die Vorgabe der Adressfamilie, zu der die Adresse gehören muss.but permits to specify the address family to which the address must belong.

note: type: Plain text
en: Glibc2 also has reentrant versions B<gethostent_r>(), B<gethostbyaddr_r>(), B<gethostbyname_r>()  and B<gethostbyname2_r>().  The caller supplies a I<hostent> structure I<ret> which will be filled in on success, and a temporary work buffer I<buf> of size I<buflen>.  After the call, I<result> will point to the result on success.  In case of an error or if no entry is found I<result> will be NULL.  The functions return 0 on success and a nonzero error number on failure.  In addition to the errors returned by the nonreentrant versions of these functions, if I<buf> is too small, the functions will return B<ERANGE>, and the call should be retried with a larger buffer.  The global variable I<h_errno> is not modified, but the address of a variable in which to store error numbers is passed in I<h_errnop>.
de: Glibc2 hat auch ablaufinvariante Versionen von B<gethostent_r>(), B<gethostbyaddr_r>(), B<gethostbyname_r>() und B<gethostbyname2_r>(). Der Aufrufende stellte eine I<hostent>-Struktur I<ret>, die bei Erfolg ausgefüllt wird, und einen temporären Arbeitspuffer I<buf> der Größe I<buflen> bereits. Nach dem Aufruf zeigt bei Erfolg I<result> auf das Ergebnis. Im Falle eines Fehlers oder wenn kein Eintrag gefunden wird, ist I<result> NULL. Die Funktionen liefern 0 bei Erfolg und bei einem Fehler eine von Null verschiedene Fehlernummer. Zusätzlich zu den Fehlern, die von den nicht ablaufinvarianten Versionen dieser Funktionen zurückgegeben werden:Diese Funktionen melden B<ERANGE>, falls I<buf> zu klein war. In diesem Fall sollte der Aufruf mit einem größeren Puffer wiederholt werden. Die globale Variable I<h_errno> wird nicht verändert, sondern die Adresse einer Variablen zur Speicherung von Fehlernummern wird in I<h_errnop> übergeben.

note: type: SH
en: BUGS
de: FEHLER

note: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=482973 type: Plain text
en: B<gethostbyname>()  does not recognize components of a dotted IPv4 address string that are expressed in hexadecimal.
de: B<gethostbyname>() erkennt in IPv4-Adresszeichenketten in Punktnotation keine Bestandteile in hexadezimaler Notation.

note: type: SH
en: SEE ALSO
de: SIEHE AUCH

note: type: SH
en: COLOPHON
de: KOLOPHON

note: type: Plain text
en: This page is part of release 5.03 of the Linux I<man-pages> project.  A description of the project, information about reporting bugs, and the latest version of this page, can be found at \%https://www.kernel.org/doc/man-pages/.
de: Diese Seite ist Teil der Veröffentlichung 5.03 des Projekts Linux-I<man-pages>. Eine Beschreibung des Projekts, Informationen, wie Fehler gemeldet werden können sowie die aktuelle Version dieser Seite finden sich unter \%https://www.kernel.org/doc/man-pages/.

note: type: Plain text
en: This page is part of release 5.02 of the Linux I<man-pages> project.  A description of the project, information about reporting bugs, and the latest version of this page, can be found at \%https://www.kernel.org/doc/man-pages/.
de: Diese Seite ist Teil der Veröffentlichung 5.02 des Projekts Linux-I<man-pages>. Eine Beschreibung des Projekts, Informationen, wie Fehler gemeldet werden können sowie die aktuelle Version dieser Seite finden sich unter \%https://www.kernel.org/doc/man-pages/.

note: type: Plain text
en: This page is part of release 5.01 of the Linux I<man-pages> project.  A description of the project, information about reporting bugs, and the latest version of this page, can be found at \%https://www.kernel.org/doc/man-pages/.
de: Diese Seite ist Teil der Veröffentlichung 5.01 des Projekts Linux-I<man-pages>. Eine Beschreibung des Projekts, Informationen, wie Fehler gemeldet werden können sowie die aktuelle Version dieser Seite finden sich unter \%https://www.kernel.org/doc/man-pages/.
