changelog shortlog graph tags branches changeset files revisions annotate raw help

Mercurial > org > docs / core/ffi.org

changeset 34: bc53e27c0163
parent: 0b69e63c9374
child: b925807b50a6
author: Richard Westhaver <ellis@rwest.io>
date: Sat, 22 Jun 2024 23:54:39 -0400
permissions: -rw-r--r--
description: bump
1 #+title: ffi
2 #+author: Richard Westhaver
3 #+setupfile: ../../clean.theme
4 #+OPTIONS: num:nil
5 #+infojs_opt: toc:nil home:https://compiler.company up:./ view:content
6 This doc is about the [[https://en.wikipedia.org/wiki/Foreign_function_interface][Foreign Function Interface]] (FFI) features of the
7 =core=.
8 
9 Besides accessing system, OS, and external libraries via binding code
10 (dynamically in Lisp, statically in Rust), we also expose parts of the
11 core in a C-compatible fashion. In Lisp, we use the SB-ALIEN interface
12 to load (with dlopen) and call foreign symbols. In Rust we mostly use
13 rust-bindgen and the built-in rustc features.
14 
15 * Libraries
16 The following binding libraries are provided with supporting
17 code. There is some cross-over between the Lisp and Rust bindings
18 depending on what library features we need and where. Some of the
19 bindings are very minimal or for experimental-use only only.
20 ** xkb
21 These bindings are actually directed at libxkbcommon instead of
22 x11/xkb directly.
23 *** xkbcommon
24 https://xkbcommon.org/doc/current/md_doc_2quick-guide.html
25 ** rocksdb
26 [[https://github.com/facebook/rocksdb/wiki][RocksDB Wiki]]
27 ** btrfs
28 The kernel headers btrfs and btrfs_tree will be wrapped at some point
29 in addition to the userspace library (btrfsutil) documented below.
30 *** btrfsutil
31 https://github.com/kdave/btrfs-progs
32 ** uring
33 https://man.archlinux.org/man/io_uring.7.en
34 ** zstd
35 zstd compression bindings: https://github.com/facebook/zstd
36 ** tree-sitter
37 bindings to tree-sitter parser generator and language libraries: https://github.com/tree-sitter/tree-sitter
38 ** COMMENT blake3
39 temporary package for CL implementation of Blake3 SHA. Wraps C
40 implementation (libblake3).
41 ** COMMENT alpm
42 https://man.archlinux.org/man/core/pacman/libalpm.3.en
43 https://github.com/archlinux/alpm.rs/tree/382af70cdbff8e1f65c0bf8df79693786f44429c/alpm/examples
44 
45 ** COMMENT bqn
46 These bindings are for libcbqn which can be build from CBQN:
47 https://github.com/dzaima/CBQN
48 ** COMMENT k
49 https://codeberg.org/ngn/k
50 bindings for ngn/k (libk).
51 ** COMMENT nuklear
52 ** COMMENT ssh2