io.systemd.Resolve.Monitor¶

Property	Value
Go package	`github.com/rossedman/sdvarlink/systemd/latest/resolvemonitor`
Socket	`/run/systemd/resolve/io.systemd.Resolve.Monitor`
Available since	systemd v257
Methods · types · errors	6 · 18 · 0

Methods¶

SubscribeQueryResults¶

streaming (requires more)

func (c *Client) SubscribeQueryResults(ctx context.Context, in SubscribeQueryResultsIn) iter.Seq2[*SubscribeQueryResultsOut, error]

Parameters

Field	Type	Description
`allowInteractiveAuthentication`	`?bool`	Controls whether interactive authentication (via polkit) shall be allowed. If unspecified defaults to false.

Reply

Field	Type	Description
`ready`	`?bool`
`state`	`?string`
`result`	`?string`
`rcode`	`?int`
`errno`	`?int`
`extendedDNSErrorCode`	`?int`
`extendedDNSErrorMessage`	`?string`
`question`	`?[]ResourceKey`
`collectedQuestions`	`?[]ResourceKey`
`answer`	`?[]Answer`

DumpCache¶

func (c *Client) DumpCache(ctx context.Context, in DumpCacheIn) (*DumpCacheOut, error)

Parameters

Field	Type	Description
`allowInteractiveAuthentication`	`?bool`	Controls whether interactive authentication (via polkit) shall be allowed. If unspecified defaults to false.

Reply

Field	Type	Description
`dump`	`[]ScopeCache`

DumpServerState¶

func (c *Client) DumpServerState(ctx context.Context, in DumpServerStateIn) (*DumpServerStateOut, error)

Parameters

Field	Type	Description
`allowInteractiveAuthentication`	`?bool`	Controls whether interactive authentication (via polkit) shall be allowed. If unspecified defaults to false.

Reply

Field	Type	Description
`dump`	`[]ServerState`

DumpStatistics¶

func (c *Client) DumpStatistics(ctx context.Context, in DumpStatisticsIn) (*DumpStatisticsOut, error)

Parameters

Field	Type	Description
`allowInteractiveAuthentication`	`?bool`	Controls whether interactive authentication (via polkit) shall be allowed. If unspecified defaults to false.

Reply

Field	Type	Description
`transactions`	`TransactionStatistics`
`cache`	`CacheStatistics`
`dnssec`	`DnssecStatistics`

ResetStatistics¶

func (c *Client) ResetStatistics(ctx context.Context, in ResetStatisticsIn) error

Parameters

Field	Type	Description
`allowInteractiveAuthentication`	`?bool`	Controls whether interactive authentication (via polkit) shall be allowed. If unspecified defaults to false.

SubscribeDNSConfiguration¶

streaming (requires more) · since v258

Sends the complete global and per-link DNS configurations when any changes are made to them. The current configurations are given immediately when this method is invoked.

func (c *Client) SubscribeDNSConfiguration(ctx context.Context, in SubscribeDNSConfigurationIn) iter.Seq2[*SubscribeDNSConfigurationOut, error]

Parameters

Field	Type	Description
`allowInteractiveAuthentication`	`?bool`

Reply

Field	Type	Description
`configuration`	`[]DNSConfiguration`	The current global and per-interface DNS configurations

Types¶

DNSProtocol¶

Value	Description
`dns`	DNS
`mdns`	Multicast DNS
`llmnr`	LLMNR

DNSOverTLSMode¶

Value	Description
`no`	DNSOverTLS is disabled.
`yes`	DNSOverTLS is enabled.
`opportunistic`	Try to use DNSOverTLS, but disabled when the server does not support it.

ResolveSupport¶

Value	Description
`no`	The protocol is disabled.
`yes`	The protocol is enabled.
`resolve`	The protocol is used only for resolving.

ResolvConfMode¶

Value	Description
`uplink`	/etc/resolv.conf is a symbolic link to /run/systemd/resolve/resolv.conf.
`stub`	/etc/resolv.conf is a symbolic link to /run/systemd/resolve/stub-resolv.conf.
`static`	/etc/resolv.conf is a symbolic link to /usr/lib/systemd/resolv.conf.
`missing`	/etc/resolv.conf does not exist.
`foreign`	/etc/resolv.conf is not managed by systemd-resolved.

ResourceKey¶

Field	Type	Description
`class`	`?int`	The RR class, almost always IN, i.e 0x01. If unspecified defaults to IN.
`type`	`int`	The RR types, one of A, AAAA, PTR, …
`name`	`string`	The domain name.

ResourceRecord¶

Field	Type	Description
`key`	`ResourceKey`
`priority`	`?int`
`weight`	`?int`
`port`	`?int`
`name`	`?string`
`cpu`	`?string`
`os`	`?string`
`items`	`?[]string`
`address`	`?[]int`
`mname`	`?string`
`rname`	`?string`
`serial`	`?int`
`refresh`	`?int`
`expire`	`?int`
`minimum`	`?int`
`exchange`	`?string`
`version`	`?int`
`size`	`?int`
`horiz_pre`	`?int`
`vert_pre`	`?int`
`latitude`	`?int`
`longitude`	`?int`
`altitude`	`?int`
`keyTag`	`?int`
`algorithm`	`?int`
`digestType`	`?int`
`digest`	`?string`
`fptype`	`?int`
`fingerprint`	`?string`
`flags`	`?int`
`protocol`	`?int`
`dnskey`	`?string`
`signer`	`?string`
`typeCovered`	`?int`
`labels`	`?int`
`originalTtl`	`?int`
`expiration`	`?int`
`inception`	`?int`
`signature`	`?string`
`nextDomain`	`?string`
`types`	`?[]int`
`iterations`	`?int`
`salt`	`?string`
`hash`	`?string`
`certUsage`	`?int`
`selector`	`?int`
`matchingType`	`?int`
`data`	`?string`
`tag`	`?string`
`value`	`?string`
`target`	`?string`
`svcparams`	`?object`
`order`	`?int`
`preference`	`?int`
`naptrFlags`	`?string`
`services`	`?string`
`regexp`	`?string`
`replacement`	`?string`

