Make (p.dns-client.6.4.0.doc.dns-client.mirage.Dns_client

Parameters

module R : Mirage_random.S

module T : Mirage_time.S

module M : Mirage_clock.MCLOCK

module P : Mirage_clock.PCLOCK

module S : Tcpip.Stack.V4V6

Signature

module Transport : 
  Dns_client.S
    with type io_addr =
           [ `Plaintext of Ipaddr.t * int
           | `Tls of Tls.Config.client * Ipaddr.t * int ]
     and type +'a io = 'a Lwt.t
    with type stack = S.t

include sig ... end

Sourcetype t = Dns_client.Make(Transport).t

Source

val create : 
  ?cache_size:int ->
  ?edns:[ `Auto | `Manual of Dns.Edns.t | `None ] ->
  ?nameservers:(Dns.proto * Transport.io_addr list) ->
  ?timeout:int64 ->
  Transport.stack ->
  t

Sourceval nameservers : t -> Dns.proto * Transport.io_addr list

Source

val getaddrinfo : 
  t ->
  'response Dns.Rr_map.key ->
  'a Domain_name.t ->
  ('response, [> `Msg of string ]) result Transport.io

Source

val gethostbyname : 
  t ->
  [ `host ] Domain_name.t ->
  (Ipaddr.V4.t, [> `Msg of string ]) result Transport.io

Source

val gethostbyname6 : 
  t ->
  [ `host ] Domain_name.t ->
  (Ipaddr.V6.t, [> `Msg of string ]) result Transport.io

Source

val get_resource_record : 
  t ->
  'response Dns.Rr_map.key ->
  'a Domain_name.t ->
  ('response,
    [> `Msg of string
    | `No_data of [ `raw ] Domain_name.t * Dns.Soa.t
    | `No_domain of [ `raw ] Domain_name.t * Dns.Soa.t ])
    result
    Transport.io

Source

val get_raw_reply : 
  t ->
  'response Dns.Rr_map.key ->
  'a Domain_name.t ->
  (Dns.Packet.reply, [> `Msg of string | `Partial ]) result Transport.io

Source

val nameserver_of_string : 
  string ->
  (Dns.proto * Transport.io_addr, [> `Msg of string ]) result

nameserver_of_string authenticators str returns a Transport.io_addr from the given string. The format is:

udp:<ipaddr>(:port)? for a plain nameserver and we will communicate with it via the UDP protocol
tcp:<ipaddr>(:port)? for a plain nameserver and we will communicate with it via the TCP protocol
tls:<ipaddr>(:port)?((!hostname)?!authenticator)? for a nameserver and we will communicate with it via the TCP protocol plus the TLS encrypted layer. The user can verify the nameserver via an authenticator (see X509.Authenticator.of_string for the format of it). The hostname can be provided to be used as peer name by the authenticator. By default, Ca_certs_nss.authenticator is used.

Source

val connect : 
  ?cache_size:int ->
  ?edns:[ `None | `Auto | `Manual of Dns.Edns.t ] ->
  ?nameservers:string list ->
  ?timeout:int64 ->
  Transport.stack ->
  t Lwt.t

connect ?cache_size ?edns ?nameservers ?timeout stack creates a DNS entity which is able to resolve domain-name. It expects few optional arguments:

cache_size the size of the LRU cache
edns the behaviour of whether or not to send edns in queries
nameservers a list of nameservers used to resolve domain-names
timeout (in nanoseconds), passed to create

raises [Invalid_argument]
if given strings don't respect formats explained by nameserver_of_string.