--- libaitcfg/inc/aitcfg.h 2008/08/28 13:17:41 1.1 +++ libaitcfg/inc/aitcfg.h 2011/05/01 17:23:29 1.5.2.1 @@ -1,3 +1,48 @@ +/************************************************************************* +* (C) 2008 AITNET ltd - Sofia/Bulgaria - +* by Michael Pounov +* +* $Author: misho $ +* $Id: aitcfg.h,v 1.5.2.1 2011/05/01 17:23:29 misho Exp $ +* +************************************************************************** +The ELWIX and AITNET software is distributed under the following +terms: + +All of the documentation and software included in the ELWIX and AITNET +Releases is copyrighted by ELWIX - Sofia/Bulgaria + +Copyright 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011 + by Michael Pounov . All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions +are met: +1. Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. +2. 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. +3. All advertising materials mentioning features or use of this software + must display the following acknowledgement: +This product includes software developed by Michael Pounov +ELWIX - Embedded LightWeight unIX and its contributors. +4. Neither the name of AITNET nor the names of its contributors + may be used to endorse or promote products derived from this software + without specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY AITNET 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 REGENTS 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. +*/ #ifndef __AITCFG_H #define __AITCFG_H @@ -17,12 +62,27 @@ typedef struct tagHead sl_config; /* + * Macros for config library. Typecast string to specific config string format. +*/ +#define CFG(x) (unsigned char *)(x) + +#define CFG_ISSET(x) ((long) cfg_FirstItem((x))) + + +/* * InitConfig() Head initializing function for config * @cfg = New head element for init * return: 0 ok; -1 error:: new head element is null */ inline int InitConfig(sl_config * __restrict cfg); /* + * cfg_CreateConfig() Create config file from memory without whitespaces! + * @csConfigName = New config filename + * @cfg = Head list element + * return: 0 ok; -1 error:: can`t save new config +*/ +int cfg_CreateConfig(const char *csConfigName, sl_config * __restrict cfg); +/* * CreateConfig() Create config file from memory * @csConfigName = New config filename * @cfg = Head list element @@ -64,8 +124,32 @@ int ReadConfig(FILE *f, sl_config * __restrict cfg); */ int WriteConfig(FILE *f, sl_config * __restrict cfg); +/* + * cfg_WriteConfig() Write to file from items in config list without whitespaces! + * @f = file resource + * @cfg = Head list element + * return: 0 ok; -1 error:: can`t write to file +*/ +int cfg_WriteConfig(FILE *f, sl_config * __restrict cfg); /* + * ConcatConfig() Concat two list in one + * @cfg = Head list element of main list + * @add_cfg = Head list element of added list + * return: 0 ok; -1 error:: can`t concat lists +*/ +int ConcatConfig(sl_config * __restrict cfg, sl_config * __restrict add_cfg); + +/* + * MergeConfig() Marge two list in one cfg and destroy add_cfg + * @cfg = Head list element of main list + * @add_cfg = Head list element of merged list (destroy after all!) + * return: 0 ok; -1 error:: can`t merge lists +*/ +int MergeConfig(sl_config * __restrict cfg, sl_config * __restrict add_cfg); + + +/* * cfg_FindAttribute() Find attribute position in config list * @cfg = Head list element * @csSec = Config section //[{csSec}] @@ -98,6 +182,13 @@ int cfg_UnsetAttribute(sl_config * __restrict cfg, con * return: NULL item not found or null parameters; !=NULL value const string */ inline const u_char *cfg_GetAttribute(sl_config * __restrict cfg, const u_char *csSec, const u_char *csAttr); + +/* + * cfg_FirstItem() Get first item from config list and return his value + * @cfg = Head list element + * return: NULL if no items in list; !=NULL first pair item +*/ +inline struct tagPair *cfg_FirstItem(sl_config * __restrict cfg); /* * cfg_LoadAttribute() Extended get attribute, if not found item return *default value*