suricata
conf.h File Reference
#include "queue.h"
Include dependency graph for conf.h:

Go to the source code of this file.

Data Structures

struct  ConfNode_
 

Macros

#define DEFAULT_LOG_DIR   "/var/log/suricata"
 
#define DEFAULT_DATA_DIR   DATA_DIR
 

Typedefs

typedef struct ConfNode_ ConfNode
 

Functions

void ConfInit (void)
 Initialize the configuration system. More...
 
void ConfDeInit (void)
 De-initializes the configuration system. More...
 
ConfNodeConfGetRootNode (void)
 Get the root configuration node. More...
 
int ConfGet (const char *name, const char **vptr)
 Retrieve the value of a configuration node. More...
 
int ConfGetInt (const char *name, intmax_t *val)
 Retrieve a configuration value as an integer. More...
 
int ConfGetBool (const char *name, int *val)
 Retrieve a configuration value as a boolean. More...
 
int ConfGetDouble (const char *name, double *val)
 Retrieve a configuration value as a double. More...
 
int ConfGetFloat (const char *name, float *val)
 Retrieve a configuration value as a float. More...
 
int ConfSet (const char *name, const char *val)
 Set a configuration value. More...
 
int ConfSetFromString (const char *input, int final)
 Set a configuration parameter from a string. More...
 
int ConfSetFinal (const char *name, const char *val)
 Set a final configuration value. More...
 
void ConfDump (void)
 Dump configuration to stdout. More...
 
void ConfNodeDump (const ConfNode *node, const char *prefix)
 Dump a configuration node and all its children. More...
 
ConfNodeConfNodeNew (void)
 Allocate a new configuration node. More...
 
void ConfNodeFree (ConfNode *)
 Free a ConfNode and all of its children. More...
 
ConfNodeConfGetNode (const char *key)
 Get a ConfNode by name. More...
 
void ConfCreateContextBackup (void)
 Creates a backup of the conf_hash hash_table used by the conf API. More...
 
void ConfRestoreContextBackup (void)
 Restores the backup of the hash_table present in backup_conf_hash back to conf_hash. More...
 
ConfNodeConfNodeLookupChild (const ConfNode *node, const char *key)
 Lookup a child configuration node by name. More...
 
const char * ConfNodeLookupChildValue (const ConfNode *node, const char *key)
 Lookup the value of a child configuration node by name. More...
 
void ConfNodeRemove (ConfNode *)
 Remove (and SCFree) the provided configuration node. More...
 
void ConfRegisterTests (void)
 
int ConfNodeChildValueIsTrue (const ConfNode *node, const char *key)
 Test if a configuration node has a true value. More...
 
int ConfValIsTrue (const char *val)
 Check if a value is true. More...
 
int ConfValIsFalse (const char *val)
 Check if a value is false. More...
 
void ConfNodePrune (ConfNode *node)
 Prune a configuration node. More...
 
int ConfRemove (const char *name)
 Remove a configuration parameter from the configuration db. More...
 
bool ConfNodeHasChildren (const ConfNode *node)
 Check if a node has any children. More...
 
ConfNodeConfGetChildWithDefault (const ConfNode *base, const ConfNode *dflt, const char *name)
 
ConfNodeConfNodeLookupKeyValue (const ConfNode *base, const char *key, const char *value)
 Lookup for a key value under a specific node. More...
 
int ConfGetChildValue (const ConfNode *base, const char *name, const char **vptr)
 
int ConfGetChildValueInt (const ConfNode *base, const char *name, intmax_t *val)
 
int ConfGetChildValueBool (const ConfNode *base, const char *name, int *val)
 
int ConfGetChildValueWithDefault (const ConfNode *base, const ConfNode *dflt, const char *name, const char **vptr)
 
int ConfGetChildValueIntWithDefault (const ConfNode *base, const ConfNode *dflt, const char *name, intmax_t *val)
 
int ConfGetChildValueBoolWithDefault (const ConfNode *base, const ConfNode *dflt, const char *name, int *val)
 
