summaryrefslogtreecommitdiff
path: root/index.mdwn
blob: 4e5ded7cd505b7f313e53d0524f7fbd3a3fa4ea4 (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
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
# libbsd

This library provides useful functions commonly found on BSD systems, and
lacking on others like GNU systems, thus making it easier to port projects
with strong BSD origins, without needing to embed the same code over and
over again on each project.

## License

The licenses for the code contained in libbsd are quite permissive to make
it easier for other projects to use it. Most of the licenses are either
[ISC](https://spdx.org/licenses/ISC.html),
[MIT](https://spdx.org/licenses/MIT.html),
[Beerware](https://spdx.org/licenses/Beerware.html),
[BSD-2-clause](https://spdx.org/licenses/BSD-2-Clause.html),
[BSD-3-clause](https://spdx.org/licenses/BSD-3-Clause.html), and
[BSD-4-clause](https://spdx.org/licenses/BSD-3-Clause.html) (but only
for few of the man pages, and this is considered a bug). Please check
the the COPYING file and the source code for the actual license details.

## Download

Latest [released tarballs](https://libbsd.freedesktop.org/releases/).

## Development

The code under development can be cloned from git:

    git clone https://anongit.freedesktop.org/git/libbsd.git

And browsed in [gitlab](https://gitlab.freedesktop.org/libbsd/libbsd) or
using [cgit](https://cgit.freedesktop.org/libbsd/).

## Contact

[Mailing list](https://lists.freedesktop.org/mailman/listinfo/libbsd).

The project has been switched to the
[FreeDesktop.Org GitLab](https://gitlab.freedesktop.org/) instance, and
filing new bugs in Bugzilla has been disabled. We are using the GitLab
[issues](https://gitlab.freedesktop.org/libbsd/libbsd/issues) now. Historic
bugs can be accessed from
[Bugzilla](https://bugs.freedesktop.org/buglist.cgi?query_format=specific&bug_status=__closed__&product=libbsd).

### Security issues

In case of a security issue that needs to be reported privately, please
send encrypted mail to [Guillem Jover](https://www.hadrons.org/~guillem/),
the current maintainer.

## Contributing

Changes can be sent either as patches to the mailing list, or as
[merge requests](https://gitlab.freedesktop.org/libbsd/libbsd/merge_requests).

New interfaces can be added, depending on their portability, and on their
presence on at least one of the BSDs. The preferred form is by importing the
best implementation from one of those BSDs. Alternatively an implementation
from scratch might be required. In that case the preferred coding style is
[KNF](https://www.freebsd.org/cgi/man.cgi?query=style&sektion=9) and a
[BSD-3-clause](https://spdx.org/licenses/BSD-3-Clause.html) license, but
a more permissive license is also welcome. Any new function must also come
with a man page. Ideally new interfaces should get new unit tests.

## Downstreams

[![Packaging status](https://repology.org/badge/vertical-allrepos/libbsd.svg)](https://repology.org/metapackage/libbsd)

* [Buildroot](https://git.buildroot.net/buildroot/tree/package/libbsd)
* [Cygwin Ports](https://github.com/cygwinports-extras/libbsd)
* [Exherbo](https://git.exherbo.org/summer/packages/dev-libs/libbsd/)
* [Nutyx](https://github.com/NuTyX/core/tree/master/cli/libbsd)
* [OpenEmbedded](http://cgit.openembedded.org/openembedded-core/tree/meta/recipes-support/libbsd)
* [openmamba](https://www.openmamba.org/distribution/distromatic.html?tag=devel&pkg=libbsd.source)
* [OpenWrt](https://dev.openwrt.org/browser/trunk/package/libs/libbsd)
* [PLD Linux](https://git.pld-linux.org/?p=packages/libbsd.git)
* [SliTaz](http://hg.slitaz.org/wok/file/tip/libbsd/receipt)
* [Source Mage](http://scmweb.sourcemage.org/?p=smgl/grimoire.git;a=tree;f=libs/libbsd)
* [UHU Linux](https://svn.uhulinux.hu/packages/dev/libbsd/)
* [NaCL webports](https://chromium.googlesource.com/webports/+/master/ports/libbsd/)
* [Yocto Project](https://git.yoctoproject.org/cgit/cgit.cgi/poky/tree/meta/recipes-support/libbsd)

### Ports

* [Mac OS X](https://github.com/JackieXie168/libbsd)
* [Solaris](https://github.com/jrmarino/libbsd4sol)