/usr/include/ncbi/connect/ncbi_servicep.h is in libncbi6-dev 6.1.20120620-7.
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 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 | #ifndef CONNECT___NCBI_SERVICEP__H
#define CONNECT___NCBI_SERVICEP__H
/* $Id: ncbi_servicep.h,v 6.52 2011/11/18 13:54:31 kazimird Exp $
* ===========================================================================
*
* PUBLIC DOMAIN NOTICE
* National Center for Biotechnology Information
*
* This software/database is a "United States Government Work" under the
* terms of the United States Copyright Act. It was written as part of
* the author's official duties as a United States Government employee and
* thus cannot be copyrighted. This software/database is freely available
* to the public for use. The National Library of Medicine and the U.S.
* Government have not placed any restriction on its use or reproduction.
*
* Although all reasonable efforts have been taken to ensure the accuracy
* and reliability of the software and data, the NLM and the U.S.
* Government do not and cannot warrant the performance or results that
* may be obtained by using this software or data. The NLM and the U.S.
* Government disclaim all warranties, express or implied, including
* warranties of performance, merchantability or fitness for any particular
* purpose.
*
* Please cite the author in any work or product based on this material.
*
* ===========================================================================
*
* Author: Anton Lavrentiev, Denis Vakatov
*
* File Description:
* Private API to define server iterator structure.
*
*/
#include "ncbi_server_infop.h"
#include <connect/ncbi_service.h>
#ifdef __cplusplus
extern "C" {
#endif
#define xSERV_IsSuppressed(i) ((i)->time && (i)->time != NCBI_TIME_INFINITE \
&& (i)->rate < 0.0)
#define xSERV_IsStandby(i) ((i)->time && (i)->time != NCBI_TIME_INFINITE \
&& fabs((i)->rate) < 0.01)
#define xSERV_IsDown(i) ((i)->time && (i)->time != NCBI_TIME_INFINITE \
&& !(i)->rate)
/* Table of iterator's "virtual functions"
*/
typedef struct {
void (*Reset)(SERV_ITER iter);
SSERV_Info* (*GetNextInfo)(SERV_ITER iter, HOST_INFO* host_info);
int/*bool*/ (*Update)(SERV_ITER iter, const char* text, int code);
int/*bool*/ (*Feedback)(SERV_ITER iter, double value, int/*bool*/ fine);
void (*Close)(SERV_ITER iter);
const char* name;
} SSERV_VTable;
/* Iterator structure
*/
struct SSERV_IterTag {
const char* name; /* requested service name, private storage */
TSERV_Type type; /* requested server type(s), specials stripped */
unsigned int host; /* preferred host to select, network b.o. */
unsigned short port; /* preferred port to select, host b.o. */
double pref; /* range [0..100] %% */
size_t n_skip; /* actual number of servers in the array */
size_t a_skip; /* number of allocated slots in the array */
SSERV_Info** skip; /* servers to skip (w/names) */
const SSERV_Info* last; /* last server info taken out */
const SSERV_VTable* op; /* table of virtual functions */
void* data; /* private opaque data field */
unsigned ismask:1; /* whether the name is to be treated as a mask */
unsigned ok_down:1; /* as taken.. */
unsigned ok_suppressed:1; /* ..from types.. */
unsigned reverse_dns:1; /* ..as passed into.. */
unsigned stateless:1; /* ..SERV_*() calls */
unsigned external:1; /* whether this is an external request */
const char* arg; /* argument to match; original pointer */
size_t arglen; /* == 0 for NULL pointer above */
const char* val; /* value to match; original pointer */
size_t vallen; /* == 0 for NULL pointer above */
TNCBI_Time time; /* the time of call */
};
/* Control whether to skip using registry/environment when opening iterators,
* and doing fast track lookups. Default is eOff.
*/
extern NCBI_XCONNECT_EXPORT ESwitch SERV_DoFastOpens(ESwitch on);
/* Modified "fast track" routine for obtaining of a server info in one-shot.
* Please see <connect/ncbi_service.h> for explanations [SERV_GetInfoEx()].
*
* CAUTION: unlike 'service' parameter, 'arg' and 'val' are not copied from,
* but the original pointers to them get stored -- take this into
* account while dealing with dynamically allocated strings in the
* slow iterative version of the call below -- the pointers must
* remain valid as long as the iterator stays open (i.e. until
* SERV_Close() gets called).
*
* NOTE: Preference 0.0 does not prohibit the preferred_host to be selected;
* nor preference 100.0 ultimately opts for the preferred_host; rather,
* the preference is considered as an estimate for the selection
* probability when all other conditions for favoring the host are
* optimal, i.e. preference 0.0 actually means not to favor the preferred
* host at all, while 100.0 means to opt for that as much as possible.
* NOTE: Preference < 0 is a special value that means to latch the preferred
* host[:port] if the service exists out there, regardless of the load
* (but taking into account the server disposition [working/non-working]
* only -- servers, which are down, don't get returned).
*/
extern NCBI_XCONNECT_EXPORT SSERV_Info* SERV_GetInfoP
(const char* service, /* service name (may not be a mask here)*/
TSERV_Type types, /* mask of type(s) of servers requested */
unsigned int preferred_host,/* preferred host to use service on, nbo*/
unsigned short preferred_port,/* preferred port to use service on, hbo*/
double preference, /* [0,100] preference in %, or -1(latch)*/
const SConnNetInfo* net_info, /* for connection to dispatcher, m.b. 0 */
const SSERV_InfoCPtr skip[], /* array of servers NOT to select */
size_t n_skip, /* number of servers in preceding array */
int/*bool*/ external, /* whether mapping is not local to NCBI */
const char* arg, /* environment variable name to search */
const char* val, /* environment variable value to match */
HOST_INFO* hinfo /* host information to return on match */
);
/* same as the above but creates an iterator to get the servers one by one
* CAUTION: Special requirement for "skip" infos in case of a wildcard
* service is that they _must_ be created having a name (perhaps, empty "")
* attached, like if done by SERV_ReadInfoEx() or SERV_CopyInfoEx() */
extern NCBI_XCONNECT_EXPORT SERV_ITER SERV_OpenP
(const char* service, /* service name (here: can be a mask!) */
TSERV_Type types,
unsigned int preferred_host,
unsigned short preferred_port,
double preference,
const SConnNetInfo* net_info,
const SSERV_InfoCPtr skip[],
size_t n_skip,
int/*bool*/ external,
const char* arg,
const char* val
);
/* Return service name, which the iterator is currently working on.
*/
extern NCBI_XCONNECT_EXPORT const char* SERV_CurrentName(SERV_ITER iter);
/* Update mapper information from the given text (<CR><LF> separated lines,
* usually as taken from HTTP header), and by optionally (if non-zero)
* using the HTTP error code provided.
*/
extern NCBI_XCONNECT_EXPORT int/*bool*/ SERV_Update
(SERV_ITER iter,
const char* text,
int code
);
/* Private interface: print and return the HTTP-compliant header portion
* (<CR><LF> separated lines, including the last line) out of the information
* contained in the iterator; to be used in mapping requests to DISPD.
* Also, if "net_info" is non-NULL and "net_info->http_referer" is NULL,
* then fill out "net_info->http_referer" accordingly. "but_last" controls
* whether the currently taken info appears as the info to skip over
* (by the dispatcher) ["but_last"==0], or as just being used
* ["but_last"==1]. Return value must be 'free'd.
*/
extern NCBI_XCONNECT_EXPORT char* SERV_Print
(SERV_ITER iter,
SConnNetInfo* net_info,
int/*bool*/ but_last
);
/* Same as SERV_Penalize() but can specify penalty hold time.
*/
extern NCBI_XCONNECT_EXPORT int/*bool*/ SERV_PenalizeEx
(SERV_ITER iter, /* handle obtained via 'SERV_Open*' call*/
double fine, /* fine from range [0=min..100=max] (%%)*/
TNCBI_Time time /* for how long to keep the penalty, sec*/
);
/* Get name of underlying service mapper.
*/
extern NCBI_XCONNECT_EXPORT const char* SERV_MapperName(SERV_ITER iter);
/* Get final service name, using CONN_SERVICE_NAME_service environment
* variable, then (if not found) registry section [service] and a key
* CONN_SERVICE_NAME. Return resulting name (perhaps, an exact copy of
* "service" if no override name was found in environment/registry), which
* is to be freed by a caller when no longer needed. Return NULL on error.
* NOTE: This procedure does not detect cyclical redefinitions.
*/
extern NCBI_XCONNECT_EXPORT char* SERV_ServiceName(const char* service);
/* Given the status gap and wanted preference, calculate
* acceptable stretch for the gap (the number of candidates is n).
*/
extern NCBI_XCONNECT_EXPORT double SERV_Preference
(double pref,
double gap,
size_t n
);
extern NCBI_XCONNECT_EXPORT int/*bool*/ SERV_AddFirewallPort
(unsigned short port
);
extern NCBI_XCONNECT_EXPORT int/*bool*/ SERV_IsFirewallPort
(unsigned short port
);
#ifdef __cplusplus
} /* extern "C" */
#endif
#endif /* CONNECT___NCBI_SERVICEP__H */
|