char * ConfLoadCompleteIncludePath (const char *)
 Create the path for an include entry. More...
 
int ConfNodeIsSequence (const ConfNode *node)
 Check if a node is a sequence or node. More...
 
ConfNodeConfSetIfaceNode (const char *ifaces_node_name, const char *iface)
 Finds an interface from the list of interfaces. More...
 
int ConfSetRootAndDefaultNodes (const char *ifaces_node_name, const char *iface, ConfNode **if_root, ConfNode **if_default)
 Finds and sets root and default node of the interface. More...
 
ConfNodeConfNodeGetNodeOrCreate (ConfNode *parent, const char *name, int final)
 Helper function to get a node, creating it if it does not exist. More...
 

Detailed Description

Author
Endace Technology Limited - Jason Ish jason.nosp@m..ish.nosp@m.@enda.nosp@m.ce.c.nosp@m.om

Definition in file conf.h.

Macro Definition Documentation

◆ DEFAULT_DATA_DIR

#define DEFAULT_DATA_DIR   DATA_DIR

Definition at line 56 of file conf.h.

◆ DEFAULT_LOG_DIR

#define DEFAULT_LOG_DIR   "/var/log/suricata"

The default log directory.

Definition at line 55 of file conf.h.

Typedef Documentation

◆ ConfNode

typedef struct ConfNode_ ConfNode

Structure of a configuration parameter.

Function Documentation

◆ ConfCreateContextBackup()

void ConfCreateContextBackup ( void  )

Creates a backup of the conf_hash hash_table used by the conf API.

Definition at line 670 of file conf.c.

◆ ConfDeInit()

void ConfDeInit ( void  )

De-initializes the configuration system.

Definition at line 693 of file conf.c.

◆ ConfDump()

void ConfDump ( void  )

Dump configuration to stdout.

Definition at line 751 of file conf.c.

References ConfNodeDump().

Here is the call graph for this function:

◆ ConfGet()

int ConfGet ( const char *  name,
const char **  vptr 
)

Retrieve the value of a configuration node.

This function will return the value for a configuration node based on the full name of the node. It is possible that the value returned could be NULL, this could happen if the requested node does exist but is not a node that contains a value, but contains children ConfNodes instead.

Parameters
nameName of configuration parameter to get.
vptrPointer that will be set to the configuration value parameter. Note that this is just a reference to the actual value, not a copy.
Return values
1will be returned if the name is found, otherwise 0 will be returned.

Definition at line 335 of file conf.c.

References ConfGetNode(), SCLogDebug, and ConfNode_::val.

Referenced by ConfGetBool(), ConfGetDouble(), ConfGetFloat(), ConfGetInt(), ConfigGetDataDirectory(), ConfigGetLogDirectory(), ConfLoadCompleteIncludePath(), ConfSetBPFFilter(), ConfUnixSocketIsEnable(), CoredumpLoadConfig(), FlowInitConfig(), HTPParseMemcap(), HttpRangeContainersInit(), NFQInitConfig(), OutputJsonInitCtx(), PatternMatchDefaultMatcher(), PostConfLoadedSetup(), RunModeErfFileAutoFp(), RunModeErfFileSingle(), RunModeFilePcapAutoFp(), RunModeFilePcapSingle(), RunModeIdsAFPAutoFp(), RunModeIdsAFPSingle(), RunModeIdsAFPWorkers(), RunModeIdsAFXDPSingle(), RunModeIdsAFXDPWorkers(), RunModeIdsPcapAutoFp(), RunModeIdsPcapSingle(), RunModeIdsPcapWorkers(), RunModeInitializeThreadSettings(), SCLogLoadConfig(), SCRuleVarsGetConfVar(), SinglePatternMatchDefaultMatcher(), StreamTcpInitConfig(), and TmqhFlowRegister().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ ConfGetBool()

int ConfGetBool ( const char *  name,
int *  val 
)

Retrieve a configuration value as a boolean.

