mirror of
https://github.com/signalwire/freeswitch.git
synced 2025-02-14 22:19:14 +00:00
526cb45c93
git-svn-id: http://svn.openzap.org/svn/openzap/branches/sangoma_boost@970 a93c3328-9c30-0410-af19-c9cd2b2d52af
146 lines
4.1 KiB
C
146 lines
4.1 KiB
C
/*
|
|
* Copyright (c) 2007, Anthony Minessale II
|
|
* All rights reserved.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions
|
|
* are met:
|
|
*
|
|
* * Redistributions of source code must retain the above copyright
|
|
* notice, this list of conditions and the following disclaimer.
|
|
*
|
|
* * Redistributions in binary form must reproduce the above copyright
|
|
* notice, this list of conditions and the following disclaimer in the
|
|
* documentation and/or other materials provided with the distribution.
|
|
*
|
|
* * Neither the name of the original author; nor the names of any contributors
|
|
* may be used to endorse or promote products derived from this software
|
|
* without specific prior written permission.
|
|
*
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
|
* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
|
* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
|
|
* A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER
|
|
* OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
|
|
* EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
|
|
* PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
|
|
* PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
|
|
* LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
|
|
* NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
|
|
* SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
*/
|
|
|
|
/**
|
|
* @defgroup config Config File Parser
|
|
* @ingroup config
|
|
* This module implements a basic interface and file format parser
|
|
*
|
|
* <pre>
|
|
*
|
|
* EXAMPLE
|
|
*
|
|
* [category1]
|
|
* var1 => val1
|
|
* var2 => val2
|
|
* \# lines that begin with \# are comments
|
|
* \#var3 => val3
|
|
* </pre>
|
|
* @{
|
|
*/
|
|
|
|
#ifndef FTDM_CONFIG_H
|
|
#define FTDM_CONFIG_H
|
|
|
|
#include "freetdm.h"
|
|
#define FTDM_URL_SEPARATOR "://"
|
|
|
|
|
|
#ifdef WIN32
|
|
#define FTDM_PATH_SEPARATOR "\\"
|
|
#ifndef FTDM_CONFIG_DIR
|
|
#define FTDM_CONFIG_DIR "c:\\freetdm"
|
|
#endif
|
|
#define ftdm_is_file_path(file) (*(file +1) == ':' || *file == '/' || strstr(file, SWITCH_URL_SEPARATOR))
|
|
#else
|
|
#define FTDM_PATH_SEPARATOR "/"
|
|
#ifndef FTDM_CONFIG_DIR
|
|
#define FTDM_CONFIG_DIR "/etc/freetdm"
|
|
#endif
|
|
#define ftdm_is_file_path(file) ((*file == '/') || strstr(file, SWITCH_URL_SEPARATOR))
|
|
#endif
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
typedef struct ftdm_config ftdm_config_t;
|
|
|
|
/*! \brief A simple file handle representing an open configuration file **/
|
|
struct ftdm_config {
|
|
/*! FILE stream buffer to the opened file */
|
|
FILE *file;
|
|
/*! path to the file */
|
|
char path[512];
|
|
/*! current category */
|
|
char category[256];
|
|
/*! current section */
|
|
char section[256];
|
|
/*! buffer of current line being read */
|
|
char buf[1024];
|
|
/*! current line number in file */
|
|
int lineno;
|
|
/*! current category number in file */
|
|
int catno;
|
|
/*! current section number in file */
|
|
int sectno;
|
|
|
|
int lockto;
|
|
};
|
|
|
|
/*!
|
|
\brief Open a configuration file
|
|
\param cfg (ftdm_config_t *) config handle to use
|
|
\param file_path path to the file
|
|
\return 1 (true) on success 0 (false) on failure
|
|
*/
|
|
int ftdm_config_open_file(ftdm_config_t * cfg, const char *file_path);
|
|
|
|
/*!
|
|
\brief Close a previously opened configuration file
|
|
\param cfg (ftdm_config_t *) config handle to use
|
|
*/
|
|
void ftdm_config_close_file(ftdm_config_t * cfg);
|
|
|
|
/*!
|
|
\brief Retrieve next name/value pair from configuration file
|
|
\param cfg (ftdm_config_t *) config handle to use
|
|
\param var pointer to aim at the new variable name
|
|
\param val pointer to aim at the new value
|
|
*/
|
|
int ftdm_config_next_pair(ftdm_config_t * cfg, char **var, char **val);
|
|
|
|
/*!
|
|
\brief Retrieve the CAS bits from a configuration string value
|
|
\param strvalue pointer to the configuration string value (expected to be in format whatever:xxxx)
|
|
\param outbits pointer to aim at the CAS bits
|
|
*/
|
|
FT_DECLARE (int) ftdm_config_get_cas_bits(char *strvalue, unsigned char *outbits);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
/** @} */
|
|
#endif
|
|
/* For Emacs:
|
|
* Local Variables:
|
|
* mode:c
|
|
* indent-tabs-mode:t
|
|
* tab-width:4
|
|
* c-basic-offset:4
|
|
* End:
|
|
* For VIM:
|
|
* vim:set softtabstop=4 shiftwidth=4 tabstop=4:
|
|
*/
|