/usr/include/mama/sourceman.h is in libmama-dev 2.2.2.1-11ubuntu1.
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 | /* $Id$
*
* OpenMAMA: The open middleware agnostic messaging API
* Copyright (C) 2011 NYSE Technologies, Inc.
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
* 02110-1301 USA
*/
#ifndef MamaSourceManagerH__
#define MamaSourceManagerH__
#include "mama/config.h"
#include "mama/status.h"
#include "mama/types.h"
#include "mama/quality.h"
#include "mama/log.h"
#include "mama/source.h"
#if defined (__cplusplus)
extern "C" {
#endif
typedef void (MAMACALLTYPE *mamaSourceManager_sourcesIteratorCb) (
mamaSourceManager sourceManager,
mamaSource source,
void* closure);
/**
* Create a mamaSourceManager object.
*
* @param sourceManager The location of a mamaSourceManager to store the result.
*/
MAMAExpDLL
extern mama_status
mamaSourceManager_create (mamaSourceManager* sourceManager);
/**
* Destroy a mamaSourceManager object.
*
* @param sourceManager The sourceManager object to destroy.
*/
MAMAExpDLL
extern mama_status
mamaSourceManager_destroy (mamaSourceManager sourceManager);
/**
* Create a new mamaSource and add it to the manager.
*
* @param sourceManager The sourceManager to use for creating the mamaSource.
* @param name The string identifier for the mamaSource.
* @param source The address to which the new source will be * written.
*
* @return MAMA_STATUS_OK if execution is successful.
*/
MAMAExpDLL
extern mama_status
mamaSourceManager_createSource (mamaSourceManager sourceManager,
const char* name,
mamaSource* source);
/**
* Locates an existing mamaSource for the given name. If none exists creates
* a new mamaSource and adds to the sourceManager.
*
* @param sourceManager The sourceManager to use for locating the mamaSource.
* @param name The string identifier for the mamaSource
* @param source The location to which the address for the source will be
* written.
*
* @return MAMA_STATUS_OK if execution is successful.
*/
MAMAExpDLL
extern mama_status
mamaSourceManager_findOrCreateSource (mamaSourceManager sourceManager,
const char* name,
mamaSource* source);
/**
* Locates an existing mamaSource in the specified sourceManager with the
* specified string 'name' identifier.
* The value of the source argument will be set to NULL if no source was
* located in the sourceManager provided.
*
* @param sourceManager The mamaSourceManager to use to locate the specified
* mamaSource.
* @param name The string identifier for the required mamaSource.
* @param source The location to which the address for the source will be
* written. NULL if none is found.
*
* @return MAMA_STATUS_OK if creation is successful.
*/
MAMAExpDLL
extern mama_status
mamaSourceManager_findSource (mamaSourceManager sourceManager,
const char* name,
mamaSource* source);
/**
* Add an existing mamaSource to the specified mamaSourceManager.
* The id of the source will be used instead of the name to uniquely identify
* the source within the manager.
*
* @param sourceManager The mamaSourceManager to which an existing mamaSource
* is being added.
* @param source The mamaSource being added to the specified
* mamaSourceManager.
*
* @return MAMA_STATUS_OK if execution is successful.
*/
MAMAExpDLL
extern mama_status
mamaSourceManager_addSource (mamaSourceManager sourceManager,
mamaSource source);
/**
* Add an existing mamaSource to the specified mamaSourceManager using the
* specified name as a unique identifier.
*
* @param sourceManager The mamaSourceManager to which an existing mamaSource
* is being added.
* @param name The string identifier for the mamaSource
* @param source The mamaSource being added to the specified
* mamaSourceManager.
*
* @return MAMA_STATUS_OK if execution is successful.
*/
MAMAExpDLL
extern mama_status
mamaSourceManager_addSourceWithName (mamaSourceManager sourceManager,
mamaSource source,
const char* name);
/**
* Iterate over all the sources in this mamaSourceManager.
*
* @param sourceManager The mamaSourceManager to iterate over.
* @param callback The callback function pointer to invoke for each source
* in the group.
* @param closure User supplied arbitrary data. Passed back on each
* invocation of the callback function.
*
* @return MAMA_STATUS_OK if the function executes successfully.
*/
MAMAExpDLL
extern mama_status
mamaSourceManager_iterateSources (mamaSourceManager sourceGroup,
mamaSourceManager_sourcesIteratorCb callback,
void* closure);
#if defined (__cplusplus)
}
#endif
#endif
|