• Thomas Haller's avatar
    shared: build helper "libnm-libnm-core-{intern|aux}.la" library for libnm-core · 284ac92e
    Thomas Haller authored
    "libnm-core" implements common functionality for "NetworkManager" and
    "libnm".
    
    Note that clients like "nmcli" cannot access the internal API provided
    by "libnm-core". So, if nmcli wants to do something that is also done by
    "libnm-core", , "libnm", or "NetworkManager", the code would have to be
    duplicated.
    
    Instead, such code can be in "libnm-libnm-core-{intern|aux}.la".
    Note that:
    
      0) "libnm-libnm-core-intern.la" is used by libnm-core itsself.
         On the other hand, "libnm-libnm-core-aux.la" is not used by
         libnm-core, but provides utilities on top of it.
    
      1) they both extend "libnm-core" with utlities that are not public
         API of libnm itself. Maybe part of the code should one day become
         public API of libnm. On the other hand, this is code for which
         we may not want to commit to a stable interface or which we
         don't want to provide as part of the API.
    
      2) "libnm-libnm-core-intern.la" is statically linked by "libnm-core"
         and thus directly available to "libnm" and "NetworkManager".
         On the other hand, "libnm-libnm-core-aux.la" may be used by "libnm"
         and "NetworkManager".
         Both libraries may be statically linked by libnm clients (like
         nmcli).
    
      3) it must only use glib, libnm-glib-aux.la, and the public API
         of libnm-core.
         This is important: it must not use "libnm-core/nm-core-internal.h"
         nor "libnm-core/nm-utils-private.h" so the static library is usable
         by nmcli which couldn't access these.
    
    Note that "shared/nm-meta-setting.c" is an entirely different case,
    because it behaves differently depending on whether linking against
    "libnm-core" or the client programs. As such, this file must be compiled
    twice.
    
    (cherry picked from commit af07ed01)
    284ac92e
Name
Last commit
Last update
clients Loading commit data...
contrib Loading commit data...
data Loading commit data...
dispatcher Loading commit data...
docs Loading commit data...
examples Loading commit data...
introspection Loading commit data...
libnm Loading commit data...
libnm-core Loading commit data...
libnm-glib Loading commit data...
libnm-util Loading commit data...
m4 Loading commit data...
man Loading commit data...
po Loading commit data...
shared Loading commit data...
src Loading commit data...
tools Loading commit data...
vapi Loading commit data...
.dir-locals.el Loading commit data...
.gitignore Loading commit data...
.gitlab-ci.yml Loading commit data...
.mailmap Loading commit data...
.travis.yml Loading commit data...
AUTHORS Loading commit data...
CONTRIBUTING Loading commit data...
COPYING Loading commit data...
ChangeLog Loading commit data...
MAINTAINERS Loading commit data...
Makefile.am Loading commit data...
Makefile.examples Loading commit data...
Makefile.glib Loading commit data...
Makefile.vapigen Loading commit data...
NEWS Loading commit data...
NetworkManager.pc.in Loading commit data...
README Loading commit data...
TODO Loading commit data...
autogen.sh Loading commit data...
config-extra.h.meson Loading commit data...
config.h.meson Loading commit data...
configure.ac Loading commit data...
linker-script-binary.ver Loading commit data...
linker-script-devices.ver Loading commit data...
linker-script-settings.ver Loading commit data...
meson.build Loading commit data...
meson_options.txt Loading commit data...
valgrind.suppressions Loading commit data...
zanata.xml Loading commit data...