DNSServiceResolve man page on SmartOS

Man page or keyword search:  
man Server   16655 pages
apropos Keyword Search (all sections)
Output format
SmartOS logo
[printable version]

DNSSERVICERESOLVE(3DNS_SD)			    DNSSERVICERESOLVE(3DNS_SD)

NAME
       DNSServiceResolve - resolve service instances with DNS

SYNOPSIS
       cc [ flag ... ] file ... -ldns_sd [ library ... ]
       #include <dns_sd.h>

       DNSServiceErrorType DNSServiceResolve(DNSServiceRef *sdRef,
	    DNSServiceFlags flags, uint32_t interfaceIndex, const char *name,
	    const char *regtype, const char *domain,
	    DNSServiceServiceResolveReply callBack, void *context);

       typedef void(*DNSServiceResolveReply)(DNSServiceRef sdRef,
	    DNSServiceFlags flags, uint32_t interfaceIndex,
	    DNSServiceErrorType errorCode, const char *fullname,
	    const char *hosttarget, uint16_t port, uint16_t txtLen,
	    const char *txtRecord, void *context);

DESCRIPTION
       The  DNSServiceResolve()	 function  is  used  to resolve a service name
       returned by DNSServiceBrowse() to host IP address, port number, and TXT
       record.	 The   DNSServiceResolve()   function  returns	results	 asyn‐
       chronously. A DNSServiceResolve() call to resolve service name  can  be
       ended  by  calling  DNSServiceRefDeallocate().  The  callback  argument
       points to a function of type DNSServiceResolveReply  as	listed	above.
       The callback function is invoked on finding a result or when the asynch
       resolve call fails. The sdRef argument to DNSServiceResolve() points to
       an uninitialized DNSServiceRef. If the call to DNSServiceResolve() suc‐
       ceeds, sdRef is initialized and kDNSServiceErr_NoError is returned.

       The flags argument  to  DNSServiceResolve()  is	currently  unused  and
       reserved	 for  future  use.  The	 interfaceIndex argument indicates the
       interface on which to resolve the service. If  the  DNSServiceResolve()
       call is the result of an earlier DNSServiceBrowse() operation, pass the
       interfaceIndex to perform a resolve on all interfaces. See the  section
       "Constants  for	specifying  an interface index" in <dns_sd.h> for more
       details. The  name  parameter  is  the  service	instance  name	to  be
       resolved, as returned from a DNSServiceBrowse() call. The regtype holds
       the service type and the domain parameter indicates the domain in which
       the service instance was found. The context parameter points to a value
       that is passed to the callback function.

       The sdRef argument passed to the callback function  is  initialized  by
       DNSServiceResolve()  call. The flags parameter in the callback function
       is currently unused and reserved for future use. The errorCode  parame‐
       ter  is	kDNSServiceErr_NoError on success. Otherwise, it will hold the
       error defined in <dns_sd.h> and other  parameters  are  undefined  when
       errorCode  is nonzero. The fullname parameter in the callback holds the
       full  service  domain  name   in	  the	format	 <servicename>.<proto‐
       col>.<domain>.  The full service domain name is escaped to follow stan‐
       dard DNS rules. The hosttarget parameter holds the target  hostname  of
       the  machine  providing	the  service. The port parameter indicates the
       port in network byte order on which the	service	 accepts  connections.
       The  txtLen and txtRecord parameters hold the length and the TXT record
       of the service's primary TXT record. The context	 parameter  points  to
       the value that was passed as context to the DNSServiceResolve() call.

RETURN VALUES
       The  DNSServiceResolve  function returns kDNSServiceErr_NoError on suc‐
       cess. Otherwise, an error code defined in  <dns_sd.h>  is  returned  to
       indicate	 an  error  has occurred. When an error is returned by DNSSer‐
       viceResolve, the callback function is not invoked and the DNSServiceRef
       argument is not initialized.

ATTRIBUTES
       See attributes(5) for description of the following attributes:

       ┌────────────────────┬─────────────────┐
       │  ATTRIBUTE TYPE    │ ATTRIBUTE VALUE │
       ├────────────────────┼─────────────────┤
       │Interface Stability │ Committed	      │
       ├────────────────────┼─────────────────┤
       │MT-Level	    │ Safe	      │
       └────────────────────┴─────────────────┘

SEE ALSO
       DNSServiceBrowse(3DNS_SD),	     DNSServiceRefDeallocate(3DNS_SD),
       attributes(5)

				 Aug 20, 2007	    DNSSERVICERESOLVE(3DNS_SD)
[top]

List of man pages available for SmartOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net