package mirage-net-unix

  1. Overview
  2. Docs
Legend:
Library
Module
Module type
Parameter
Class
Class type

Implementation of the network interface for Unix backends.

include Mirage_net_lwt.S
type error = private [>
  1. | Mirage_device.error
]

The type for network errors.

val pp_error : error Fmt.t

pp_error is the pretty-printer for errors.

type page_aligned_buffer = Io_page.t

The type for page-aligned memory buffers.

type buffer = Cstruct.t

The type for memory buffers.

type macaddr = Macaddr.t

The type for unique MAC identifiers for the device.

include Mirage_device.S with type 'a io = 'a Lwt.t
type 'a io = 'a Lwt.t

The type for potentially blocking I/O operation

type t

The type representing the internal state of the device

val disconnect : t -> unit io

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

val write : t -> buffer -> (unit, error) Stdlib.result io

write nf buf outputs buf to netfront nf.

val writev : t -> buffer list -> (unit, error) Stdlib.result io

writev nf bufs output a list of buffers to netfront nf as a single packet.

val listen : t -> (buffer -> unit io) -> (unit, error) Stdlib.result io

listen nf fn is a blocking operation that calls fn buf with every packet that is read from the interface. The function can be stopped by calling disconnect in the device layer.

val mac : t -> macaddr

mac nf is the MAC address of nf.

val get_stats_counters : t -> Mirage_net.stats

Obtain the most recent snapshot of the device statistics.

val reset_stats_counters : t -> unit

Reset the statistics associated with this device to their defaults.

val connect : string -> t Lwt.t

connect tap connects to the given tap interface.

val fd : t -> Lwt_unix.file_descr

fd t is t's underneath file descriptor.

OCaml

Innovation. Community. Security.