Name | Date | Size | #Lines | LOC | ||
---|---|---|---|---|---|---|
.. | 03-May-2022 | - | ||||
src/ | H | 04-Dec-2019 | - | |||
.clang-format | H A D | 04-Dec-2019 | 1.8 KiB | |||
.gitignore | H A D | 04-Dec-2019 | 86 | |||
.gitlab-ci.yml | H A D | 04-Dec-2019 | 634 | |||
CHANGELOG.md | H A D | 04-Dec-2019 | 1.7 KiB | |||
COPYRIGHT | H A D | 04-Dec-2019 | 2.9 KiB | |||
Makefile | H A D | 04-Dec-2019 | 1.5 KiB | |||
README.md | H A D | 04-Dec-2019 | 1.5 KiB | |||
meson.build | H A D | 04-Dec-2019 | 2.8 KiB |
README.md
1# libslirp 2 3libslirp is a user-mode networking library used by virtual machines, 4containers or various tools. 5 6## Getting Started 7 8### Prerequisites 9 10A C compiler, make/meson and glib2 development libraries. 11 12(see also [.gitlab-ci.yml](.gitlab-ci.yml) DEPS variable for the list 13of dependencies on Fedora) 14 15### Building 16 17You may build and install the shared library with meson: 18 19``` sh 20meson build 21ninja -C build install 22``` 23And configure QEMU with --enable-slirp=system to link against it. 24 25(QEMU may build with the submodule static library using --enable-slirp=git) 26 27### Testing 28 29Unfortunately, there are no automated tests available. 30 31You may run QEMU ``-net user`` linked with your development version. 32 33## Contributing 34 35Feel free to open issues on the [project 36issues](https://gitlab.freedesktop.org/slirp/libslirp/issues) page. 37 38You may clone the [gitlab 39project](https://gitlab.freedesktop.org/slirp/libslirp) and create a 40merge request. 41 42Contributing with gitlab allows gitlab workflow, tracking issues, 43running CI etc. 44 45Alternatively, you may send patches to slirp@lists.freedesktop.org 46mailing list. 47 48## Versioning 49 50We intend to use [libtool's 51versioning](https://www.gnu.org/software/libtool/manual/html_node/Updating-version-info.html) 52for the shared libraries and use [SemVer](http://semver.org/) for 53project versions. 54 55For the versions available, see the [tags on this 56repository](https://gitlab.freedesktop.org/slirp/libslirp/releases). 57 58## License 59 60See the [COPYRIGHT](COPYRIGHT) file for details. 61