Skip to content

Commit

Permalink
Merge pull request ocaml#10858 from haesbaert/opam-publish-rawlink.0.7
Browse files Browse the repository at this point in the history
Package rawlink.0.7
  • Loading branch information
hannesm authored Nov 27, 2017
2 parents ba5782a + a3e0327 commit b86a910
Show file tree
Hide file tree
Showing 3 changed files with 53 additions and 0 deletions.
30 changes: 30 additions & 0 deletions packages/rawlink/rawlink.0.7/descr
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
Portable library to read and write raw packets.

[![Build Status](https://travis-ci.org/haesbaert/rawlink.svg)](https://travis-ci.org/haesbaert/rawlink)

Rawlink is an ocaml library for sending and receiving raw packets at the link
layer level. Sometimes you need to have full control of the packet, including
building the full ethernet frame.

The API is platform independent, it uses BPF on real UNIXes and AF_SOCKET on
linux. Some functionality is sacrificed so that the API is portable enough.

Currently BPF and AF_PACKET are implemented, including filtering capabilities.
Writing a BPF program is a pain in the ass, so no facilities are provided for
it. If you need a BPF filter, I suggest you write a small .c file with a
function that returns the BPF program as a string, check `rawlink_stubs.c` for
an example.

Both normal blocking functions as well as `Lwt` monadic variants are provided.

A typical code for receiving all packets and just sending them back on an
specified interface are detailed below:

```
let link = Rawlink.open_link "eth0" in
let buf = Rawlink.read_packet link in
Printf.printf "got a packet with %d bytes.\n%!" (Cstruct.len buf);
Rawlink.send_packet link buf
```

Check the mli interface for more options.
21 changes: 21 additions & 0 deletions packages/rawlink/rawlink.0.7/opam
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
opam-version: "1.2"
name: "rawlink"
maintainer: "Christiano F. Haesbaert <haesbaert@haesbaert.org>"
authors: "Christiano F. Haesbaert <haesbaert@haesbaert.org>"
license: "ISC"
homepage: "https://github.com/haesbaert/rawlink"
bug-reports: "https://github.com/haesbaert/rawlink/issues"
dev-repo: "https://github.com/haesbaert/rawlink.git"
doc: "https://haesbaert.github.io/rawlink/api"
build: [ "ocaml" "pkg/pkg.ml" "build" "--pinned" "%{pinned}%" ]
depends: [
"ocamlfind" {build}
"topkg" {build}
"lwt" {>= "2.4.7"}
"cstruct" {>= "3.2.0"}
"ppx_cstruct" {build}
"ocamlbuild" {build}
]
depexts: [[ ["alpine"] ["linux-headers"] ]]
available: [ocaml-version >= "4.03.0"]

2 changes: 2 additions & 0 deletions packages/rawlink/rawlink.0.7/url
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
archive: "https://github.com/haesbaert/rawlink/releases/download/v0.7/rawlink-0.7.tbz"
checksum: "ec72e0585a0e877dcaf828663cf946bd"

0 comments on commit b86a910

Please sign in to comment.