/usr/include/mama/servicelevel.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 | /* $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 MamaServiceLevelH_
#define MamaServiceLevelH_
/*
* This file provides MAMA subscription service level information.
*/
#include "mama/types.h"
#if defined(__cplusplus)
extern "C" {
#endif
/**
* mamaServiceLevel is an enumeration that represents the service
* level (a) requested by a subscribing application, or (b) provided
* by the publisher. In the future, the service level provided to the
* application might change dynamically, depending upon infrastructure
* capacity. So, even though the requested service level is "real
* time", if service deteriorates for any reason, the subscription may
* automatically switch to a conflated level (after notifying the
* application of the switch).
*/
typedef enum mamaServiceLevel_
{
/**
* Real time updates.
*/
MAMA_SERVICE_LEVEL_REAL_TIME = 0,
/**
* Single snapshot image only.
*/
MAMA_SERVICE_LEVEL_SNAPSHOT = 1,
/**
* Repeating snapshot image. When creating subscriptions, the
* serviceLevelOpt parameter should be set to the number of
* milliseconds representing the interval between snapshots. The
* first snapshot will be obtained within some random period
* between zero and the interval. Only one snapshot request will
* be allowed to be outstanding at a time.
*/
MAMA_SERVICE_LEVEL_REPEATING_SNAPSHOT = 2,
/**
* Conflated updates (future).
*/
MAMA_SERVICE_LEVEL_CONFLATED = 5,
/**
* Unknown level.
*/
MAMA_SERVICE_LEVEL_UNKNOWN = 99
} mamaServiceLevel;
/**
* Extract the subscription service level from a message.
*
* @param msg The message.
*/
MAMAExpDLL
extern mamaServiceLevel
mamaServiceLevel_getFromMsg (const mamaMsg msg);
/**
* Extract the subscription service level as a string from a message.
*
* @param msg The message.
*/
MAMAExpDLL
extern const char*
mamaServiceLevel_getFromMsgAsString (const mamaMsg msg);
/**
* Convert a mamaServiceLevel to a string.
*
* @param type The mamaServiceLevel.
*/
MAMAExpDLL
extern const char*
mamaServiceLevel_toString (mamaServiceLevel type);
#if defined(__cplusplus)
}
#endif
#endif /* MamaServiceLevelH_ */
|