summaryrefslogtreecommitdiff
path: root/readme.rst
blob: a51b7e992008ac6f2698beda0a8382d98b24fccb (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
synopsis
--------
Library routines for handling Microsoft Security Identifiers in text and binary
format.

Includes a utility ``sidparse`` for dissecting SIDs on the command line.

building
--------
The main build system is Oasis_, but there is a wrapper for OPAM to simplify
dependency management.

A manual build involves the following steps: ::

    $ opam install stdint cmdliner ounit
    $ oasis setup
    $ make

This will generate the library targets for ``sid.*`` as well as a utility
``sidparse.native`` that works similarly to ``uuidparse`` for UUIDs, and
unit test binary ``sid_test.byte``.

To view the HTML documentation, issue ::

    $ make doc

and point your browser at ``./_build/sid_intf.docdir/index.html``.

.. _Oasis: https://github.com/ocaml/oasis
.. _OPAM: https://opam.ocaml.org/

project
-------
The master repo_ is hosted on gitlab.com, please use the issue tracker there or
email me_ directly. Gitlab is also where releases_ are published.

.. _repo: https://gitlab.com/phgsng/ocaml-sid
.. _releases: https://gitlab.com/phgsng/ocaml-sid/tags
.. _me: mailto:phg@phi-gamma.net

references
----------
SIDs are specified in MS-DTYP_.

.. _MS-DTYP: https://msdn.microsoft.com/en-us/library/cc230273.aspx

license
-------
This package is licensed_ as ``LGPL-3.0-only`` (no “any later version” clause).

.. _licensed: https://spdx.org/licenses/LGPL-3.0-only.html