Module sd

Service discovery helpers to perform automated client bootstrapping.

Tools in this module allows finding the exact location of a CalDAV or CardDAV server. The process involves a few steps:

• Find the exact server using SRV Service Labels. See resolve_srv_record.
• Find the context path via TXT records or the well-known URI. See find_context_url
• Find the current user’s principal resource. See WebDavClient::find_current_user_principal.

See also

• crate::CalDavClient::bootstrap_via_service_discovery
• crate::CardDavClient::bootstrap_via_service_discovery
• https://www.rfc-editor.org/rfc/rfc6764

Enums

• BootstrapError
  Error type for crate::CalDavClient::bootstrap_via_service_discovery and crate::CardDavClient::bootstrap_via_service_discovery.
• ContextUrlError
  Error type for find_context_url.
• DiscoverableService
  Services for which automatic discovery is possible.
• FindContextUrlResult
  Return type for the find_context_url function.
• TxtError
  Error returned by find_context_path_via_txt_records.

Functions

• find_context_path_via_txt_records
  Resolves a context path via TXT records.
• find_context_url
  Find a CalDAV or CardDAV context path via client bootstrap sequence.
• resolve_srv_record
  Resolves SRV to locate the caldav server.