ResourceRecordArray¶

Field	Type	Description
`rr`	`?ResourceRecord`
`raw`	`string`

Answer¶

Field	Type	Description
`rr`	`?ResourceRecord`
`raw`	`string`
`ifindex`	`?int`

CacheEntry¶

Field	Type	Description
`key`	`ResourceKey`
`rrs`	`?[]ResourceRecordArray`
`type`	`?string`
`until`	`int`

ScopeCache¶

Field	Type	Description
`protocol`	`DNSProtocol`
`family`	`?int`
`ifindex`	`?int`
`ifname`	`?string`
`cache`	`[]CacheEntry`
`dnssec`	`?string`
`dnsOverTLS`	`?DNSOverTLSMode`

TransactionStatistics¶

Field	Type	Description
`currentTransactions`	`int`
`totalTransactions`	`int`
`totalTimeouts`	`int`
`totalTimeoutsServedStale`	`int`
`totalFailedResponses`	`int`
`totalFailedResponsesServedStale`	`int`

CacheStatistics¶

Field	Type	Description
`size`	`int`
`hits`	`int`
`misses`	`int`

DnssecStatistics¶

Field	Type	Description
`secure`	`int`
`insecure`	`int`
`bogus`	`int`
`indeterminate`	`int`

ServerState¶

Field	Type	Description
`Server`	`string`
`Type`	`string`
`Interface`	`?string`
`InterfaceIndex`	`?int`
`VerifiedFeatureLevel`	`string`
`PossibleFeatureLevel`	`string`
`DNSSECMode`	`string`
`DNSSECSupported`	`bool`
`ReceivedUDPFragmentMax`	`int`
`FailedUDPAttempts`	`int`
`FailedTCPAttempts`	`int`
`PacketTruncated`	`bool`
`PacketBadOpt`	`bool`
`PacketRRSIGMissing`	`bool`
`PacketInvalid`	`bool`
`PacketDoOff`	`bool`

DNSServer¶

Encapsulates a DNS server address specification.

Field	Type	Description
`address`	`[]int`	IPv4 or IPv6 address of the server.
`addressString`	`?string`	IPv4 or IPv6 address of the server, formatted as a human-readable string.
`family`	`int`	Address family of the server, one of AF_INET or AF_INET6.
`port`	`int`	Port number of the server.
`ifindex`	`?int`	Interface index for which this server is configured.
`name`	`?string`	Server Name Indication (SNI) of the server.
`accessible`	`bool`	Indicates if the DNS server is accessible or not.

SearchDomain¶

Encapsulates a search domain specification.

Field	Type	Description
`name`	`string`	Domain name.
`routeOnly`	`bool`	Indicates whether or not this is a routing-only domain.
`ifindex`	`?int`	Interface index for which this search domain is configured.

DNSConfiguration¶

Encapsulates a global or per-link DNS configuration, including configured DNS servers, search domains, and more.

Field	Type	Description
`ifname`	`?string`	Interface name, if any, associated with this configuration. Empty for global configuration.
`ifindex`	`?int`	Interface index, if any, associated with this configuration. Empty for global configuration.
`delegate`	`?string`	Delegate name, if any, associated with this configuration. Empty for global or link configurations.
`defaultRoute`	`?bool`	Indicates whether or not this link's DNS servers will be used for resolving domain names that do not match any link's configured domains.
`currentServer`	`?DNSServer`	DNS server currently selected to use for lookups.
`servers`	`?[]DNSServer`	Array of configured DNS servers.
`fallbackServers`	`?[]DNSServer`	Array of configured fallback DNS servers, set for global configuration only.
`searchDomains`	`?[]SearchDomain`	Array of configured search domains.
`negativeTrustAnchors`	`?[]string`	Array of configured DNSSEC negative trust anchors.
`dnssec`	`?string`	DNSSEC mode.
`dnssecSupported`	`?bool`	Indicates if the current DNS server supports DNSSEC. Always false if DNSSEC mode is "no".
`dnsOverTLS`	`?DNSOverTLSMode`	DNSOverTLS mode.
`llmnr`	`?string`	LLMNR support.
`mDNS`	`?ResolveSupport`	mDNS support.
`resolvConfMode`	`?ResolvConfMode`	resolv.conf mode, set for global configuration only.
`scopes`	`?[]DNSScope`	Array of current DNS scopes.

DNSScope¶

Encapsulates a DNS scope specification.

Field	Type	Description
`protocol`	`DNSProtocol`	Protocol associated with this scope.
`family`	`?int`	Address family associated with this scope.
`ifindex`	`?int`	Interface index associated with this scope.
`ifname`	`?string`	Interface name associated with this scope.
`dnssec`	`?string`	DNSSEC mode associated with this scope.
`dnsOverTLS`	`?DNSOverTLSMode`	DNSOverTLS mode associated with this scope.