package posix-errno

ocaml-posix

OCaml bindings to POSIX APIs.

Overview

ocaml-posix provides comprehensive bindings to POSIX system interfaces for OCaml. Each module offers:

• Low-level bindings for use with ocaml-ctypes
• High-level OCaml APIs for convenient, idiomatic usage

This project consolidates and extends various existing POSIX binding libraries into a single, consistent collection.

Documentation

API documentation is available at: http://www.liquidsoap.info/ocaml-posix/

Installation

Via opam (recommended)

opam install posix-base posix-types posix-errno posix-socket posix-time2

From source

git clone https://github.com/savonet/ocaml-posix.git
cd ocaml-posix
opam install .

Quick Start

(* Using posix-time2 for clock operations *)
open Posix_time2

let () =
  let ts = clock_gettime `Realtime in
  Printf.printf "Current time: %Ld.%09ld seconds\n"
    ts.Timespec.tv_sec ts.Timespec.tv_nsec

(* Using posix-uname for system information *)
open Posix_uname

let () =
  let info = uname () in
  Printf.printf "System: %s %s (%s)\n"
    info.sysname info.release info.machine

(* Using posix-socket for DNS resolution *)
open Ctypes
open Posix_socket

let () =
  (* Resolve hostname to socket addresses *)
  let addresses = getaddrinfo ~port:(`Int 443) "example.com" in
  List.iter (fun sockaddr ->
    (* Convert back to human-readable form *)
    let host, port = getnameinfo sockaddr in
    Printf.printf "Resolved: %s:%d\n" host port
  ) addresses

(* Convert between Unix and POSIX socket addresses *)
let unix_to_posix addr =
  let posix_addr = from_unix_sockaddr addr in
  let host, port = getnameinfo posix_addr in
  Printf.printf "Address: %s:%d\n" host port

Available Packages

Cross-compilation

ocaml-posix supports cross-compilation (e.g., building for Windows from Linux/macOS using mingw). The build system automatically detects cross-compilation scenarios and uses appropriate tooling.

Contributing

Contributions are welcome! Please feel free to submit issues or pull requests.

License

This project is licensed under the MIT License - see the LICENSE file for details.