package charrua-client

You can search for identifiers within the package.

in-package search v0.2.0

On This Page

Parameters
Signature

DHCP client implementation

Install

dune-project

Dependency

github.com Readme Changelog ISC License Edit opam file Versions (5)

Authors

M

Mindy Preston

Maintainers

M

Mindy Preston

Sources

charrua-2.1.0.tbz

sha256=53a6be65499aa901b5db6a3c0494c21b5bc3fe2098c6e56826d3b55c49ed2b99

sha512=37d171014c755f7fc2465fd0124f5a80cb377c3a493883a38afdd2e583bf2022bec410842e5c7425b7945c3be408a55e9153a498c0f5f211dd1baa2c44fd5d6f

doc/charrua-client.mirage/Dhcp_ipv4/Make/index.html

Module `Dhcp_ipv4.Make`Source

Parameters

module Network : Mirage_net.S

module E : Ethernet.S

module Arp : Arp.S

Signature

include Tcpip.Ip.S
  with type ipaddr = Ipaddr.V4.t
   and type prefix = Ipaddr.V4.Prefix.t

type nonrec error = private [>

| Tcpip.Ip.error

]

The type for IP errors.

val pp_error : error Fmt.t

pp_error is the pretty-printer for errors.

type ipaddr = Ipaddr.V4.t

The type for IP addresses.

val pp_ipaddr : ipaddr Fmt.t

pp_ipaddr is the pretty-printer for IP addresses.

type prefix = Ipaddr.V4.Prefix.t

The type for the IP address and netmask.

val pp_prefix : prefix Fmt.t

pp_prefix is the pretty-printer for the prefix.

type t

The type representing the internal state of the IP layer.

val disconnect : t -> unit Lwt.t

Disconnect from the IP layer. While this might take some time to complete, it can never result in an error.

type callback = src:ipaddr -> dst:ipaddr -> Cstruct.t -> unit Lwt.t

An input continuation used by the parsing functions to pass on an input packet down the stack.

callback ~src ~dst buf will be called with src and dst containing the source and destination IP address respectively, and buf will be a buffer pointing at the start of the IP payload.

val input : 
  t ->
  tcp:callback ->
  udp:callback ->
  default:(proto:int -> callback) ->
  Cstruct.t ->
  unit Lwt.t

input ~tcp ~udp ~default ip buf demultiplexes an incoming buffer that contains an IP frame. It examines the protocol header and passes the result onto either the tcp or udp function, or the default function for unknown IP protocols.

val write : 
  t ->
  ?fragment:bool ->
  ?ttl:int ->
  ?src:ipaddr ->
  ipaddr ->
  Tcpip.Ip.proto ->
  ?size:int ->
  (Cstruct.t -> int) ->
  Cstruct.t list ->
  (unit, error) result Lwt.t

write t ~fragment ~ttl ~src dst proto ~size headerf payload allocates a buffer, writes the IP header, and calls the headerf function. This may write to the provided buffer of size (default 0). If size + ip header exceeds the maximum transfer unit, an error is returned. The payload is appended. The optional fragment argument defaults to true, in which case multiple IP-fragmented frames are sent if the payload is too big for a single frame. When it is false, the don't fragment bit is set and if the payload and header would exceed the maximum transfer unit, an error is returned.

val pseudoheader : 
  t ->
  ?src:ipaddr ->
  ipaddr ->
  Tcpip.Ip.proto ->
  int ->
  Cstruct.t

pseudoheader t ~src dst proto len gives a pseudoheader suitable for use in TCP or UDP checksum calculation based on t.

val src : t -> dst:ipaddr -> ipaddr

src ip ~dst is the source address to be used to send a packet to dst. In the case of IPv4, this will always return the same IP, which is the only one set.

val get_ip : t -> ipaddr list

Get the IP addresses associated with this interface. For IPv4, only one IP address can be set at a time, so the list will always be of length 1 (and may be the default value, [10.0.0.2]).

deprecated this function will be removed soon, use [configured_ips] instead.

val configured_ips : t -> prefix list

Get the prefix associated with this interface. For IPv4, only one prefix can be set at a time, so the list will always be of length 1, e.g. [10.0.0.2/24].

val mtu : t -> dst:ipaddr -> int

mtu ~dst ip is the Maximum Transmission Unit of the ip i.e. the maximum size of the payload, not including the IP header.

Source

val connect : 
  ?no_init:bool ->
  ?cidr:Ipaddr.V4.Prefix.t ->
  ?gateway:Ipaddr.V4.t ->
  ?options:Dhcp_wire.dhcp_option list ->
  ?requests:Dhcp_wire.option_code list ->
  Network.t ->
  E.t ->
  Arp.t ->
  t Lwt.t

Connect to an ipv4 device using information from a DHCP lease. If cidr is provided, no DHCP requests will be done, but instead a static IPv4 (Tcpip.Ip.S) stack will be used. If no_init is provided and true, nothing will be initialized (for dual IPv4 and IPv6 stack where only the IPv6 part should be used).