Parameters
nameName of configuration parameter to get.
valPointer to an int that will be set to 1 for true, or 0 for false.
Return values
1will be returned if the name is found and was properly converted to a boolean, otherwise 0 will be returned.

Definition at line 483 of file conf.c.

References ConfGet(), and ConfValIsTrue().

Referenced by DecodeERSPANConfig(), DecodeGeneveConfig(), DecodeTeredoConfig(), DecodeVXLANConfig(), DetectEngineFrameMpmRegister(), NapatechGetStreamConfig(), NapatechPacketLoop(), NFQInitConfig(), PostConfLoadedSetup(), RunModeInitializeThreadSettings(), SigPrepareStage4(), and StreamTcpInitConfig().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ ConfGetChildValue()

int ConfGetChildValue ( const ConfNode base,
const char *  name,
const char **  vptr 
)

Definition at line 348 of file conf.c.

◆ ConfGetChildValueBool()

int ConfGetChildValueBool ( const ConfNode base,
const char *  name,
int *  val 
)

Get a boolean value from the provided ConfNode.

Return values
1If the value exists, 0 if not.

Definition at line 501 of file conf.c.

◆ ConfGetChildValueBoolWithDefault()

int ConfGetChildValueBoolWithDefault ( const ConfNode base,
const ConfNode dflt,
const char *  name,
int *  val 
)

Definition at line 514 of file conf.c.

◆ ConfGetChildValueInt()

int ConfGetChildValueInt ( const ConfNode base,
const char *  name,
intmax_t *  val 
)

Definition at line 434 of file conf.c.

◆ ConfGetChildValueIntWithDefault()

int ConfGetChildValueIntWithDefault ( const ConfNode base,
const ConfNode dflt,
const char *  name,
intmax_t *  val 
)

Definition at line 462 of file conf.c.

◆ ConfGetChildValueWithDefault()

int ConfGetChildValueWithDefault ( const ConfNode base,
const ConfNode dflt,
const char *  name,
const char **  vptr 
)

Definition at line 378 of file conf.c.

Referenced by ConfSetBPFFilter().

Here is the caller graph for this function:

◆ ConfGetChildWithDefault()

ConfNode* ConfGetChildWithDefault ( const ConfNode base,
const ConfNode dflt,
const char *  name 
)

Definition at line 364 of file conf.c.

◆ ConfGetDouble()

int ConfGetDouble ( const char *  name,
double *  val 
)

Retrieve a configuration value as a double.

Parameters
nameName of configuration parameter to get.
valPointer to an double that will be set the configuration value.
Return values
1will be returned if the name is found and was properly converted to a double, otherwise 0 will be returned.

Definition at line 586 of file conf.c.

References ConfGet().

Here is the call graph for this function:

◆ ConfGetFloat()

int ConfGetFloat ( const char *  name,
float *  val 
)

Retrieve a configuration value as a float.

Parameters
nameName of configuration parameter to get.
valPointer to an float that will be set the configuration value.
Return values
1will be returned if the name is found and was properly converted to a double, otherwise 0 will be returned.

Definition at line 616 of file conf.c.

References ConfGet().

Referenced by RunModeInitializeThreadSettings().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ ConfGetInt()

int ConfGetInt ( const char *  name,
intmax_t *  val 
)

Retrieve a configuration value as an integer.

Parameters
nameName of configuration parameter to get.
valPointer to an intmax_t that will be set the configuration value.
Return values
1will be returned if the name is found and was properly converted to an integer, otherwise 0 will be returned.

Definition at line 399 of file conf.c.

References ConfGet(), and SCLogError.

Referenced by DecodeGlobalConfig(), DefragInit(), DetectLoadersInit(), FlowInitConfig(), FlowManagerThreadSpawn(), FlowRecyclerThreadSpawn(), NFQInitConfig(), PacketAlertGetMaxConfig(), SCProfilingInit(), and StreamTcpInitConfig().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ ConfGetNode()

◆ ConfGetRootNode()

ConfNode* ConfGetRootNode ( void  )

Get the root configuration node.

