--- libaitcfg/inc/aitcfg.h	2014/01/30 08:30:47	1.13
+++ libaitcfg/inc/aitcfg.h	2014/03/19 17:00:51	1.14.2.2
@@ -3,7 +3,7 @@
 *  by Michael Pounov <misho@openbsd-bg.org>
 *
 * $Author: misho $
-* $Id: aitcfg.h,v 1.13 2014/01/30 08:30:47 misho Exp $
+* $Id: aitcfg.h,v 1.14.2.2 2014/03/19 17:00:51 misho Exp $
 *
 **************************************************************************
 The ELWIX and AITNET software is distributed under the following
@@ -85,11 +85,17 @@ const char *cfg_GetError();
 /*
  * cfgInitConfig() - Init config root
  *
- * @cfg = Config root
- * return: -1 error or 0 ok
+ * return: NULL error or !=NULL allocated config root
  */
-int cfgInitConfig(cfg_root_t * __restrict cfg);
+cfg_root_t *cfgInitConfig();
 /*
+ * cfgEndConfig() - Free resources & config root
+ *
+ * @pcfg = Config root
+ * return: none
+ */
+void cfgEndConfig(cfg_root_t **pcfg);
+/*
  * cfgLoadConfig() - Load config from file
  *
  * @cfgName = Config filename
@@ -180,11 +186,19 @@ int cfgConcatConfig(cfg_root_t * __restrict cfg, cfg_r
 int cfgMergeConfig(cfg_root_t * __restrict cfg, cfg_root_t * __restrict add_cfg);
 
 /*
+ * cfg_getSection() - Get entire section attributes into array
+ *
+ * @cfg = Config root
+ * @csSec = Config section //[{csSec}]
+ * return: NULL not found or !=NULL allocated array, must free with array_Destroy() after use!
+ */
+array_t *cfg_getSection(cfg_root_t * __restrict cfg, const char *csSec);
+/*
  * cfg_findAttribute() - Find attribute position in config file
  *
  * @cfg = Config root
  * @csSec = Config section //[{csSec}]
- * @csAttr = Config attribute //{csAttr} = ...
+ * @csAttr = Config attribute //{csAttr} = ..., if NULL as *any* attribute
  * return: 0 not found item, -1 error or >0 position in list
  */
 int cfg_findAttribute(cfg_root_t * __restrict cfg, 
@@ -194,7 +208,7 @@ int cfg_findAttribute(cfg_root_t * __restrict cfg, 
  *
  * @cfg = Config root
  * @csSec = Config section //[{csSec}], if NULL unset in *default* section
- * @csAttr = Config attribute //{csAttr} = ..., if NULL unset as *any* attribute
+ * @csAttr = Config attribute //{csAttr} = ..., if NULL as *any* attribute
  * return: NULL item not found or null parameters, !=NULL value const string
  */
 const char *cfg_getAttribute(cfg_root_t * __restrict cfg, 
@@ -215,7 +229,7 @@ int cfg_setAttribute(cfg_root_t * __restrict cfg, cons
  *
  * @cfg = Config root
  * @csSec = Config section //[{csSec}], if NULL unset in *default* section
- * @csAttr = Config attribute //{csAttr} = ...
+ * @csAttr = Config attribute //{csAttr} = ..., if NULL as *any* attribute
  * return: 0 item not found, -1 error or 1 removed item
  */
 int cfg_unsetAttribute(cfg_root_t * __restrict cfg, const char *csSec, 
@@ -226,7 +240,7 @@ int cfg_unsetAttribute(cfg_root_t * __restrict cfg, co
  *
  * @cfg = Config root
  * @csSec = Config section //[{csSec}], if NULL unset in *default* section
- * @csAttr = Config attribute //{csAttr} = ...
+ * @csAttr = Config attribute //{csAttr} = ..., if NULL as *any* attribute
  * @val = Return buffer for item Value //... = {val}
  * @csDefValue = *Default Value* for return in //{val}, if not found item in config
  * return: 0 item not found, -1 error or >0 number of copied bytes in //{val}