Crate async_dnssd

source · [−]

Expand description

Asynchronous wrapper for DNS-SD C libraries

Interesting entry points:

Also the following things might be interesting:

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

Pending browse request

Optional data when browsing for a service; either use its default value or customize it like:

Browse result

Flags for BrowseResult

DNS CLASS

Connection to register records with

EnumerateDomains

Pending domain enumeration

EnumerateResult

Domain enumeration result

EnumeratedFlags

Flags for EnumerateDomains

Full name consiting of (up to) three parts

Network interface index

QueriedRecordFlags

Flags for QueryRecordResult

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

A successful record registration

Pending registration

Optional data when registering a service; either use its default value or customize it like:

Flags used to register service

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

Service registration result

Successful registration

Pending resolve request

Pending resolve

ResolveHostData

Optional data when querying for a record; either use its default value or customize it like:

ResolveHostResult

Resolve host result

Resolve result

Flags for ResolveResult

ResolvedHostFlags

Flags for ResolveHostResult

Add a timeout to a stream; each time an item is received the timer is reset

Key-Value container that uses DNS TXT RDATA as representation

Iterator for entries in TxtRecord

DNS (RR)TYPE

Enums

Whether to enumerate domains which are browsed or domains for which registrations can be made.

API Error

Network interface

ScopedSocketAddr

IP address with port and “scope id” (even for IPv4)

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 for available services

browse_extended

Browse for available services

Create Connection to register records with

enumerate_domains

Enumerate domains that are recommended for registration or browsing

Query for an arbitrary DNS record

query_record_extended

Query for an arbitrary DNS record

reconfirm_record

Purge record from cache

Register a service

register_extended

Register a service

Find hostname and port (and more) for a service

resolve_host_extended

Resolves hostname (with passed port) to stream of ScopedSocketAddr.