Definition at line 207 of file conf.c.

◆ ConfInit()

void ConfInit ( void  )

Initialize the configuration system.

Definition at line 120 of file conf.c.

Referenced by InitGlobal().

Here is the caller graph for this function:

◆ ConfLoadCompleteIncludePath()

char* ConfLoadCompleteIncludePath ( const char *  file)

Create the path for an include entry.

Parameters
fileThe name of the file
Return values
strPointer to the string path + sig_file

Definition at line 873 of file conf.c.

References ConfGet(), PathIsRelative(), SCLogDebug, SCMalloc, SCStrdup, strlcat(), strlcpy(), and unlikely.

Here is the call graph for this function:

◆ ConfNodeChildValueIsTrue()

int ConfNodeChildValueIsTrue ( const ConfNode node,
const char *  key 
)

Test if a configuration node has a true value.

Parameters
nodeThe parent configuration node.
nameThe name of the child node to test.
Return values
1if the child node has a true value, otherwise 0 is returned, even if the child node does not exist.

Definition at line 859 of file conf.c.

References ConfNodeLookupChildValue(), and ConfValIsTrue().

Referenced by HttpXFFGetCfg(), PcapLogProfileSetup(), SCProfilingKeywordsGlobalInit(), SCProfilingPrefilterGlobalInit(), and SCProfilingSghsGlobalInit().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ ConfNodeDump()

void ConfNodeDump ( const ConfNode node,
const char *  prefix 
)

Dump a configuration node and all its children.

Definition at line 721 of file conf.c.

References ConfNode_::name, next, SCStrdup, TAILQ_FOREACH, and unlikely.

Referenced by ConfDump().

Here is the caller graph for this function:

◆ ConfNodeFree()

void ConfNodeFree ( ConfNode node)

Free a ConfNode and all of its children.

Parameters
nodeThe configuration node to SCFree.

Definition at line 157 of file conf.c.

References ConfNodeFree(), ConfNode_::name, next, SCFree, TAILQ_FIRST, TAILQ_REMOVE, and ConfNode_::val.

Referenced by ConfNodeFree(), ConfNodeGetNodeOrCreate(), and ConfNodeRemove().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ ConfNodeGetNodeOrCreate()

ConfNode* ConfNodeGetNodeOrCreate ( ConfNode parent,
const char *  name,
int  final 
)

Helper function to get a node, creating it if it does not exist.

This function exits on memory failure as creating configuration nodes is usually part of application initialization.

Parameters
parentThe node to use as the parent
nameThe name of the configuration node to get.
finalFlag to set created nodes as final or not.
Return values
Theexisting configuration node if it exists, or a newly created node for the provided name. On error, NULL will be returned.

Definition at line 66 of file conf.c.

References ConfNodeFree(), ConfNodeLookupChild(), ConfNodeNew(), ConfNode_::final, ConfNode_::name, next, NODE_NAME_MAX, ConfNode_::parent, SCLogError, SCLogWarning, SCStrdup, strlcpy(), TAILQ_INSERT_TAIL, and unlikely.

Here is the call graph for this function:

◆ ConfNodeHasChildren()

bool ConfNodeHasChildren ( const ConfNode node)

Check if a node has any children.

Checks if the provided node has any children. Any node that is a YAML map or array will have children.

Parameters
nodeThe node to check.
Return values
trueif node has children
falseif node does not have children

Definition at line 767 of file conf.c.

References TAILQ_EMPTY.

◆ ConfNodeIsSequence()

int ConfNodeIsSequence ( const ConfNode node)

Check if a node is a sequence or node.

Parameters
nodethe node to check.
Returns
1 if node is a sequence, otherwise 0.

Definition at line 946 of file conf.c.

References ConfNode_::is_seq.

◆ ConfNodeLookupChild()

ConfNode* ConfNodeLookupChild ( const ConfNode node,
const char *  name 
)

Lookup a child configuration node by name.

Given a ConfNode this function will lookup an immediate child ConfNode by name and return the child ConfNode.

