> Linux Reviews > man >

gethostbyname

gethostbyname

Funkce B()P a Bgethostbyaddr()P vrací strukturu

gethostbyname.3.man

1. gethostbyname.3.man

Manpage of GETHOSTBYNAME

GETHOSTBYNAME

Section: Linux - pøíruèka programátora (3)
Updated: 30. bøezna 1997
Index Return to Main Contents

JMÉNO

gethostbyname, gethostbyaddr, sethostent, endhostent, herror - získej záznam z databáze poèítaèù

SYNTAXE

#include <netdb.h>
extern int h_errno;

struct hostent *gethostbyname(const char *name);

struct hostent *gethostbyaddr(const char *addr, int len, int type);

void sethostent(int stayopen);

void endhostent(void);

void herror(const char *s);

POPIS

Funkce gethostbyname() vrací strukturu typu hostent pro zadaný poèítaè name. Doména poèítaèe a jí nadøazené jsou prohledávány pouze tehdy, nekonèí-li name teèkou. Pokud name nekonèí teèkou a promìnná prostøedí HOSTALIASES je nastavena, bude prvnì prohledáván soubor, na který ukazuje promìnná HOSTALIASES.

Funkce gethostbyaddr() vrací strukturu typu hostent pro poèítaè, jeho¾ adresa addr (délky len a typu type) byla zadána. Jediným platný typem adresy je nyní AF_INET.

Funkce sethostent() specifikuje, je-li stayopen pravdivé (1), ¾e k dotazování budou pou¾ity spojené TCP sokety a spojení zùstane mezi jednotlivými dotazy otevøeno. Jinak budou k dotazování pou¾ity UDP datagramy.

Funkce endhostent() ukonèí TCP spojení pro dotazy na nameserver.

Funkce herror() vytiskne chybovou zprávu, která pøíslu¹í hodnotì promìnné h_errno.

Funkce gethostbyname() a gethostbyaddr() pou¾ívají pøi své èinnosti jak nameservery named(8), tak soubor /etc/hosts, ale samozøejmì i NIS nebo YP, to zále¾í na poøadí definovaném v /etc/host.conf. (Viz resolv+(8)). Standardnì je prvnì dotazován named(8) a potom soubor /etc/hosts.

Struktura hostent je definována v <netdb.h> následovnì:


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 */

Prvky struktury hostent jsou:

h_name: Oficiální jméno poèítaèe.
h_aliases: Nulou ukonèené pole alternativních jmen poèítaèù.
h_addrtype: Typ adres, v souèasné dobì v¾dy AF_INET.
h_length: Délka adresy v bajtech.
h_addr_list: Nulou ukonèené pole sí»ových adres poèítaèe v sí»ovém poøadí dat.
h_addr: První adresa v h_addr_list kvùli zpìtné kompatibilitì.

NÁVRATOVÁ HODNOTA

Funkce gethostbyname() a gethostbyaddr() vrací strukturu hostent nebo ukazatel NULL v pøípadì výskytu chyby. Potom je nastavena promìnná h_errno.

CHYBY

Promìnná h_errno mù¾e obsahovat následující hodnoty:

HOST_NOT_FOUND: Specifikovaný poèítaè je neznámý.
NO_ADDRESS: Jméno je platné, ale nemá ¾ádnou IP adresu.
NO_RECOVERY: Do¹lo k výskytu neodstranitelné chyby nameserveru.
TRY_AGAIN: Do¹lo k doèasné chybì autoritativního nameserveru. Zkuste pozdìji.

SOUBORY

/etc/host.conf: konfiguraèní soubor resolveru.
/etc/hosts: databáze poèítaèù.

SPLÒUJE STANDARDY

BSD 4.3

DAL©Í INFORMACE

resolver(3), hosts(5), hostname(7), resolv+ (8), named(8)

Index

JMÉNO
SYNTAXE
POPIS
NÁVRATOVÁ HODNOTA
CHYBY
SOUBORY
SPLÒUJE STANDARDY
DAL©Í INFORMACE

This document was created by man2html using the manual pages.
Time: 17:09:28 GMT, January 19, 2012

- - - - ja - pl