package mirage-channel

  1. Overview
  2. Docs
Buffered channels for MirageOS FLOW types

Install

Dune Dependency

Authors

Maintainers

Sources

mirage-channel-v4.0.1.tbz
sha256=ecbaed5f601c9d33b86222523f07ad0cae149ad7ec6af63a3a165d1fe117ab72
sha512=c73abf66fa476a3202af01b7ab2ef95362deae5718fa2656f3165e39a601ac3088e65b4714de5341c8073f9f61194d48b756812e1e9c761fd94eb4c37dad2444

Description

Channels are buffered reader/writers built on top of unbuffered FLOW implementations.

Example:

module Channel = Channel.Make(Flow)
...
Channel.read_exactly ~len:16 t
>>= fun bufs -> (* read header of message *)
let payload_length = Cstruct.(LE.get_uint16 (concat bufs) 0) in
Channel.read_exactly ~len:payload_length t
>>= fun bufs -> (* payload of message *)

(* process message *)

Channel.write_buffer t header;
Channel.write_buffer t payload;
Channel.flush t
>>= fun () ->

mirage-channel is distributed under the ISC license.

Tags

org:mirage

Published: 05 Nov 2019

README

mirage-channel — Buffered channels for MirageOS FLOW types

v4.0.1

Channels are buffered reader/writers built on top of unbuffered FLOW implementations.

Example:

module Channel = Channel.Make(Flow)
...
Channel.read_exactly ~len:16 t
>>= fun bufs -> (* read header of message *)
let payload_length = Cstruct.(LE.get_uint16 (concat bufs) 0) in
Channel.read_exactly ~len:payload_length t
>>= fun bufs -> (* payload of message *)

(* process message *)

Channel.write_buffer t header;
Channel.write_buffer t payload;
Channel.flush t
>>= fun () ->

mirage-channel is distributed under the ISC license.

Installation

mirage-channel can be installed with opam:

opam install channel

If you don't use opam consult the opam file for build instructions.

Documentation

The documentation and API reference is automatically generated by ocamldoc from the interfaces. It can be consulted online and there is a generated version in the doc directory of the distribution.

Sample programs

If you installed mirage-channel with opam sample programs are located in the directory opam config var channel:doc.

In the distribution sample programs and tests are located in the test directory of the distribution. They can be built with:

./build test

The resulting binaries are in _build/test.

  • test.native tests the library, nothing should fail.

Dependencies (6)

  1. logs
  2. cstruct >= "4.0.0" & < "6.1.0"
  3. lwt >= "4.0.0"
  4. mirage-flow >= "2.0.0"
  5. dune >= "1.0"
  6. ocaml >= "4.06.0"

Dev Dependencies (2)

  1. mirage-flow-combinators with-test & >= "2.0.0"
  2. alcotest with-test

Used by (8)

  1. caqti-mirage
  2. cohttp-mirage >= "2.4.0"
  3. docteur-unix < "0.0.3"
  4. git-mirage >= "2.1.2" & < "3.0.0"
  5. mirage-types >= "3.7.1"
  6. pgx_lwt_mirage
  7. protocol-9p >= "2.0.2"
  8. protocol-9p-unix >= "2.0.2"

Conflicts (1)

  1. tcpip < "3.0.0"