Crate async_dnssd

Asynchronous wrapper for DNS-SD C libraries

Interesting entry points:

• Browse for available services
• Create Connection to register records with
• Enumerate domains that are recommended for registration or browsing
• Query for an arbitrary DNS record
• Register a service
• Add a record to a registered service
• Register record
• Find hostname and port (and more) for a service

Also the following things might be interesting:

• Purge record from cache
• Construct full name
• Stream timeouts

Porting from dnssd C API

C API	functionality in this crate
DNSServiceAddRecord	Registration::add_record, Register::add_record
DNSServiceBrowse	browse
DNSServiceConstructFullName	FullName::construct
DNSServiceCreateConnection	connect
DNSServiceEnumerateDomains	enumerate_domains
DNSServiceQueryRecord	query_record
DNSServiceReconfirmRecord	reconfirm_record
DNSServiceRegister	register
DNSServiceRegisterRecord	Connection::register_record
DNSServiceResolve	resolve
DNSServiceUpdateRecord	Record::update_record, RegisterRecord::update_record

The following functions are called automatically when needed:

• DNSServiceProcessResult driving callbacks (event loop)
• DNSServiceRefDeallocate called when dropping various resource handles
• DNSServiceRefSockFD used for integration with tokio (event loop)
• DNSServiceRemoveRecord called when dropping Record

The TXTRecord* “TXT Record Construction Functions” are not wrapped; TxtRecord provides a native rust implementation with similar functionality.

Structs

• Browse
  Pending browse request
• BrowseData
  Optional data when browsing for a service; either use its default value or customize it like:
• BrowseResult
  Browse result
• BrowsedFlags
  Flags for BrowseResult
• Class
  DNS CLASS
• Connection
  Connection to register records with
• EnumerateDomains
  Pending domain enumeration
• EnumerateResult
  Domain enumeration result
• EnumeratedFlags
  Flags for EnumerateDomains
• FullName
  Full name consiting of (up to) three parts
• InterfaceIndex
  Network interface index
• QueriedRecordFlags
  Flags for QueryRecordResult
• QueryRecord
  Pending query
• QueryRecordData
  Optional data when querying for a record; either use its default value or customize it like:
• QueryRecordFlags
  Flags used to query for a record
• QueryRecordResult
  Query result
• Record
  A successful record registration
• Register
  Pending registration
• RegisterData
  Optional data when registering a service; either use its default value or customize it like:
• RegisterFlags
  Flags used to register service
• RegisterRecord
  Pending record registration
• RegisterRecordData
  Optional data when registering a record; either use its default value or customize it like:
• RegisterRecordFlags
  Flags used to register a record
• RegisterResult
  Service registration result
• Registration
  Successful registration
• Resolve
  Pending resolve request
• ResolveHost
  Pending resolve
• ResolveHostData
  Optional data when querying for a record; either use its default value or customize it like:
• ResolveHostResult
  Resolve host result
• ResolveResult
  Resolve result
• ResolvedFlags
  Flags for ResolveResult
• ResolvedHostFlags
  Flags for ResolveHostResult
• TimeoutStream
  Add a timeout to a stream; each time an item is received the timer is reset
• TxtRecord
  Key-Value container that uses DNS TXT RDATA as representation
• TxtRecordIter
  Iterator for entries in TxtRecord
• Type
  DNS (RR)TYPE

Enums

• Enumerate
  Whether to enumerate domains which are browsed or domains for which registrations can be made.
• Error
  API Error
• Interface
  Network interface
• ScopedSocketAddr
  IP address with port and “scope id” (even for IPv4)
• TxtRecordError
  Error returned when inserting new entries failed

Constants

• MAX_DOMAIN_NAME
  Maximum length of full name including trailing dot and terminating NULL

Traits

• StreamTimeoutExt
  Stream extension to simplify building TimeoutStream

Functions

• browse
  Browse for available services
• browse_extended
  Browse for available services
• connect
  Create Connection to register records with
• enumerate_domains
  Enumerate domains that are recommended for registration or browsing
• query_record
  Query for an arbitrary DNS record
• query_record_extended
  Query for an arbitrary DNS record
• reconfirm_record
  Purge record from cache
• register
  Register a service
• register_extended
  Register a service
• resolve
  Find hostname and port (and more) for a service
• resolve_host_extended
  Resolves hostname (with passed port) to stream of ScopedSocketAddr.