package netchannel

You can search for identifiers within the package.

in-package search v0.2.0

On This Page

Parameters
Signature

package netchannel

netchannel
- Netchannel
  - Assemble
    
    FRAME_MSG
    
    Make
    
    F
  - Backend
    
    Make
    
    C
  - Features
  - Flags
  - Frontend
    
    Make
    
    C
  - RX
    
    Request
    
    Response
  - S
    
    CONFIGURATION
  - Shared_page_pool
  - Stats
  - TX
    
    Request
    
    Response
  - Xenstore
    
    Make
    
    Xs

Legend:
Library
Module
Module type
Parameter
Class
Class type

Parameters

module C : S.CONFIGURATION

Signature

include Mirage_net.S

type error = private [>

| Mirage_net.Net.error

]

The type for network interface errors.

val pp_error : error Fmt.t

pp_error is the pretty-printer for errors.

type t

The type representing the internal state of the network device.

val 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.

val write : 
  t ->
  size:int ->
  (Cstruct.t -> int) ->
  (unit, error) Stdlib.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.

val listen : 
  t ->
  header_size:int ->
  (Cstruct.t -> unit Lwt.t) ->
  (unit, error) Stdlib.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.

val mac : t -> Macaddr.t

mac net is the MAC address of net.

val mtu : t -> int

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

val get_stats_counters : t -> Mirage_net.stats

Obtain the most recent snapshot of the interface statistics.

val reset_stats_counters : t -> unit

Reset the statistics associated with this interface to their defaults.

val make : domid:int -> device_id:int -> t Lwt.t

make ~domid ~device_id connects a backend connecting to domid

val frontend_mac : t -> Macaddr.t