about summary refs log tree commit diff
path: root/src/libnm-core-impl/README.md
diff options
context:
space:
mode:
authorMichael Biebl <biebl@debian.org>2021-10-01 23:06:08 +0200
committerMichael Biebl <biebl@debian.org>2021-10-01 23:06:08 +0200
commita3349a04ac4c38885cddefec8515c979d03f9327 (patch)
treed3bbee695aa048cb4ec252e7d63515c8376f9006 /src/libnm-core-impl/README.md
parent2d5b58e374d67f60880c7689e80c7745aeef3f62 (diff)
parente74c568b07b50b97873fb4ee1d776dedefbd54d6 (diff)
Update upstream source from tag 'upstream/1.32.12'
Update to upstream version '1.32.12'
with Debian dir 6fabefa95c7dcf83371a78eb2c47013a81ff8d86
Diffstat (limited to 'src/libnm-core-impl/README.md')
-rw-r--r--src/libnm-core-impl/README.md22
1 files changed, 22 insertions, 0 deletions
diff --git a/src/libnm-core-impl/README.md b/src/libnm-core-impl/README.md
new file mode 100644
index 00000000..0fce8e1e
--- /dev/null
+++ b/src/libnm-core-impl/README.md
@@ -0,0 +1,22 @@
+libnm-core-impl
+===============
+
+NetworkManager provides a client library [`libnm`](../../libnm).
+NetworkManager core does not (dynamically) link against all of libnm.
+Instead, it statically links against a part of it.
+That part is the static helper library `libnm-core-impl`.
+
+`libnm-core-impl` implements (and provides) the API from
+[`libnm-core-public`](../libnm-core-public), which is part of the public
+API of [`libnm`](../../libnm). In this form, `libnm-core-impl` is part
+of the implementation of [`libnm`](../../libnm). It also implements (and
+provides) an internal API [`libnm-core-intern`](../libnm-core-intern) which
+can only be used by those who link statically against `libnm-core-impl`.
+
+Only NetworkManager core and [`libnm`](../../libnm) are allowed to statically
+link with `libnm-core-impl`. Consequently, only those are allowed to include
+[`libnm-core-intern`](../libnm-core-intern).
+
+This directory should not be added to the include search path of other
+components as they are only allowed to include [`libnm-core-public`](../libnm-core-public)
+and [`libnm-core-intern`](../libnm-core-intern).