Blame lib/lwres/man/lwres_getnameinfo.html

Packit Service ae04f2
Packit Service ae04f2
Packit Service ae04f2
 - Copyright (C) 2000, 2001, 2004, 2005, 2007, 2014-2016, 2018-2020 Internet Systems Consortium, Inc. ("ISC")
Packit Service ae04f2
 - 
Packit Service ae04f2
 - This Source Code Form is subject to the terms of the Mozilla Public
Packit Service ae04f2
 - License, v. 2.0. If a copy of the MPL was not distributed with this
Packit Service ae04f2
 - file, You can obtain one at http://mozilla.org/MPL/2.0/.
Packit Service ae04f2
-->
Packit Service ae04f2
<html lang="en">
Packit Service ae04f2
<head>
Packit Service ae04f2
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
Packit Service ae04f2
<title>lwres_getnameinfo</title>
Packit Service ae04f2
<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
Packit Service ae04f2
</head>
Packit Service ae04f2
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
Packit Service ae04f2
Packit Service ae04f2
  
Packit Service ae04f2
  
Packit Service ae04f2
Packit Service ae04f2
  
Packit Service ae04f2
Packit Service ae04f2
  
Packit Service ae04f2
Packit Service ae04f2
  
Packit Service ae04f2

Name

Packit Service ae04f2

Packit Service ae04f2
    lwres_getnameinfo
Packit Service ae04f2
     — lightweight resolver socket address structure to hostname and
Packit Service ae04f2
      service name
Packit Service ae04f2
    
Packit Service ae04f2
  

Packit Service ae04f2
Packit Service ae04f2
  
Packit Service ae04f2

Synopsis

Packit Service ae04f2
    
Packit Service ae04f2
#include <lwres/netdb.h>
Packit Service ae04f2
Packit Service ae04f2
Packit Service ae04f2
Packit Service ae04f2
int
Packit Service ae04f2
lwres_getnameinfo(
Packit Service ae04f2
const struct sockaddr *sa, 
Packit Service ae04f2
Packit Service ae04f2
Packit Service ae04f2
 
Packit Service ae04f2
size_t salen, 
Packit Service ae04f2
Packit Service ae04f2
Packit Service ae04f2
 
Packit Service ae04f2
char *host, 
Packit Service ae04f2
Packit Service ae04f2
Packit Service ae04f2
 
Packit Service ae04f2
size_t hostlen, 
Packit Service ae04f2
Packit Service ae04f2
Packit Service ae04f2
 
Packit Service ae04f2
char *serv, 
Packit Service ae04f2
Packit Service ae04f2
Packit Service ae04f2
 
Packit Service ae04f2
size_t servlen, 
Packit Service ae04f2
Packit Service ae04f2
Packit Service ae04f2
 
Packit Service ae04f2
int flags);
Packit Service ae04f2
Packit Service ae04f2
Packit Service ae04f2
 
Packit Service ae04f2
Packit Service ae04f2
  
Packit Service ae04f2
Packit Service ae04f2
  
Packit Service ae04f2

DESCRIPTION

Packit Service ae04f2
Packit Service ae04f2
Packit Service ae04f2
    

Packit Service ae04f2
       This function is equivalent to the
Packit Service ae04f2
      
Packit Service ae04f2
        getnameinfo(3)
Packit Service ae04f2
       function defined in RFC2133.
Packit Service ae04f2
      lwres_getnameinfo() returns the
Packit Service ae04f2
      hostname for the
Packit Service ae04f2
      struct sockaddr sa which
Packit Service ae04f2
      is
Packit Service ae04f2
      salen bytes long.  The hostname is of
Packit Service ae04f2
      length
Packit Service ae04f2
      hostlen and is returned via
Packit Service ae04f2
      *host. The maximum length of the
Packit Service ae04f2
      hostname is
Packit Service ae04f2
      1025 bytes: NI_MAXHOST.
Packit Service ae04f2
    

Packit Service ae04f2
Packit Service ae04f2
    

The name of the service associated with the port number in

Packit Service ae04f2
      sa is returned in *serv.
Packit Service ae04f2
      It is servlen bytes long.  The
Packit Service ae04f2
      maximum length
Packit Service ae04f2
      of the service name is NI_MAXSERV - 32
Packit Service ae04f2
      bytes.
