/usr/include/yuma/ncx/top.h is in libyuma-dev 2.9-1+b2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 | /*
* Copyright (c) 2008 - 2012, Andy Bierman, 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_top
#define _H_top
/* FILE: top.h
*********************************************************************
* *
* P U R P O S E *
* *
*********************************************************************
NCX Common Top Element module
Manage callback registry for received XML messages
*********************************************************************
* *
* C H A N G E H I S T O R Y *
* *
*********************************************************************
date init comment
----------------------------------------------------------------------
30-dec-05 abb Begun
11-feb-07 abb Move some common fns back to ncx/top.h
*/
#include <xmlstring.h>
#ifndef _H_ses
#include "ses.h"
#endif
#ifndef _H_status
#include "status.h"
#endif
#ifndef _H_xml_util
#include "xml_util.h"
#endif
#ifdef __cplusplus
extern "C" {
#endif
/********************************************************************
* *
* C O N S T A N T S *
* *
*********************************************************************/
/********************************************************************
* *
* T Y P E S *
* *
*********************************************************************/
/* callback function template for a top handler
*
* INPUTS:
* scb == session control block; source of input
* The session manager will only stream
* one message to this function and wait
* for it to return.
* top == very first node of the incoming message
* This allows a single handler to support
* multiple top nodes, and also contains
* the attributes present in the node
* RETURNS:
* none
*/
typedef void (*top_handler_t) (ses_cb_t *scb,
xml_node_t *top);
/********************************************************************
* *
* F U N C T I O N S *
* *
*********************************************************************/
/********************************************************************
* FUNCTION top_init
*
* Initialize the Top Elelment Handler
*
*********************************************************************/
extern void
top_init (void);
/********************************************************************
* FUNCTION top_cleanup
*
* cleanup Top Element Handler
*********************************************************************/
extern void
top_cleanup (void);
/********************************************************************
* FUNCTION top_register_node
*
* Register a top entry handler function
*
* INPUTS:
* owner == owner name (really module name)
* elname == element name
* handler == callback function for this element
* RETURNS:
* status
*********************************************************************/
extern status_t
top_register_node (const xmlChar *owner,
const xmlChar *elname,
top_handler_t handler);
/********************************************************************
* FUNCTION top_unregister_node
*
* Remove a top entry handler function
* This will not affect calls to the handler currently
* in progress, but new calls to top_dispatch_msg
* will no longer find this node.
*
* INPUTS:
* owner == owner name
* elname == element name
* RETURNS:
* none
*********************************************************************/
extern void
top_unregister_node (const xmlChar *owner,
const xmlChar *elname);
/********************************************************************
* FUNCTION top_find_handler
*
* Find the top_handler in the topQ
*
* INPUTS:
* owner == owner name
* elname == element name
*
* RETURNS:
* pointer to top_handler or NULL if not found
*********************************************************************/
extern top_handler_t
top_find_handler (const xmlChar *owner,
const xmlChar *elname);
#ifdef __cplusplus
} /* end extern 'C' */
#endif
#endif /* _H_top */
|