Parameters
nodeThe parent configuration node.
nameThe name of the child node to lookup.
Return values
Apointer the child ConfNode if found otherwise NULL.

Definition at line 786 of file conf.c.

References ConfNode_::name, next, and TAILQ_FOREACH.

Referenced by AppLayerProtoDetectPPParseConfPorts(), ConfNodeGetNodeOrCreate(), ConfNodeLookupChildValue(), FileForceHashParseCfg(), FlowInitFlowProto(), HttpXFFGetCfg(), OutputEmailInitConf(), and SCConfLogOpenGeneric().

Here is the caller graph for this function:

◆ ConfNodeLookupChildValue()

const char* ConfNodeLookupChildValue ( const ConfNode node,
const char *  name 
)

Lookup the value of a child configuration node by name.

Given a parent ConfNode this function will return the value of a child configuration node by name returning a reference to that value.

Parameters
nodeThe parent configuration node.
nameThe name of the child node to lookup.
Return values
Apointer the child ConfNodes value if found otherwise NULL.

Definition at line 814 of file conf.c.

References ConfNodeLookupChild(), and ConfNode_::val.

Referenced by ConfNodeChildValueIsTrue(), FileForceHashParseCfg(), FlowInitFlowProto(), HttpXFFGetCfg(), LogHttpLogInitCtx(), LogTcpDataLogInitCtx(), OutputEmailInitConf(), OutputJsonInitCtx(), SCConfLogOpenGeneric(), SCProfilingKeywordsGlobalInit(), SCProfilingPrefilterGlobalInit(), and SCProfilingSghsGlobalInit().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ ConfNodeLookupKeyValue()

ConfNode* ConfNodeLookupKeyValue ( const ConfNode base,
const char *  key,
const char *  value 
)

Lookup for a key value under a specific node.

Returns
the ConfNode matching or NULL

Definition at line 831 of file conf.c.

◆ ConfNodeNew()

ConfNode* ConfNodeNew ( void  )

Allocate a new configuration node.

Return values
Anallocated configuration node on success, NULL on failure.

Definition at line 139 of file conf.c.

References SCCalloc, TAILQ_INIT, and unlikely.

Referenced by ConfNodeGetNodeOrCreate().

Here is the caller graph for this function:

◆ ConfNodePrune()

void ConfNodePrune ( ConfNode node)

Prune a configuration node.

Pruning a configuration is similar to freeing, but only fields that may be overridden are, leaving final type parameters. Additional the value of the provided node is also free'd, but the node itself is left.

Parameters
nodeThe configuration node to prune.

Definition at line 914 of file conf.c.

References ConfNodePrune(), ConfNode_::final, ConfNode_::name, next, SCFree, TAILQ_EMPTY, TAILQ_FIRST, TAILQ_NEXT, TAILQ_REMOVE, and ConfNode_::val.

Referenced by ConfNodePrune().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ ConfNodeRemove()

void ConfNodeRemove ( ConfNode )

Remove (and SCFree) the provided configuration node.

Definition at line 639 of file conf.c.

References ConfNodeFree(), next, ConfNode_::parent, and TAILQ_REMOVE.

Referenced by ConfRemove().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ ConfRegisterTests()

void ConfRegisterTests ( void  )

Definition at line 1492 of file conf.c.

References UtRegisterTest().

Here is the call graph for this function:

◆ ConfRemove()

int ConfRemove ( const char *  name)

Remove a configuration parameter from the configuration db.

Parameters
nameThe name of the configuration parameter to remove.
Return values
Returns1 if the parameter was removed, otherwise 0 is returned most likely indicating the parameter was not set.

Definition at line 654 of file conf.c.

References ConfGetNode(), and ConfNodeRemove().

Here is the call graph for this function:

◆ ConfRestoreContextBackup()

void ConfRestoreContextBackup ( void  )

Restores the backup of the hash_table present in backup_conf_hash back to conf_hash.

Definition at line 682 of file conf.c.

◆ ConfSet()