Packit Service ae04f2
    

Packit Service ae04f2
Packit Service ae04f2
    

Packit Service ae04f2
       The flags argument sets the
Packit Service ae04f2
      following
Packit Service ae04f2
      bits:
Packit Service ae04f2
      

Packit Service ae04f2
Packit Service ae04f2
NI_NOFQDN
Packit Service ae04f2
Packit Service ae04f2
            

Packit Service ae04f2
              A fully qualified domain name is not required for local hosts.
Packit Service ae04f2
              The local part of the fully qualified domain name is returned
Packit Service ae04f2
              instead.
Packit Service ae04f2
            

Packit Service ae04f2
          
Packit Service ae04f2
NI_NUMERICHOST
Packit Service ae04f2
Packit Service ae04f2
            

Packit Service ae04f2
              Return the address in numeric form, as if calling inet_ntop(),
Packit Service ae04f2
              instead of a host name.
Packit Service ae04f2
            

Packit Service ae04f2
          
Packit Service ae04f2
NI_NAMEREQD
Packit Service ae04f2
Packit Service ae04f2
            

Packit Service ae04f2
              A name is required. If the hostname cannot be found in the DNS
Packit Service ae04f2
              and
Packit Service ae04f2
              this flag is set, a non-zero error code is returned.
Packit Service ae04f2
              If the hostname is not found and the flag is not set, the
Packit Service ae04f2
              address is returned in numeric form.
Packit Service ae04f2
            

Packit Service ae04f2
          
Packit Service ae04f2
NI_NUMERICSERV
Packit Service ae04f2
Packit Service ae04f2
            

Packit Service ae04f2
              The service name is returned as a digit string representing the
Packit Service ae04f2
              port number.
Packit Service ae04f2
            

Packit Service ae04f2
          
Packit Service ae04f2
NI_DGRAM
Packit Service ae04f2
Packit Service ae04f2
            

Packit Service ae04f2
              Specifies that the service being looked up is a datagram
Packit Service ae04f2
              service,  and causes getservbyport() to be called with a second
Packit Service ae04f2
              argument of "udp" instead of its default of "tcp".  This is
Packit Service ae04f2
              required
Packit Service ae04f2
              for the few ports (512-514) that have different services for UDP
Packit Service ae04f2
              and
Packit Service ae04f2
              TCP.
Packit Service ae04f2
            

Packit Service ae04f2
          
Packit Service ae04f2
Packit Service ae04f2

Packit Service ae04f2
    

Packit Service ae04f2
  
Packit Service ae04f2
Packit Service ae04f2
  
Packit Service ae04f2

RETURN VALUES

Packit Service ae04f2
Packit Service ae04f2
    

lwres_getnameinfo()

Packit Service ae04f2
      returns 0 on success or a non-zero error code if an error occurs.
Packit Service ae04f2
    

Packit Service ae04f2
  
Packit Service ae04f2
  
Packit Service ae04f2

SEE ALSO

Packit Service ae04f2
Packit Service ae04f2
    

Packit Service ae04f2
        RFC2133
Packit Service ae04f2
      ,
Packit Service ae04f2
      
Packit Service ae04f2
        getservbyport(3)
Packit Service ae04f2
      ,
Packit Service ae04f2
      
Packit Service ae04f2
        lwres(3)
Packit Service ae04f2
      ,
Packit Service ae04f2
      
Packit Service ae04f2
        lwres_getnameinfo(3)
Packit Service ae04f2
      ,
Packit Service ae04f2
      
Packit Service ae04f2
        lwres_getnamebyaddr(3)
Packit Service ae04f2
      .
Packit Service ae04f2
      
Packit Service ae04f2
        lwres_net_ntop(3)
Packit Service ae04f2
      .
Packit Service ae04f2
    

Packit Service ae04f2
  
Packit Service ae04f2
  
Packit Service ae04f2

BUGS

Packit Service ae04f2
Packit Service ae04f2
    

Packit Service ae04f2
      RFC2133 fails to define what the nonzero return values of
Packit Service ae04f2
      
Packit Service ae04f2
        getnameinfo(3)
Packit Service ae04f2
      
Packit Service ae04f2
      are.
Packit Service ae04f2
    

Packit Service ae04f2
  
Packit Service ae04f2
</body>
Packit Service ae04f2
</html>