package mirage-net

  1. Overview
  2. Docs
Network signatures for MirageOS

Install 

dune-project
 Dependency

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

Authors

  1. T
    Thomas Gazagnaire
  2. A
    Anil Madhavapeddy
  3. Gabriel Radanne
  4. M
    Mindy Preston
  5. T
    Thomas Leonard
  6. N
    Nicolas Ojeda Bar
  7. D
    Dave Scott
  8. D
    David Kaloper
  9. H
    Hannes Mehnert
  10. R
    Richard Mortier

Maintainers

  1. T
    thomas@gazagnaire.org

Sources

mirage-net-v4.0.0.tbz
sha256=668effd187b81a0ab32450870c15dbb89ff911397ff338a8951807e250e194ce
sha512=52064dc704ebd0d305fd234b6d89fc313d5a80016d8875ef93212a1962ad8b1f332f7b0338244afbb2d2f207a28d476e7d7639be9dc607d95145afee7fccc483

doc/mirage-net/Mirage_net/module-type-S/index.html

Module type Mirage_net.SSource

A network interface that serves Ethernet frames.

Sourcetype error = private [>
  1. | Net.error
]

The type for network interface errors.

Sourceval pp_error : error Fmt.t

pp_error is the pretty-printer for errors.

Sourcetype t

The type representing the internal state of the network device.

Sourceval disconnect : t -> unit Lwt.t

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

Sourceval write : t -> size:int -> (Cstruct.t -> int) -> (unit, error) result Lwt.t

write net ~size fill allocates a buffer of length size, where size must not exceed the interface maximum packet size (mtu plus Ethernet header). The allocated buffer is zeroed and passed to the fill function which returns the payload length, which may not exceed the length of the buffer. When fill returns, a sub buffer is put on the wire: the allocated buffer from index 0 to the returned length.

Sourceval listen : t -> header_size:int -> (Cstruct.t -> unit Lwt.t) -> (unit, error) result Lwt.t

listen ~header_size net fn waits for a packet with size at most header_size + mtu on the network device. When a packet is received, an asynchronous task is created in which fn packet is called. The ownership of packet is transferred to fn. The function can be stopped by calling disconnect.

Sourceval mac : t -> Macaddr.t

mac net is the MAC address of net.

Sourceval mtu : t -> int

mtu net is the Maximum Transmission Unit of net. This excludes the Ethernet header.

Sourceval get_stats_counters : t -> stats

Obtain the most recent snapshot of the interface statistics.

Sourceval reset_stats_counters : t -> unit

Reset the statistics associated with this interface to their defaults.