int ConfSet ( const char *  name,
const char *  val 
)

Set a configuration value.

Configuration values set with this function may be overridden by subsequent calls, or if the value appears multiple times in a configuration file.

Parameters
nameThe name of the configuration parameter to set.
valThe value of the configuration parameter.
Return values
1if the value was set otherwise 0.

Definition at line 224 of file conf.c.

Referenced by ConfSetFromString(), and PostConfLoadedSetup().

Here is the caller graph for this function:

◆ ConfSetFinal()

int ConfSetFinal ( const char *  name,
const char *  val 
)

Set a final configuration value.

A final configuration value is a value that cannot be overridden by the configuration file. Its mainly useful for setting values that are supplied on the command line prior to the configuration file being loaded. However, a subsequent call to this function can override a previously set value.

Parameters
nameThe name of the configuration parameter to set.
valThe value of the configuration parameter.
Return values
1if the value was set otherwise 0.

Definition at line 303 of file conf.c.

Referenced by ConfigSetDataDirectory(), ConfigSetLogDirectory(), and ConfSetFromString().

Here is the caller graph for this function:

◆ ConfSetFromString()

int ConfSetFromString ( const char *  input,
int  final 
)

Set a configuration parameter from a string.

Where the input string is something like: stream.midstream=true

Parameters
inputthe input string to be parsed.
Return values
1if the value of set, otherwise 0.

Definition at line 249 of file conf.c.

References ConfSet(), ConfSetFinal(), SCFree, SCStrdup, and unlikely.

Here is the call graph for this function:

◆ ConfSetIfaceNode()

ConfNode* ConfSetIfaceNode ( const char *  ifaces_node_name,
const char *  iface 
)

Finds an interface from the list of interfaces.

Parameters
ifaces_node_name- name of the node which holds a list of interfaces
iface- interfaces name
Returns
NULL on failure otherwise a valid pointer

Definition at line 957 of file conf.c.

References ConfFindDeviceConfig(), ConfGetNode(), SCLogError, and SCLogNotice.

Referenced by ConfSetRootAndDefaultNodes().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ ConfSetRootAndDefaultNodes()

int ConfSetRootAndDefaultNodes ( const char *  ifaces_node_name,
const char *  iface,
ConfNode **  if_root,
ConfNode **  if_default 
)

Finds and sets root and default node of the interface.

Parameters
ifaces_node_nameNode which holds list of interfaces
ifaceName of the interface e.g. eth3
if_rootNode which will hold the interface configuration
if_defaultNode which is the default configuration in the given list of interfaces
Returns
0 on success, -ENODEV when neither the root interface nor the default interface was found

Definition at line 983 of file conf.c.

References ConfSetIfaceNode(), and SCLogError.

Here is the call graph for this function:

◆ ConfValIsFalse()

int ConfValIsFalse ( const char *  val)

Check if a value is false.

The value is considered false if it is a string with the value of 0, no, false or off. The test is not case sensitive, any other value is not false.

Parameters
valThe string to test for a false value.
Return values
1If the value is false, 0 if not.

Definition at line 562 of file conf.c.

Referenced by AppLayerParserConfParserEnabled(), AppLayerProtoDetectConfProtoDetectionEnabledDefault(), and SCConfLogOpenGeneric().

Here is the caller graph for this function:

◆ ConfValIsTrue()

int ConfValIsTrue ( const char *  val)

Check if a value is true.

The value is considered true if it is a string with the value of 1, yes, true or on. The test is not case sensitive, any other value is false.

Parameters
valThe string to test for a true value.
Return values
1If the value is true, 0 if not.

Definition at line 537 of file conf.c.

Referenced by AppLayerParserConfParserEnabled(), AppLayerProtoDetectConfProtoDetectionEnabledDefault(), ConfGetBool(), ConfNodeChildValueIsTrue(), ConfUnixSocketIsEnable(), FileForceHashParseCfg(), LogHttpLogInitCtx(), and OutputEmailInitConf().

Here is the caller graph for this function: