136 lines
6.5 KiB
C
136 lines
6.5 KiB
C
/*
|
|
* Licensed to the OpenAirInterface (OAI) Software Alliance under one or more
|
|
* contributor license agreements. See the NOTICE file distributed with
|
|
* this work for additional information regarding copyright ownership.
|
|
* The OpenAirInterface Software Alliance licenses this file to You under
|
|
* the OAI Public License, Version 1.1 (the "License"); you may not use this file
|
|
* except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.openairinterface.org/?page_id=698
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*-------------------------------------------------------------------------------
|
|
* For more information about the OpenAirInterface (OAI) Software Alliance:
|
|
* contact@openairinterface.org
|
|
*/
|
|
|
|
/*! \file common/config/config_load_configmodule.h
|
|
* \brief: configuration module, include file to be used by the source code calling the
|
|
* configuration module initialization
|
|
* \author Francois TABURET
|
|
* \date 2017
|
|
* \version 0.1
|
|
* \company NOKIA BellLabs France
|
|
* \email: francois.taburet@nokia-bell-labs.com
|
|
* \note
|
|
* \warning
|
|
*/
|
|
#ifndef INCLUDE_CONFIG_LOADCONFIGMODULE_H
|
|
#define INCLUDE_CONFIG_LOADCONFIGMODULE_H
|
|
|
|
|
|
#include <string.h>
|
|
#include <stdlib.h>
|
|
#include <stdint.h>
|
|
#include <stdbool.h>
|
|
#include "common/config/config_paramdesc.h"
|
|
#include "common/utils/T/T.h"
|
|
#define CONFIG_MAX_OOPT_PARAMS 10 // maximum number of parameters in the -O option (-O <cfgmode>:P1:P2...
|
|
#define CONFIG_MAX_ALLOCATEDPTRS 2048 // maximum number of parameters that can be dynamicaly allocated in the config module
|
|
|
|
/* default values for configuration module parameters */
|
|
#define CONFIG_LIBCONFIGFILE "libconfig" // use libconfig file
|
|
#define CONFIG_CMDLINEONLY "cmdline" // use only command line options
|
|
#define DEFAULT_CFGFILENAME "oai.conf" // default config file
|
|
/* bit position definition for the argv_info mask of the configmodule_interface_t structure */
|
|
#define CONFIG_CMDLINEOPT_PROCESSED (1<<0) // command line option has been processed
|
|
/* bit position definitions for the rtflags mask of the configmodule_interface_t structure*/
|
|
#define CONFIG_PRINTPARAMS 1 // print parameters values while processing
|
|
#define CONFIG_DEBUGPTR (1<<1) // print memory allocation/free debug messages
|
|
#define CONFIG_DEBUGCMDLINE (1<<2) // print command line processing messages
|
|
#define CONFIG_NOABORTONCHKF (1<<4) // disable abort execution when parameter checking function fails
|
|
#define CONFIG_NOEXITONHELP (1<<19) // do not exit after printing help
|
|
#define CONFIG_HELP (1<<20) // print help message
|
|
#define CONFIG_ABORT (1<<21) // config failed,abort execution
|
|
#define CONFIG_NOOOPT (1<<22) // no -O option found when parsing command line
|
|
typedef int(*configmodule_initfunc_t)(char *cfgP[],int numP);
|
|
typedef int(*configmodule_getfunc_t)(paramdef_t *,int numparams, char *prefix);
|
|
typedef int(*configmodule_getlistfunc_t)(paramlist_def_t *, paramdef_t *,int numparams, char *prefix);
|
|
typedef void(*configmodule_endfunc_t)(void);
|
|
|
|
typedef struct oneBlock_s{
|
|
void *ptrs;
|
|
int sz;
|
|
bool toFree;
|
|
bool ptrsAllocated;
|
|
} oneBlock_t;
|
|
|
|
typedef struct configmodule_interface {
|
|
int argc;
|
|
char **argv;
|
|
uint32_t *argv_info;
|
|
char *cfgmode;
|
|
int num_cfgP;
|
|
char *cfgP[CONFIG_MAX_OOPT_PARAMS];
|
|
configmodule_initfunc_t init;
|
|
configmodule_getfunc_t get;
|
|
configmodule_getlistfunc_t getlist;
|
|
configmodule_endfunc_t end;
|
|
pthread_mutex_t memBlocks_mutex;
|
|
uint32_t numptrs;
|
|
uint32_t rtflags;
|
|
oneBlock_t oneBlock[CONFIG_MAX_ALLOCATEDPTRS];
|
|
} configmodule_interface_t;
|
|
|
|
#ifdef CONFIG_LOADCONFIG_MAIN
|
|
configmodule_interface_t *cfgptr=NULL;
|
|
|
|
static char config_helpstr [] = "\n lte-softmodem -O [config mode]<:dbgl[debugflags]><:incp[path]>\n \
|
|
debugflags can also be defined in the config section of the config file\n \
|
|
debugflags: mask, 1->print parameters, 2->print memory allocations debug messages\n \
|
|
4->print command line processing debug messages\n \
|
|
incp parameter can be used to define the include path used for config files (@include directive)\n \
|
|
defaults is set to the path of the main config file.\n";
|
|
|
|
#define CONFIG_SECTIONNAME "config"
|
|
#define CONFIGPARAM_DEBUGFLAGS_IDX 0
|
|
|
|
|
|
static paramdef_t Config_Params[] = {
|
|
/*-----------------------------------------------------------------------------------------------------------------------*/
|
|
/* config parameters for config module */
|
|
/* optname helpstr paramflags XXXptr defXXXval type numelt */
|
|
/*-----------------------------------------------------------------------------------------------------------------------*/
|
|
{"debugflags", config_helpstr, 0, uptr:NULL, defintval:0, TYPE_MASK, 0},
|
|
};
|
|
|
|
#else
|
|
extern configmodule_interface_t *cfgptr;
|
|
#endif
|
|
|
|
|
|
#define printf_params(...) if ( (cfgptr->rtflags & (CONFIG_PRINTPARAMS)) != 0 ) { printf ( __VA_ARGS__ ); }
|
|
#define printf_ptrs(...) if ( (cfgptr->rtflags & (CONFIG_DEBUGPTR)) != 0 ) { printf ( __VA_ARGS__ ); }
|
|
#define printf_cmdl(...) if ( (cfgptr->rtflags & (CONFIG_DEBUGCMDLINE)) != 0 ) { printf ( __VA_ARGS__ ); }
|
|
|
|
#define CONFIG_ENABLECMDLINEONLY (1<<1)
|
|
extern configmodule_interface_t *load_configmodule(int argc, char **argv, uint32_t initflags);
|
|
/* free ressources used to read parameters, keep memory
|
|
* allocated for parameters values which has been defined with the PARAMFLAG_NOFREE flag
|
|
* should be used as soon as there is no need to read parameters but doesn't prevent
|
|
* a new config module init
|
|
*/
|
|
extern void end_configmodule(void);
|
|
/* free all config module memory, to be used at end of program as
|
|
* it will free parameters values even those specified with the PARAMFLAG_NOFREE flag */
|
|
extern void free_configmodule(void);
|
|
#define CONFIG_PRINTF_ERROR(f, x... ) if (isLogInitDone ()) { LOG_E(ENB_APP,f,x);} else {printf(f,x);}; if ( !CONFIG_ISFLAGSET(CONFIG_NOABORTONCHKF) ) exit_fun("exit because configuration failed\n");
|
|
|
|
|
|
#endif /* INCLUDE_CONFIG_LOADCONFIGMODULE_H */
|