NAME

       srvsearch,   sync_srvsearch,  smtpsearch,  sync_smtpsearch,  httpsearch,  sync_httpsearch,
       ruli-getaddrinfo
       - Sample programs for RULI Library (RFC 2782)

SYNOPSIS

       echo _service._protocol.nongnu.org | ruli-getaddrinfo
       echo _service._protocol.nongnu.org | srvsearch [ options ]
       echo _service._protocol.nongnu.org | sync_srvsearch [ options ]
       echo nongnu.org | smtpsearch [ options ]
       echo nongnu.org | sync_smtpsearch [ options ]
       echo nongnu.org | httpsearch [ options ]
       echo nongnu.org | sync_httpsearch [ options ]

DESCRIPTION

       This manual page documents briefly sample programs for the ruli(3) library.

       ruli is a library aimed at querying DNS SRV resource records.

OPTIONS

       For http searches, one can force the port number by specifying it as the first option.

       search Use the resolver search list defined in ´/etc/resolv.conf´.

       need_ra
              Require RA (Recursion Available) bit in the name server answer.

       noinet Don´t fetch IPv4 addresses.

       noinet6
              Don´t fetch IPv6 addresses.

       uri_port
              Assume the specified default port was forced by the user-supplied URI.

       nowalk Don´t search addresses missing from the name server answer.

       nofall Don´t launch fallback queries for addresses, if the SRV query fails.

       nosort6
              Don´t sort the address list to give preference to IPv6 addresses.

EXAMPLES

       echo _telnet._tcp.nongnu.org | ruli-getaddrinfo
       echo _smtp._tcp.nongnu.org | srvsearch search
       echo _smtp._tcp.nongnu.org | sync_srvsearch search noinet6
       echo nongnu.org | smtpsearch noinet
       echo nongnu.org | sync_smtpsearch nowalk nofall
       echo nongnu.org | httpsearch noinet6
       echo nongnu.org | sync_httpsearch 80

SEE ALSO

       ruli(3)

AUTHOR

       This manual page was written by Everton da Silva Marques <evertonsm@yahoo.com.br>.

                                         October 08, 2004                                 RULI(1)