aboutsummaryrefslogtreecommitdiffstats
path: root/README.rst
blob: 6b22a1c0cbeabd634706a27885bcc2ba6bf54692 (plain)
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
================================
Rust bindings for hinawa library
================================

2024/02/25
Takashi Sakamoto

Introduction
============

* This repository includes FFI and API bindings for ``libhinawa`` v4.0 or later which
  provides ``Hinawa-4.0.gir``.

  * `<https://git.kernel.org/pub/scm/libs/ieee1394/libhinawa.git/>`_

* The crates are available in `crates.io <https://crates.io/>`_ as well.

* Inconveniently, it includes no support for ``libhinawa`` v2.6 or former, which provides
  ``Hinawa-3.0.gir``, ``Hinawa-2.0.gir``, and ``Hinawa-1.0.gir``.

* The latest release is version 0.11.0.

Crates
======

API bindings for safe and high-level abstractions
-------------------------------------------------

* `hinawa crate <hinawa/README.md>`_

`FFI bindings <https://doc.rust-lang.org/cargo/reference/build-scripts.html#-sys-packages>`_
--------------------------------------------------------------------------------------------

* `hinawa-sys crate <hinawa/sys/README.md>`_

License
=======

MIT License

Dependencies
============

* `libhinawa 4.0 or later <https://git.kernel.org/pub/scm/libs/ieee1394/libhinawa.git/>`_
* FFI crate (``hinawa-sys``)

  * ``libc`` >= 0.2
  * ``glib-sys`` >= 0.19
  * ``gobject-sys`` >= 0.19

* API crate (`hinawa`)

  * ``libc`` >= 0.2
  * ``glib`` >= 0.19
  * FFI crate (``hinawa-sys``)

Examples
========

See ``hinawa/examples`` directory.