mirror of
https://github.com/servalproject/serval-dna.git
synced 2024-12-18 12:56:29 +00:00
71cbe86566
This introduces a new way of linking Serval executables and dynamic libraries from static libraries like libservald.a -- called "feature-driven" linking. The Makefile now links servald and serval-tests from libservald.a, rather than from an explicit list of object (.o) files. Thanks to the section-based method for registering functions such as HTTP handlers, CLI commands and MDP handlers, these object files had become "stand-alone" and hence were no longer included in the link because there was no unresolved reference that required them to be linked in. The new "feature.h" provides the DECLARE_FEATURE(name) macro that each stand-alone source file uses to declare the named feature(s) it provides. Each executable can call the USE_FEATURE(name) macro in any of its explicitly-linked source files to cause the corresponding object(s) to be included in the link, eg, servald_features.c. The DEFINE_BINDING() macro has been extended so that every individual MDP binding is given a feature name based on its port number macro, eg, "mdp_binding_MDP_PORT_ECHO". Some features have been factored into their own separate source files so they can be omitted or included in a build independently of each other: - the MDP bindings for MDP_PORT_DNALOOKUP, MDP_PORT_ECHO, MDP_PORT_TRACE, MDP_PORT_KEYMAPREQUEST, MDP_PORT_RHIZOME_xxx, MDP_PORT_PROBE, MDP_PORT_STUN, MDP_PORT_STUNREQ - the CLI "log" and "echo" commands - the CLI "rhizome direct" command The JNI source files are only compiled if the <jni.h> header is present, otherwise they are omitted from libservald.so.
67 lines
2.8 KiB
C
67 lines
2.8 KiB
C
/*
|
|
Serval DNA features
|
|
Copyright (C) 2016 Flinders University
|
|
|
|
This program is free software; you can redistribute it and/or
|
|
modify it under the terms of the GNU General Public License
|
|
as published by the Free Software Foundation; either version 2
|
|
of the License, or (at your option) any later version.
|
|
|
|
This program is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
GNU General Public License for more details.
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
along with this program; if not, write to the Free Software
|
|
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
|
|
*/
|
|
|
|
#ifndef __SERVAL_DNA__FEATURE_H
|
|
#define __SERVAL_DNA__FEATURE_H
|
|
|
|
/* These are macros for assembling an executable out of an explicitly-listed
|
|
* subset of "features". A feature is an object file (.o file) that contains
|
|
* the entire implementation of the feature, and is optional, ie, can be
|
|
* omitted from an executable without breaking the build.
|
|
*
|
|
* In Serval DNA, features are joined up with their infrastructure using
|
|
* linkage sections; see "sections.h" for more details.
|
|
*
|
|
* For example, a source file can add its own static function to the list of
|
|
* all URL path-to-function mappings for the HTTPD server using
|
|
* DECLARE_HANDLER() macro defined in "httpd.h". There is no
|
|
* explicitly-initialised array that lists all the URL paths; the array is
|
|
* constructed implicitly by the linker when it assembles the "httpd" section.
|
|
* Simply including the relevant object files in the link brings their
|
|
* functions into the array.
|
|
*
|
|
* Features are also used to add commands to the CLI interface and to add
|
|
* port-number handlers to the MDP interface.
|
|
*
|
|
* In order to build an executable from libservald.a, the executable needs a
|
|
* way to specify which optional features it wishes to link in, otherwise they
|
|
* will be omitted from the build, and as a result it will offer few or no CLI
|
|
* commands, no MDP services, and no HTTP services.
|
|
*
|
|
* Each source file that implements a feature must contain a DEFINE_FEATURE()
|
|
* macro, with the name of the feature as its argument.
|
|
*
|
|
* Every executable that links against libservald.a must contain a source file
|
|
* that invokes the USE_FEATURE() macro once for every defined feature it
|
|
* wishes to link in. This is typically done inside the main() function, but
|
|
* may be done within any function that is guaranteed to be included in the
|
|
* link.
|
|
*/
|
|
|
|
#define DEFINE_FEATURE(name) \
|
|
void _serval_feature__ ## name () {} \
|
|
|
|
#define USE_FEATURE(name) \
|
|
do { \
|
|
extern void _serval_feature__ ## name (); \
|
|
_serval_feature__ ## name (); \
|
|
} while (0)
|
|
|
|
#endif // __SERVAL_DNA__FEATURE_H
|