1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
|
# ocaml-posix
[](LICENSE)
[](https://github.com/savonet/ocaml-posix/actions/workflows/ci.yml)
[](https://github.com/savonet/ocaml-posix/releases)
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](https://github.com/ocamllabs/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)
```sh
opam install posix-base posix-types posix-errno posix-socket posix-time2
```
### From source
```sh
git clone https://github.com/savonet/ocaml-posix.git
cd ocaml-posix
opam install .
```
## Quick Start
```ocaml
(* 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
```
```ocaml
(* 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
```
```ocaml
(* 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
| Package | Description | Replaces |
|---------|-------------|----------|
| `posix-base` | Base tools for generating POSIX bindings | - |
| `posix-types` | POSIX type definitions | [ocaml-posix-types](https://github.com/yallop/ocaml-posix-types), [PosixTypes](http://ocamllabs.io/ocaml-ctypes/PosixTypes.html) |
| `posix-errno` | Error number handling and Unix error conversion | [unix-errno](https://github.com/xapi-project/ocaml-unix-errno) |
| `posix-socket` | Socket operations (`sys/socket.h`) | [sys-socket](https://github.com/toots/ocaml-sys-socket) |
| `posix-socket-unix` | Unix domain socket extensions | - |
| `posix-time2` | Time and clock functions | [posix-time](https://github.com/mwweissmann/ocaml-posix-time), [unix-time](https://github.com/dsheets/ocaml-unix-time), [posix-clock](https://github.com/mwweissmann/ocaml-posix-clock) |
| `posix-getopt` | Command-line option parsing | [posix-getopt](https://github.com/toots/posix-getopt) |
| `posix-uname` | System identification | - |
| `posix-unistd` | Miscellaneous POSIX functions (`unistd.h`) | - |
| `posix-resource` | Resource limits and usage (`sys/resource.h`) | [unix-sys-resource](https://github.com/dsheets/ocaml-unix-sys-resource) |
| `posix-signal` | Signal handling | - |
| `posix-stat` | File status (`sys/stat.h`) | [unix-sys-stat](https://github.com/dsheets/ocaml-unix-sys-stat) |
| `posix-math2` | Mathematical functions | - |
## 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](LICENSE) file for details.
|
