package libc

  1. Overview
  2. Docs
Raw definitions and bindings to platforms system libraries

Install

Dune Dependency

Authors

Maintainers

Sources

libc-0.0.1.tbz
sha256=7b9c7961a7bb57aa8ea6af9a2d9695fba2fd95dcbda83a9df4a73c9e402c10d8
sha512=8e9a9dfbd1a0fb51b93cd6e2237bc16eecb894298de73e33f0ce6ad572880ba20548d60b05eaed53574d662cf68126bdb88cebf1982fab8d11d53dbf3e3d2f9a

Description

`libc provides definitions (and in the future bindings) to easily interoperate with C code (or C-like code) on several platforms, and it does this with a target and architecture aware API.

README

libc - raw definitions and bindings to platforms' system libraries

libc provides definitions (and in the future bindings) to easily interoperate with C code (or "C-like" code) on several platforms, and it does this with a target and architecture aware API.

Preliminary platform support includes:

  • aarch64-macos-darwin

  • aarch64-unknown-linux-gnu

  • aarch64-unknown-linux-musl

  • x86_64-macos-darwin

  • x86_64-unknown-linux-gnu

  • x86_64-unknown-linux-musl

  • x86_64-unknown-freebsd

  • PRs welcome -- see Contributing

None of these are complete, but they are being extended on a need basis.

Usage

Pin it in your OPAM:

opam pin add libc.0.0.1 git+https://github.com/leostera/libc.ml

Add it to your dune project:

(depends 
   (libc (>= "0.0.1"))
   ...)

Add it to your dune libraries:

(library
  (name my_lib)
  (libraries libc))

Use it in your code:

let flags = Libc.(ev_clear lor ev_receipt lor ev_add) in
(* ... *)

Contributing

Including new platforms, while tedious, is pretty straightforward. We are using Rust's libc as a template for what are interesting/useful definitions on each platform.

That way, the easiest way to get started is to find the right platform version of libc for Rust, and translate the definitions.

For example, for aarch64-apple-darwin the definitions are found here. If you use the 'platforms' drop-down you can find your platform, and we can start porting from there.

Common types are currently included in the types.ml module, so you can open Types at the top of your new module.

If you follow this path, here's some useful transformations you can apply with sed:

sed 's/<</lsl/g'
sed 's/|/lor/g'
sed 's/const /let /g'
sed 's/:://g'
sed 's/;;//g'

Dependencies (3)

  1. dune >= "3.12"
  2. ocaml >= "5.1.1"
  3. config >= "0.0.1"

Dev Dependencies (1)

  1. odoc with-doc

Used by (1)

  1. gluon

Conflicts

None

OCaml

Innovation. Community. Security.