Module domain::rdata::svcb

Record data for SVCB/HTTPS records.

Service binding records are an IETF standard currently in development as draft-ietf-dnsop-svcb-https. They provide clients with information for accessing a service in one place rather than via multiple records.

Service bindings come as two record types with identical record data format. The SVCB record type can be used for any service by prefixing the service in question to the query name. The HTTPS record type is for use with the HTTPS protocol and can be used without a prefix. Additional record types for other protocols may be defined in the future.

The type SvcbRdata<..> implements the record data of all of these types. It takes a marker struct as its first type argument. Type aliases for the two current types are provided via Svcb and Https. Like most complex record data types, they still are generic over an octets sequence and a domain name.

The record data itself consists of a priority providing the order of records if more than one is given, a target name which indicates the name of the host where the service is provided, and a possible empty sequence of service parameters further describing properties of the service. These parameters are represented by the SvcParams type. They consist of a sequence of different parameter values. Types for the defined values are available in the value sub-module. A new sequence of values can be constructed using the SvcParamsBuilder type.

Modules

• value

Structs

• HttpsVariant
  The marker type for the HTTPS record type.
• LongSvcParam
  The octets sequence to be used for record data is too long.
• SvcParams
  A sequence of service binding parameters.
• SvcParamsBuilder
  A builder for a service parameter sequence.
• SvcParamsError
  An octets sequence was not a valid service bindings parameter sequence.
• SvcbRdata
  Service binding record data.
• SvcbVariant
  The marker type for the SVCB record type.
• UnknownSvcParam
  A service binding parameter value in its raw form.
• ValueIter
  An iterator over the values in a parameter sequence.

Enums

• PushError
  An error happened when pushing values to a parameters builder.

Traits

• ComposeSvcParamValue
  A service binding parameter value that can be composed into wire format.
• ParseSvcParamValue
  A service binding parameter value that can be parse from wire format.
• SvcParamValue
  A type representing a service binding parameter value.

Type Definitions

• Https
  A type alias for record data of the HTTPS record type.
• Svcb
  A type alias for record data of the SVCB record type.