getcb.h

Go to the documentation of this file.

/*
 * Copyright (c) 2008 - 2012, Andy Bierman, All Rights Reserved.
 * Copyright (c) 2012 - 2023, YumaWorks, Inc., All Rights Reserved.
 *
 * 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.
 */
#ifndef _H_getcb
#define _H_getcb
 
/*  FILE: getcb.h
*********************************************************************
*                                                                   *
*                        P U R P O S E                              *
*                                                                   *
*********************************************************************/
 
/*********************************************************************
*                                                                   *
*                  C H A N G E   H I S T O R Y                      *
*                                                                   *
*********************************************************************
 
date         init     comment
----------------------------------------------------------------------
16-apr-07    abb      Begun; split out from agt_ps.h
 
*/
 
#ifndef _H_ncxconst
#include "ncxconst.h"
#endif
 
#ifndef _H_obj
#include "obj.h"
#endif
 
#ifndef _H_rpc
#include "rpc.h"
#endif
 
#ifndef _H_ses
#include "ses.h"
#endif
 
#ifndef _H_status_enum
#include "status_enum.h"
#endif
 
#ifndef _H_val
#include "val.h"
#endif
 
#ifndef _H_val_util
#include "val_util.h"
#endif
 
#ifdef __cplusplus
extern "C" {
#endif
 
 
/********************************************************************
*                                                                   *
*                        C O N S T A N T S                          *
*                                                                   *
*********************************************************************/
 
/* input parameter macros */
#define GETCB_GET2_TXID_STR(G)                  (G)->txid_str
#define GETCB_GET2_OBJ(G)                       (G)->obj
#define GETCB_GET2_TESTFN(G)                    (G)->testfn
#define GETCB_GET2_KEYQ(G)                      &(G)->keyQ
#define GETCB_GET2_MATCHQ(G)                    &(G)->matchQ
#define GETCB_GET2_SELECTQ(G)                   &(G)->selectQ
#define GETCB_GET2_RETURN_KEYQ(G)               &(G)->return_keyQ
#define GETCB_GET2_RETURN_VALQ(G)               &(G)->return_valQ
#define GETCB_GET2_GETBULKQ(G)                  &(G)->getbulkQ
#define GETCB_GET2_CBMODE(G)                    (G)->cbmode
#define GETCB_GET2_MAX_ENTRIES(G)               (G)->max_entries
#define GETCB_GET2_MAX_LEVELS(G)                (G)->max_levels
#define GETCB_GET2_OPER_DATA(G)                 (G)->oper_data
#define GETCB_GET2_CONFIG_DATA(G)               (G)->config_data
#define GETCB_GET2_PRE_PROCESS(G)               (G)->pre_process
#define GETCB_GET2_EXPAND_VAREXPR(G)            (G)->expand_varexpr
#define GETCB_GET2_KEYS_ONLY(G)                 (G)->keys_only
#define GETCB_GET2_WITH_DEFAULTS(G)             (G)->with_defaults
#define GETCB_GET2_SELECT(G)                    (G)->select_only
#define GETCB_GET2_API_MODE(G)                  (G)->api_mode
#define GETCB_GET2_WITH_ORIGIN(G)               (G)->with_origin
 
/* internal state data macros */
#define GETCB_GET2_START_ADD_KEY(G)             (G)->start_add_key
#define GETCB_GET2_ACMTEST_RESULT(G)            (G)->acmtest_result
#define GETCB_GET2_FIRST_SIBLING(G)             (G)->first_sibling
#define GETCB_GET2_FIRST_LL_SIBLING(G)          (G)->first_llsibling
#define GETCB_GET2_LAST_LL_SIBLING(G)           (G)->last_llsibling
#define GETCB_GET2_LAST_SIBLING(G)              (G)->last_sibling
#define GETCB_GET2_FIRST_CHILD(G)               (G)->first_child
#define GETCB_GET2_FIRST_NOKEY_CHILD(G)         (G)->isfirst_nokey
#define GETCB_GET2_FIRST(G)                     (G)->isfirst
#define GETCB_GET2_LAST(G)                      (G)->islast
#define GETCB_GET2_WROTE_LIST(G)                (G)->wrote_some_lists
#define GETCB_GET2_FINISH_LIST(G)               (G)->finish_list
 
/* return data macros */
#define GETCB_GET2_MORE_DATA(G)                 (G)->more_data
#define GETCB_GET2_ACTIVE_CASE_MODNAME(G)       (G)->active_case_modname
#define GETCB_GET2_ACTIVE_CASE(G)               (G)->active_case
#define GETCB_GET2_PARENT_VAL(G)                (G)->parent_val
#define GETCB_GET2_PARENT_CB(G)                 (G)->parent_cb
#define GETCB_GET2_REMOVE_KEY(G,C)              dlq_remove(C)
#define GETCB_GET2_REMOVE_MATCH(G,C)            dlq_remove(C)
#define GETCB_GET2_REMOVE_VAL(G,C)              dlq_remove(C)
 
 
#define GETCB_GET2_FIRST_KEY(G)                 \
    (val_value_t *)dlq_firstEntry(&(G)->keyQ)
 
#define GETCB_GET2_NEXT_KEY(G,C)                \
    (val_value_t *)dlq_nextEntry(C)
 
#define GETCB_GET2_FIRST_MATCH(G)               \
    (val_value_t *)dlq_firstEntry(&(G)->matchQ)
 
#define GETCB_GET2_NEXT_MATCH(G,C)              \
    (val_value_t *)dlq_nextEntry(C)
 
#define GETCB_GET2_FIRST_SELECT(G)              \
    (getcb_get2_select_t *)dlq_firstEntry(&(G)->selectQ)
 
#define GETCB_GET2_NEXT_SELECT(G,C)             \
    (getcb_get2_select_t *)dlq_nextEntry(C)
 
#define GETCB_GET2_MATCH_TEST_DONE(G)           (G)->match_test_done
 
#define GETCB_GET2_RETURN_VAL(G)                &(G)->return_val
 
#define GETCB_GET2_RETURN_VAL_SET(G)            \
    ((G)->return_val.btyp != NCX_BT_NONE)
 
#define GETCB_GET2_FIRST_RETURN_KEY(G)          \
    (val_value_t *)dlq_firstEntry(&(G)->return_keyQ)
 
#define GETCB_GET2_NEXT_RETURN_KEY(G,C)         \
    (val_value_t *)dlq_nextEntry(C)
 
#define GETCB_GET2_FIRST_RETURN_VAL(G)          \
    (val_value_t *)dlq_firstEntry(&(G)->return_valQ)
 
#define GETCB_GET2_NEXT_RETURN_VAL(G,C)         \
    (val_value_t *)dlq_nextEntry(C)
 
#define GETCB_GET2_RESPONSEQ(G)   &(G)->responseQ
 
#define GETCB_GET2_FIRST_RESPONSE(G)            \
    (getcb_get2_t *)dlq_firstEntry(&(G)->responseQ)
 
#define GETCB_GET2_NEXT_RESPONSE(G,C)           \
    (getcb_get2_t *)dlq_nextEntry(C)
 
#define GETCB_GET2_REMOVE_RESPONSE(G,C)         dlq_remove(C)
 
 
#define GETCB_GET2_FIRST_GETBULK(G)             \
    (getcb_get2_getbulk_t *)dlq_firstEntry(&(G)->getbulkQ)
 
#define GETCB_GET2_NEXT_GETBULK(G,C)            \
    (getcb_get2_getbulk_t *)dlq_nextEntry(C)
 
#define GETCB_GET2_DATASTORE(G)   (G)->nmda_ds
 
#define GETCB_GET2_ORIGIN(G)   (G)->nmda_origin
 
 
/* All in One Queue Macros */
#define GETCB_GET2_RETURN_AIOQ(G)               &(G)->return_aioQ
#define GETCB_AIO_ENCODING(G)                   (G)->aio_encoding
#define GETCB_AIO_BUFFER(G)                     (G)->aio_return_buff
 
#define GETCB_GET2_FIRST_RETURN_AIO_VAL(G)     \
    (val_value_t *)dlq_firstEntry(&(G)->return_aioQ)
 
#define GETCB_GET2_NEXT_RETURN_AIO_VAL(C)    \
    (val_value_t *)dlq_nextEntry(C)
 
#define GETCB_GET2_USER_DATA_REF(G)   (G)->user_data_ref
 
#define GETCB_GET2_USER_DATA_INDEX(G)   (G)->user_data_index
 
/* Schema mount MPID field
 * The parameter G is a getcb_get2_t *
 */
#define GETCB_GET2_SM_MPID(G)  (G)->sm_mpid
 
#define GETCB_GET2_SM_MPID_MALLOCED(G)  (G)->sm_mpid_malloced
 
#define GETCB_FLAG_KEYS (const xmlChar *)"keys"
#define GETCB_FLAG_CONFIG (const xmlChar *)"config"
#define GETCB_FLAG_OPER (const xmlChar *)"oper"
#define GETCB_FLAG_GETNEXT (const xmlChar *)"getnext"
#define GETCB_FLAG_WITHDEF (const xmlChar *)"withdef"
#define GETCB_FLAG_SELECT (const xmlChar *)"select"
#define GETCB_FLAG_WITH_ORIGIN (const xmlChar *)"with-origin"
#define GETCB_FLAG_PRE_PROCESS (const xmlChar *)"pre-process"
 
 
/********************************************************************
*                                                                   *
*                            T Y P E S                              *
*                                                                   *
*********************************************************************/
 
typedef enum getcb_mode_t_ {
    GETCB_NONE,               
    GETCB_GET_VALUE,          
    GETCB_GETNEXT_VALUE       
} getcb_mode_t;
 
 
/* get2 walker callback modes for the 'normal' API mode */
typedef enum getcb_api_mode_t_ {
    GETCB_API_MODE_NONE,
    GETCB_API_MODE_NORMAL,
    GETCB_API_MODE_1SHOT,
    GETCB_API_MODE_CHOICE,
    GETCB_API_MODE_CONFIG_NODE,     // config=true node
    GETCB_API_MODE_ALL_IN_ONE,      // All in One retrieval
    GETCB_API_MODE_ALL_IN_ONE_1SHOT
} getcb_api_mode_t;
 
 
typedef enum getcb_walker_mode_t_ {
    GETCB_WALK_MODE_NONE,
 
    /* get2 walker callback modes for the 'normal' API mode */
    GETCB_WALK_MODE_START,
    GETCB_WALK_MODE_TERM,
    GETCB_WALK_MODE_END,
 
    /* get2 walker callback mode for the '1shot' API mode */
    GETCB_WALK_MODE_1SHOT,
 
    /* get2 walker callback mode for pre-get choices API mode */
    GETCB_WALK_MODE_CHOICE
} getcb_walker_mode_t;
 
 
typedef enum getcb_walker_status_t_ {
    GETCB_WALK_STAT_NONE,
    GETCB_WALK_STAT_CONTINUE,
    GETCB_WALK_STAT_STOP_INSTANCE,
    GETCB_WALK_STAT_STOP_OBJECT,
    GETCB_WALK_STAT_STOP_WALK
} getcb_walker_status_t;
 
 
typedef struct getcb_keyval_t_ {
    dlq_hdr_t           qhdr;       
    xmlChar             *value;     
    val_value_t         *valnode;   
    obj_template_t      *objnode;   
    boolean             fixed_value; 
} getcb_keyval_t;
 
 
typedef struct getcb_get2_lookup_t_ {
    dlq_hdr_t           qhdr;   
    obj_template_t      *obj;  
    dlq_hdr_t           keyvalQ;  
    boolean             full_lookup;  
} getcb_get2_lookup_t;
 
 
typedef struct getcb_get2_select_t_ {
    dlq_hdr_t           qhdr;   
    const xmlChar       *modname;   
    const xmlChar       *objname;   
} getcb_get2_select_t;
 
 
typedef struct getcb_get2_getbulk_t_ {
    dlq_hdr_t           qhdr;   
    dlq_hdr_t           return_keyQ;
 
    dlq_hdr_t           return_valQ;
} getcb_get2_getbulk_t;
 
 
typedef struct getcb_get2_t_ {
    dlq_hdr_t                   qhdr;  
    /**********  I N P U T  P A R A M E T E R S   *******/
 
    xmlChar                     *txid_str;
 
    obj_template_t              *obj;
 
    val_nodetest_fn_t           testfn;
 
    dlq_hdr_t                   keyQ;
 
    dlq_hdr_t                   matchQ;
 
    dlq_hdr_t                   selectQ;  
    getcb_mode_t                cbmode;
 
    uint32                      max_entries;
 
    uint32                      max_levels;
 
    boolean                     oper_data;
 
    boolean                     config_data;
 
    boolean                     expand_varexpr;
 
    boolean                     keys_only;
 
    boolean                     select_only;
 
    boolean                     with_defaults;
 
    getcb_api_mode_t            api_mode;
 
    boolean                     with_origin;
 
    /**********  I N T E R N A L   S T A T E   D A T A   *******/
 
    val_value_t                 *start_add_key;
 
    boolean                     acmtest_result;
 
    boolean                     last_sibling;
 
    boolean                     isfirst_nokey;
    boolean                     first_llsibling; 
    boolean                     last_llsibling;  
 
    boolean                     islast;   
    boolean                     isfirst;  
    boolean                     aio_done; 
    boolean                     first_child;   
    boolean                     first_sibling;  
    boolean                     force_lastsibling;  
    boolean                     force_lastsib_value;  
    boolean                     force_array_obj;  
 
    boolean                     finish_list;
 
    /**********  C A L L B A C K   R E T U R N   D A T A   *******/
 
    boolean                     more_data;
 
    dlq_hdr_t                   getbulkQ;   
    xmlChar                     *active_case_modname;
    xmlChar                     *active_case;   
 
    dlq_hdr_t                   return_keyQ;
 
    dlq_hdr_t                   return_valQ;
 
    val_value_t                 return_val;
 
    dlq_hdr_t                   responseQ;   // Q of getcb_get2_t structs
 
    boolean                     match_test_done;
 
    boolean                     wrote_some_lists;
 
    val_value_t                 *parent_val;
 
    struct getcb_get2_t_        *parent_cb;  
 
    dlq_hdr_t                   return_aioQ;
 
    ncx_nmda_ds_t               nmda_ds;
 
    ncx_nmda_origin_t           nmda_origin;
 
    ncx_msg_encoding_t          aio_encoding;
 
    xmlChar                     *aio_return_buff;
 
 
    ncx_sm_mpid_t               *sm_mpid;
 
    boolean                      sm_mpid_malloced;
 
 
    /********  C A L L B A C K   S T A T E   D A T A   *******/
 
    void                        *user_data_ref;
 
    uint32                       user_data_index;
 
    boolean                      pre_process;
} getcb_get2_t;
 
 
typedef status_t
    (*getcb_fn_t) (ses_cb_t *scb,
                   getcb_mode_t cbmode,
                   const val_value_t *virval,
                   val_value_t *dstval);
 
 
 
typedef status_t
    (*getcb_fn2_t) (ses_cb_t *scb,
                    xml_msg_hdr_t *msg,
                    getcb_get2_t *get2cb);
 
 
typedef getcb_walker_status_t
    (*getcb_get2_walker_fn_t) (getcb_walker_mode_t walker_mode,
                               getcb_get2_t *get2cb,
                               obj_template_t *obj,
                               val_value_t *val,
                               void *cookie);
 
 
extern void
    getcb_init_get2cb (getcb_get2_t *get2cb);
 
 
extern getcb_get2_t *
    getcb_new_get2cb (void);
 
 
extern void
    getcb_free_get2cb (getcb_get2_t *get2cb);
 
 
extern void
    getcb_clean_get2cb (getcb_get2_t *get2cb,
                        boolean reuse);
 
 
extern void
    getcb_add_return_val (getcb_get2_t *get2cb,
                          val_value_t *val);
 
 
extern val_value_t *
    getcb_find_return_val (getcb_get2_t *get2cb,
                           obj_template_t *obj);
 
 
extern val_value_t *
    getcb_find_return_val2 (getcb_get2_t *get2cb,
                            xmlns_id_t obj_nsid,
                            const xmlChar *obj_name);
 
 
extern val_value_t *
    getcb_find_return_val_str (getcb_get2_t *get2cb,
                               xmlns_id_t obj_nsid,
                               const xmlChar *obj_name,
                               const xmlChar *valstr);
 
 
extern val_value_t *
    getcb_find_next_return_val (getcb_get2_t *get2cb,
                                val_value_t *curval);
 
 
extern val_value_t *
    getcb_find_key (getcb_get2_t *get2cb,
                    obj_template_t *obj);
 
 
extern val_value_t *
    getcb_find_key_str (getcb_get2_t *get2cb,
                        const xmlChar *modname,
                        const xmlChar *objname);
 
 
extern val_value_t *
    getcb_find_key_num (getcb_get2_t *get2cb,
                        const xmlChar *modname,
                        const xmlChar *objname,
                        uint32 keynum);
 
 
extern val_value_t *
    getcb_find_key_lvl (getcb_get2_t *get2cb,
                        const xmlChar *modname,
                        const xmlChar *objname,
                        uint32 objlvl);
 
 
extern val_value_t *
    getcb_find_match (getcb_get2_t *get2cb,
                      obj_template_t *obj);
 
 
extern void
    getcb_add_key (getcb_get2_t *get2cb,
                   val_value_t *val);
 
 
extern void
    getcb_add_match (getcb_get2_t *get2cb,
                     val_value_t *val);
 
 
extern status_t
    getcb_add_select (getcb_get2_t *get2cb,
                      const xmlChar *modname,
                      const xmlChar *objname);
 
 
extern void
    getcb_add_return_key (getcb_get2_t *get2cb,
                          val_value_t *val);
 
 
extern val_value_t *
    getcb_find_return_key (getcb_get2_t *get2cb,
                           obj_template_t *obj);
 
 
extern val_value_t *
    getcb_find_return_key2 (getcb_get2_t *get2cb,
                            xmlns_id_t obj_nsid,
                            const xmlChar *obj_name);
 
 
extern void
    getcb_move_return_keys (getcb_get2_t *get2cb);
 
 
extern void
    getcb_undo_move_return_keys (getcb_get2_t *get2cb);
 
 
extern void
    getcb_clean_return_data (getcb_get2_t *get2cb);
 
 
extern val_value_t *
    getcb_get2cb_to_request_val (getcb_get2_t *get2cb,
                                 obj_template_t *get_request_obj,
                                 boolean preserve_data,
                                 xml_msg_hdr_t *msg,
                                 status_t *res);
 
 
extern getcb_get2_t *
    getcb_request_val_to_get2cb (val_value_t *get_request_val,
                                 boolean preserve_data,
                                 status_t *res);
 
 
extern val_value_t *
    getcb_get2cb_to_response_val (getcb_get2_t *get2cb,
                                  obj_template_t *response_obj,
                                  boolean preserve_data,
                                  status_t *res);
 
 
extern getcb_get2_t *
    getcb_response_val_to_get2cb (val_value_t *response_val,
                                  boolean preserve_data,
                                  status_t *res);
 
 
extern void
    getcb_add_return_get2cb (getcb_get2_t *get2cb,
                             getcb_get2_t *return_get2cb);
 
 
extern status_t
    getcb_move_response_get2cb (getcb_get2_t *response_get2cb,
                                getcb_get2_t *get2cb);
 
 
extern status_t
    getcb_replace_response_get2cb (getcb_get2_t *response_get2cb,
                                   getcb_get2_t *get2cb,
                                   boolean replace_mode);
 
 
extern status_t
    getcb_get2_child_obj (ses_cb_t *scb,
                          xml_msg_hdr_t *msg,
                          val_value_t *parentval,
                          getcb_get2_t *parent_get2cb,
                          obj_template_t *obj,
                          boolean with_defaults,
                          getcb_get2_walker_fn_t walkerfn,
                          void *cookie);
 
 
extern status_t
    getcb_get2_child_obj_ex (ses_cb_t *scb,
                             xml_msg_hdr_t *msg,
                             val_value_t *parentval,
                             getcb_get2_t *parent_get2cb,
                             obj_template_t *obj,
                             boolean with_defaults,
                             getcb_get2_walker_fn_t walkerfn,
                             void *cookie,
                             getcb_get2_t *force_get2cb,
                             getcb_api_mode_t api_mode);
 
 
extern status_t
    getcb_handle_acmtest (ses_cb_t *scb,
                          xml_msg_hdr_t *msg,
                          val_nodetest_fn_t testfn,
                          getcb_get2_t *get2cb);
 
 
extern getcb_keyval_t *
    getcb_new_keyval (const xmlChar *keyval);
 
 
extern getcb_keyval_t *
    getcb_new_keyval2 (val_value_t *keynode,
                       obj_template_t *keyobj,
                       boolean fixed_value);
 
 
extern getcb_keyval_t *
    getcb_new_keyval3 (const xmlChar *keyval,
                       obj_template_t *keyobj,
                       boolean fixed_value);
 
 
 
extern void
    getcb_free_keyval (getcb_keyval_t *keyval);
 
 
 
extern void
    getcb_clean_keyvalQ (dlq_hdr_t *que);
 
 
extern getcb_get2_lookup_t *
    getcb_new_get2_lookup (obj_template_t *obj,
                           dlq_hdr_t *keyvalQ);
 
 
extern void
    getcb_free_get2_lookup (getcb_get2_lookup_t *lookup);
 
 
extern void
    getcb_clean_get2_lookupQ (dlq_hdr_t *lookupQ);
 
 
extern getcb_get2_lookup_t *
    getcb_find_get2_lookup (obj_template_t *obj,
                            dlq_hdr_t *lookupQ);
 
 
extern getcb_get2_select_t *
    getcb_new_get2_select (const xmlChar *modname,
                           const xmlChar *objname);
 
 
extern void
    getcb_free_get2_select (getcb_get2_select_t *select_node);
 
 
extern boolean
    getcb_find_get2_select (getcb_get2_t *get2cb,
                            const xmlChar *modname,
                            const xmlChar *objname);
 
 
extern void
    getcb_dump_get2cb (getcb_get2_t *get2cb);
 
 
extern boolean
    getcb_need_get2 (obj_template_t *curobj,
                     obj_template_t *reqobj);
 
 
extern boolean
    getcb_need_get2_ex (obj_template_t *curobj,
                        obj_template_t *reqobj,
                        uint32 *choicecnt,
                        obj_template_t **top_choice);
 
 
extern obj_template_t *
    getcb_first_requested_child (getcb_get2_t *get2cb,
                                 obj_template_t *parent_obj);
 
 
extern obj_template_t *
    getcb_next_requested_child (getcb_get2_t *get2cb,
                                obj_template_t *curchild);
 
 
extern status_t
    getcb_set_active_case (getcb_get2_t *get2cb,
                           const xmlChar *active_case_modname,
                           const xmlChar *active_case);
 
 
extern getcb_get2_getbulk_t *
    getcb_new_get2_getbulk (void);
 
 
extern void
    getcb_free_get2_getbulk (getcb_get2_getbulk_t *getbulk);
 
 
extern status_t
    getcb_finish_getbulk_entry (getcb_get2_t *get2cb);
 
 
extern status_t
    getcb_pre_get2_choices (xml_msg_hdr_t *msg,
                            ses_cb_t *scb,
                            getcb_get2_t *parent_get2cb,
                            obj_template_t *targobj,
                            val_value_t *curval,
                            uint32 choice_cnt,
                            obj_template_t *top_choice,
                            boolean *force_remove,
                            getcb_get2_t **ret_get2cb);
 
 
 
extern void
    getcb_log_walker (const xmlChar *caller,
                      getcb_walker_mode_t walker_mode,
                      const xmlChar *objname,
                      const xmlChar *valname);
 
 
extern status_t
    getcb_clone_keyQ (dlq_hdr_t *srcQ,
                      dlq_hdr_t *destQ);
 
 
extern boolean
    getcb_is_get_exact (getcb_get2_t *get2cb);
 
 
extern void
    getcb_clean_responseQ (getcb_get2_t *get2cb);
 
 
extern void
    getcb_add_return_aioQ (getcb_get2_t *get2cb,
                            val_value_t *val);
 
 
extern void
    getcb_clean_return_aioQ (getcb_get2_t *get2cb);
 
 
extern boolean
    getcb_get2_allowed (xml_msg_hdr_t *msg,
                        obj_template_t *chobj);
 
 
extern getcb_get2_t *
    getcb_new_parent_get2cb (obj_template_t *obj,
                             dlq_hdr_t *keyQ);
 
 
extern boolean
    getcb_match_keys_lookup (obj_template_t *useobj,
                             val_value_t *useval,
                             getcb_get2_lookup_t *lookup);
 
 
extern boolean
    getcb_match_keys_getcb (obj_template_t *useobj,
                            val_value_t *useval,
                            getcb_get2_t *get2cb);
 
 
extern boolean
    getcb_match_keys_keyQ (obj_template_t *useobj,
                            val_value_t *useval,
                            dlq_hdr_t *srcQ);
 
 
extern status_t
    getcb_add_return_aio_buff (getcb_get2_t *get2cb,
                               const xmlChar *buffer);
 
 
extern void
    getcb_clean_return_aio_buff (getcb_get2_t *get2cb);
 
 
extern val_value_t *
    getcb_get2cb_to_val (getcb_get2_t *get2cb,
                         status_t *retres);
 
#ifdef __cplusplus
}  /* end extern 'C' */
#endif
 
#endif      /* _H_getcb */