Transformer SDK For C  7.1.2.311675
datasrc.h
Go to the documentation of this file.
1 /*
2  *
3  * Copyright CAPLIN Systems Ltd 2000-2007
4  *
5  *
6  * $Author: build $
7  * $DateTime: 2018/05/30 16:50:23 $
8  * $Change: 311456 $
9  * $Id: //CDev/V-7_1/datasrc/src/datasrc.h#10 $
10  *
11  *
12  */
13 
14 #ifdef __cplusplus
15 extern "C" {
16 #endif
17 
18 
19 #ifndef __DATASRC_H__
20 #define __DATASRC_H__
21 
22 
23 #undef DATASRC_MAJOR_VERSION
24 #undef DATASRC_MINOR_VERSION
25 #undef DATASRC_PATCH_VERSION
26 
27 #define DATASRC_MAJOR_VERSION 7
28 #define DATASRC_MINOR_VERSION 1
29 #define DATASRC_PATCH_VERSION 3
30 
31 
32 #include <stdio.h>
33 #include <stdlib.h>
34 
35 #ifdef WIN32
36 
37 #include <winsock2.h>
38 #include <windows.h>
39 #include <time.h>
40 #include <ws2tcpip.h>
41 #include <direct.h>
42 #include <io.h>
43 #include <mswsock.h>
44 
45 #else /* ! WIN32 */
46 
47 #include <sys/time.h>
48 #include <sys/types.h>
49 #include <unistd.h>
50 #include <netinet/in.h>
51 #include <sys/socket.h>
52 #include <arpa/inet.h>
53 #include <netdb.h>
54 #include <sys/ioctl.h>
55 #include <net/if.h>
56 #include <sys/uio.h>
57 #include <sys/timeb.h>
58 #include <utime.h>
59 
60 #endif /* ! WIN32 */
61 
62 #include <limits.h>
63 #include <sys/stat.h>
64 #include <string.h>
65 #include <fcntl.h>
66 #include <stdarg.h>
67 #include <errno.h>
68 
69 
70 
71 #define EXIT_CODE_NML 0
72 #define EXIT_CODE_CFG 1
73 #define EXIT_CODE_LOG 2
74 #define EXIT_CODE_NET 3
75 #define EXIT_CODE_SYS 4
76 #define EXIT_CODE_LIC 5
77 #define EXIT_CODE_SIG 6
78 #define EXIT_CODE_SVC 7
79 #define EXIT_CODE_SSL 8
80 #define EXIT_CODE_JVM 9
81 
82 /* Reserve codes for binary start-up issues */
83 #define EXIT_CODE_BIN_MISSING 10
84 #define EXIT_CODE_BIN_NOT_EXEC 11
85 #define EXIT_CODE_BIN_EXIT AFTER_FORK 12
86 #define EXIT_CODE_BIN_BAD_ARCH 126
87 
88 /* Reserve an exit code for Java DataSource blade errors */
89 #define EXIT_CODE_JAVA_DATASOURCE_ERROR 201
90 
91 #define EXIT_CODE_GRACEFUL 202
92 
93 #ifndef WIN32
94 #ifndef DATASRCAPI
95 #define DATASRCAPI
96 #endif
97 #else /* WIN32 */
98 #ifndef DATASRCAPI
99 #ifndef DATASRC_EXPORT
100 #define DATASRCAPI _declspec(dllimport)
101 #else
102 #define DATASRCAPI _declspec(dllexport)
103 #endif
104 #endif
105 #endif /* WIN32 */
106 
107 
108 /* Provide some protection for variadic arguments */
109 #ifdef __GNUC__
110 #define PRINTF(fmt,arg) __attribute__ ((__format__ (__printf__, (fmt), (arg))))
111 #else
112 #define PRINTF(fmt,arg)
113 #endif
114 
115 
121 /* Types */
122 
127 #ifndef WIN32
128 typedef int sock_t;
129 
136 #define INVALID_SOCKET -1
137 
143 #define SOCKET_ERROR -1
144 #else /* WIN32 */
145 
146 typedef SOCKET sock_t;
147 #include <inttypes.h>
148 #endif /* WIN32 */
149 
153 typedef struct _ds_peer_set ds_set_t;
154 
155 typedef uint64_t ds_bitfield_t;
156 
157 typedef struct _ds_data ds_data_t;
158 
159 typedef struct _ds_field ds_field_t;
160 
164 typedef struct _ds_delay ds_delay_t;
165 
166 
170 typedef struct _config_ctx ds_config_ctx_t;
171 
175 typedef struct _ds_log ds_log_t;
176 
191 typedef void (*recv_update_t)(int peer, ds_data_t *pkt);
192 
209 typedef void (*recv_replay_t)(int peer, ds_data_t *pkt, time_t tm);
210 
229 typedef void (*recv_nodata_t)(int peer, char *subject, unsigned short flags);
230 
253 typedef void (*recv_peer_status_t)(int peer, int status, int val, void *data);
254 
273 typedef void (*recv_request_t)(int peer, int count, char **subjects, unsigned short flags);
274 
293 typedef void (*recv_discard_t)(int peer, int count, char **subjects, unsigned short flags);
294 
314 typedef void (*recv_object_status_t)(int peer, char *subject, int status, unsigned short code, char *msgstr);
315 
325 typedef void (*recv_service_status_t)(char *service, int status);
326 
327 
337 typedef void (*recv_map_t)(int peer, char *from, char *to);
338 
339 
357 typedef struct
358  {
359  char *application_name;
360  char *application_root;
361  char *log_root;
362  unsigned short flags;
363  unsigned short type;
364  recv_request_t recv_request;
365  recv_discard_t recv_discard;
366  recv_update_t recv_update;
367  recv_nodata_t recv_nodata;
368  recv_peer_status_t recv_peer_status;
372  recv_object_status_t recv_object_status;
377  recv_service_status_t recv_service_status;
378  recv_map_t recv_map;
379  void (*exit_func)(int exit_code, char *msg);
381  char *logfile;
382  ds_log_t *log;
383  }
384 ds_init_t;
385 
390 #define DS_INITIALISER \
391  { \
392  NULL, /* application_name */ \
393  NULL, /* application_root */ \
394  NULL, /* log_root */ \
395  0, /* flags */ \
396  0, /* type */ \
397  NULL, /* recv_request */ \
398  NULL, /* recv_discard */ \
399  NULL, /* recv_update */ \
400  NULL, /* recv_nodata */ \
401  NULL, /* recv_peer_status */ \
402  NULL, /* recv_object_status */ \
403  NULL, /* recv_service_status */ \
404  NULL, /* recv_map */ \
405  NULL, /* exit_func */ \
406  NULL, /* logfile */ \
407  NULL, /* log */ \
408  }
409 
410 
411 /* datasrc */
412 
413 DATASRCAPI void ds_reserve_std_fds(void);
414 DATASRCAPI void ds_config_init(const char *file, int argc, char **argv);
415 DATASRCAPI int ds_init(ds_init_t *init, int argc, char **argv);
416 DATASRCAPI void ds_thread_init(int event_module, int flags);
417 DATASRCAPI char *ds_filename_expand(const char *format, char *buffer, size_t bufsize);
418 DATASRCAPI ds_log_t *ds_get_event_log(void);
419 
420 
421 /* ds5 */
422 
423 
427 typedef struct _ds5_namespace_s ds5_namespace_t;
428 
432 struct _ds5_namespace_s
433  {
439  void (*free)(ds5_namespace_t *nspace);
440 
449  int (*match)(ds5_namespace_t *nspace, const char *subject);
450 
451 
460  char *(*describe)(ds5_namespace_t *nspace, char *buf, size_t buflen);
461 
462  };
463 
464 
465 DATASRCAPI ds5_namespace_t *ds5_create_prefix_namespace(const char *prefix);
466 
467 DATASRCAPI ds5_namespace_t *ds5_create_globbed_namespace(const char *globbed);
468 DATASRCAPI ds5_namespace_t *ds5_create_regex_namespace(const char *expr);
469 DATASRCAPI int ds5_regex_namespace_add_expr(ds5_namespace_t *nspace, const char *expr, int exclude);
470 
471 
472 /* Macros for convenience */
473 
481 #define ds5_namespace_match(nspace, subject) nspace->match(nspace, subject)
482 
487 #define ds5_namespace_free(nspace) nspace->free(nspace)
488 
489 
490 
491 
492 
501 typedef struct _ds5_publisher_s ds5_publisher_t;
502 
503 
504 
505 
506 
507 
508 
519 typedef struct
520  {
539  void (*receive_request)(void *context, int peer, const char *subject);
540 
561  void (*receive_discard)(void *context, int peer, const char *subject);
562  }
563 ds5_dataprovider_t;
564 
565 
566 DATASRCAPI ds5_publisher_t *ds5_create_active_publisher(ds5_namespace_t *nspace, ds5_dataprovider_t *provider, void *context);
567 DATASRCAPI ds5_publisher_t *ds5_create_compatibility_publisher(ds5_namespace_t *nspace, ds5_dataprovider_t *provider, void *context);
568 DATASRCAPI ds5_publisher_t *ds5_create_broadcast_publisher(ds5_namespace_t *nspace);
569 
570 DATASRCAPI void ds5_publish_to_subscribed_peers_no_free(ds5_publisher_t *pub, ds_data_t *dsdata);
571 DATASRCAPI void ds5_publish_to_subscribed_peers(ds5_publisher_t *pub, ds_data_t *dsdata);
572 DATASRCAPI void ds5_publish_response(ds5_publisher_t *pub, ds_data_t *dsdata);
573 DATASRCAPI void ds5_publish_response_no_free(ds5_publisher_t *pub, ds_data_t *dsdata);
574 DATASRCAPI void ds5_publish_status(ds5_publisher_t *pub, const char *subject, int status, const char *message);
575 DATASRCAPI void ds5_publish_status_all(ds5_publisher_t *pub, int status, const char *message);
576 DATASRCAPI void ds5_publish_subject_error(ds5_publisher_t *publisher, const char *subject, int flags);
577 DATASRCAPI void ds5_publish_to_peer(ds5_publisher_t *publisher, int peernum, ds_data_t *dsdata);
578 DATASRCAPI void ds5_publish_to_peer_no_free(ds5_publisher_t *publisher, int peernum, ds_data_t *dsdata);
579 DATASRCAPI void ds5_publish_subject_map(ds5_publisher_t *publisher, const char *subject, const char *mapped_to, int flags);
580 
581 
595 typedef struct
596  {
607  void (*service_status)(void *context, const char *service_name, int state);
608 
620  void (*peer_status)(void *context, int peer_index, const char *peer_name, int state);
621  }
622 ds5_connectionlistener_t;
623 
624 
634 typedef struct _ds5_subscription_s ds5_subscription_t;
635 
636 
649 typedef struct
650  {
660  void (*record_updated)(void *context, ds5_subscription_t *sub, int peer, ds_data_t *dsdata);
661 
671  void (*record_type2_updated)(void *context, ds5_subscription_t *sub, int peer, ds_data_t *dsdata);
672 
682  void (*record_type3_updated)(void *context, ds5_subscription_t *sub, int peer, ds_data_t *dsdata);
683 
693  void (*container_updated)(void *context, ds5_subscription_t *sub, int peer, ds_data_t *dsdata);
694 
704  void (*permission_updated)(void *context, ds5_subscription_t *sub, int peer, ds_data_t *dsdata);
705 
715  void (*news_updated)(void *context, ds5_subscription_t *sub, int peer, ds_data_t *dsdata);
716 
726  void (*news_story_updated)(void *context, ds5_subscription_t *sub, int peer, ds_data_t *dsdata);
727 
737  void (*page_updated)(void *context, ds5_subscription_t *sub, int peer, ds_data_t *dsdata);
738 
751  void (*unknown_subject_type_updated)(void *context, ds5_subscription_t *sub, int peer, ds_data_t *dsdata);
752 
753 
764  void (*subscription_error)(void *context, ds5_subscription_t *sub, int peer, const char *subject, short flags);
765 
777  void (*subscription_status)(void *context, ds5_subscription_t *sub, int peer, const char *subject, int status, const char *message);
778  }
779 ds5_subscriptionlistener_t;
780 
781 
782 
783 
784 
785 DATASRCAPI void ds5_config_init(const char *configfile, int argc, char **argv);
786 DATASRCAPI int ds5_init(int argc, char **argv);
787 DATASRCAPI void ds5_add_connectionlistener(ds5_connectionlistener_t *connection_listener, void *context);
788 
789 
790 
791 
792 DATASRCAPI ds5_subscription_t *ds5_create_broadcast_subscription(ds5_namespace_t *nspace, ds5_subscriptionlistener_t *listener, void *context);
793 DATASRCAPI ds5_subscription_t *ds5_create_active_subscription(const char *subject, ds5_subscriptionlistener_t *listener, void *context);
794 DATASRCAPI void ds5_unsubscribe(ds5_subscription_t *sub);
795 
796 
797 
798 /* config */
799 
800 
809 #define DS_OFFSET(t,m) ((void *)&((t *)0)->m)
810 
814 #define DS_CONFIG_BOOL 0x0001
815 
820 #define DS_CONFIG_INT 0x0002
821 
825 #define DS_CONFIG_FLOAT 0x0003
826 
830 #define DS_CONFIG_STR 0x0004
831 
835 #define DS_CONFIG_CHAR 0x0005
836 
840 #define DS_CONFIG_FUNC 0x0006
841 
845 #define DS_CONFIG_FILE 0x0007
846 
849 #define DS_CONFIG_GROUP 0x0010
850 #define DS_CONFIG_GROUP_END 0x0011
851 #define DS_CONFIG_SECTION 0x0020
852 #define DS_CONFIG_SECTION_END 0x0021
853 
857 #define DS_CONFIG_JAVA 0x0080
858 
862 #define DS_CONFIG_ARRAY 0x0100
863 
868 #define DS_CONFIG_INT_ARRAY (DS_CONFIG_ARRAY|DS_CONFIG_INT)
869 
873 #define DS_CONFIG_FLOAT_ARRAY (DS_CONFIG_ARRAY|DS_CONFIG_FLOAT)
874 
875 
879 #define DS_CONFIG_STR_ARRAY (DS_CONFIG_ARRAY|DS_CONFIG_STR)
880 
884 #define DS_CONFIG_CHAR_ARRAY (DS_CONFIG_ARRAY|DS_CONFIG_CHAR)
885 
889 #define DS_CONFIG_STRICT 0x0200
890 
895 #define DS_CONFIG_DEPRECATED 0x0400
896 
897 
919 typedef struct
920  {
921  char *name;
922  double value;
923  char *docstring;
924  }
925 ds_config_enum_t;
926 
927 
940 typedef void (*ds_config_func)(char *name, int num, char **values);
941 
942 
943 DATASRCAPI ds_config_ctx_t *ds_config_new_ctx(void);
944 DATASRCAPI void ds_config_free_ctx(ds_config_ctx_t *ctx);
945 DATASRCAPI ds_config_ctx_t *ds_config_set_ctx(ds_config_ctx_t *ctx);
946 DATASRCAPI void ds_config_add_search(const char *path);
947 DATASRCAPI void ds_config_add_file(const char *file);
948 DATASRCAPI void ds_config_add_optional_file(const char *file);
949 DATASRCAPI void ds_config_add_option(char opt, const char *longopt, const char *help, int type, void *value);
950 DATASRCAPI void ds_config_add_bounded_option(char sopt,const char *longopt, const char *help, int type, void *value, void *min, void *max);
951 DATASRCAPI void ds_config_add_option_enum(char opt,const char *longopt, const char *help, int type, void *value, ds_config_enum_t *enums);
952 DATASRCAPI void ds_config_add_bounded_option_enum(char sopt,const char *longopt, const char *help, int type, void *value, ds_config_enum_t *enums, void *min, void *max);
953 DATASRCAPI void ds_config_add_array_option(const char *longopt, const char *help, int type, void *value, int *num);
954 DATASRCAPI void ds_config_add_bounded_array_option(const char *longopt,const char *help, int type, void *value, int *num, void *min, void *max);
955 DATASRCAPI void ds_config_add_array_option_enum(const char *longopt,const char *help, int type, void *value, int *num, ds_config_enum_t *enums);
956 DATASRCAPI void ds_config_add_bounded_array_option_enum(const char *longopt,const char *help, int type, void *value, int *num, ds_config_enum_t *enums, void *min, void *max);
957 DATASRCAPI void ds_config_del_option(const char *longopt);
958 DATASRCAPI void ds_config_add_group(const char *longopt, const char *help, void *base, void *def, size_t size, int *num);
959 DATASRCAPI void ds_config_add_group_with_info(const char *longopt, const char *help, void *base, void *def, size_t size, int *num, int file_offset, int line_offset);
960 DATASRCAPI void ds_config_end_group(const char *longopt,const char *help);
961 DATASRCAPI void ds_config_add_section(const char *longopt,const char *help);
962 DATASRCAPI void ds_config_end_section(const char *longopt,const char *help);
963 DATASRCAPI void ds_config_parse_files(void);
964 DATASRCAPI void ds_config_parse_args(int argc, char **argv, int *retargc);
965 DATASRCAPI int ds_config_parse_file(const char *unresolved_filename);
966 DATASRCAPI void ds_config_list_options(void);
967 DATASRCAPI void ds_config_list_values(void);
968 DATASRCAPI int ds_config_get_enum(const char *value, ds_config_enum_t *enums);
969 DATASRCAPI void ds_config_add_error_message_fmt(const char *fmt,...) PRINTF(1,2);
970 DATASRCAPI void ds_config_add_config_reading_message_fmt(const char *fmt,...) PRINTF(1,2);
971 DATASRCAPI void ds_config_add_error_message(const char *msg);
972 DATASRCAPI char *ds_config_get_filename(void);
973 DATASRCAPI int ds_config_get_linenumber(void);
974 DATASRCAPI void ds_config_set_test(const char *tag, char **value);
975 DATASRCAPI void ds_config_del_test(const char *tag);
976 DATASRCAPI void ds_config_set_option(const char *name, const char *value);
977 
978 
979 /* event */
980 
981 
982 typedef unsigned long ds_reltime_t;
983 
988 typedef struct _ds_timed_event ds_timed_event_t;
989 
990 
995 typedef struct _ds_io_event ds_except_event_t;
996 
997 
998 
1003 typedef struct _ds_io_event ds_read_event_t;
1004 
1005 
1010 typedef struct _ds_io_event ds_write_event_t;
1011 
1012 
1017 typedef struct _ds_io_event ds_generic_event_t;
1018 
1019 
1030 typedef int (*ds_io_event_cb)(sock_t sock, int val, void *data);
1031 
1042 typedef int (*ds_timed_event_cb)(int id, int val, void *data);
1043 
1044 
1045 #define DOUBLE_TO_RELTIME(r,d) r = ((int)(d) << 9) + ((int)(((d) - (int)(d)) * 1000000) >> 11);
1046 #define TIMEVAL_TO_RELTIME(r,tv) r = ((tv).tv_sec << 9) + ((tv).tv_usec >> 11);
1047 
1048 
1049 DATASRCAPI ds_timed_event_t *ds_add_timed_event(int id, double delay, ds_timed_event_cb cb, int val, void *data);
1050 DATASRCAPI ds_read_event_t *ds_add_read_event(sock_t fd, ds_io_event_cb cb, int val, void *data);
1051 DATASRCAPI ds_write_event_t *ds_add_write_event(sock_t fd, ds_io_event_cb cb, int val, void *data);
1052 DATASRCAPI ds_except_event_t *ds_add_except_event(sock_t fd, ds_io_event_cb cb, int val, void *data);
1053 
1054 DATASRCAPI int ds_del_timed_event(ds_timed_event_t *ev);
1055 DATASRCAPI int ds_del_read_event(ds_read_event_t *ev);
1056 DATASRCAPI int ds_del_write_event(ds_write_event_t *ev);
1057 DATASRCAPI int ds_del_except_event(ds_except_event_t *ev);
1058 
1059 DATASRCAPI int ds_del_timed_event_free_data(ds_timed_event_t *ev, void (*free_data)(int, void *));
1060 DATASRCAPI int ds_del_read_event_free_data(ds_read_event_t *ev, void (*free_data)(int, void *));
1061 DATASRCAPI int ds_del_write_event_free_data(ds_write_event_t *ev, void (*free_data)(int, void *));
1062 DATASRCAPI int ds_del_except_event_free_data(ds_except_event_t *ev, void (*free_data)(int, void *));
1063 
1064 DATASRCAPI void ds_timed_event_set_callback(ds_timed_event_t *ev, ds_timed_event_cb cb, int val, void *data);
1065 DATASRCAPI double ds_timed_event_get_fire_time(ds_timed_event_t *ev);
1066 DATASRCAPI void ds_read_event_set_callback(ds_read_event_t *ev, ds_io_event_cb cb, int val, void *data);
1067 DATASRCAPI void ds_write_event_set_callback(ds_write_event_t *ev, ds_io_event_cb cb, int val, void *data);
1068 
1069 DATASRCAPI void ds_set_timed_delay(ds_timed_event_t *ev, double delay);
1070 DATASRCAPI void ds_set_timed_delay_next(ds_timed_event_t *ev, double delay);
1071 
1072 DATASRCAPI void ds_loop(void);
1073 DATASRCAPI void ds_stop(void);
1074 
1075 DATASRCAPI ds_reltime_t ds_get_relative_time(void);
1076 DATASRCAPI time_t ds_get_time(void);
1077 DATASRCAPI struct tm *ds_gmtime(void);
1078 DATASRCAPI struct tm *ds_localtime(void);
1079 DATASRCAPI int ds_get_gmt_offset(time_t t);
1080 DATASRCAPI char *ds_get_timezone(char *buf, int len);
1081 
1082 DATASRCAPI ds_timed_event_t *ds_add_periodic_event(int starttime, int period, int id, ds_timed_event_cb cb, int val, void *data);
1083 DATASRCAPI ds_timed_event_t *ds_add_periodic_event_from_time(time_t then, int starttime, int period, int id, ds_timed_event_cb cb, int val, void *data);
1084 DATASRCAPI int ds_check_periodic_event(int period, ds_timed_event_t **tev);
1085 
1086 
1087 /* cache */
1088 
1093 #define DS_CACHE_DATASRC -1
1094 
1095 DATASRCAPI void ds_cache_add_object(char *subject);
1096 
1097 
1098 /* daemon */
1099 
1100 
1101 DATASRCAPI void ds_daemon_redirect(void);
1102 DATASRCAPI int ds_daemon_disabled(void);
1103 
1104 
1105 /* fields */
1106 
1107 
1115 #define DS_FIELDS_SEPARATOR -65536
1116 
1122 #define DS_FIELDS_NOT_DEFINED (-2147483647 - 1)
1123 
1124 DATASRCAPI int ds_fields_max(void);
1125 DATASRCAPI int ds_fields_add(int num, const char *name, int flags, int dp, const char *fmt);
1126 DATASRCAPI int ds_fields_numbyname(const char *name);
1127 DATASRCAPI char *ds_fields_namebynum(int num);
1128 DATASRCAPI int ds_fields_indexbyname(const char *name);
1129 DATASRCAPI int ds_fields_indexbynum(int num);
1130 DATASRCAPI int ds_fields_numbyindex(int index);
1131 DATASRCAPI char *ds_fields_namebyindex(int index);
1132 DATASRCAPI char *ds_fields_rttpnumbyindex(int index);
1133 DATASRCAPI int ds_fields_getflags(int index);
1134 DATASRCAPI int ds_fields_getdp(int index);
1135 
1136 
1137 
1138 /* log */
1139 
1143 #define DS_LOG_CONFIG 0
1144 #define DS_LOG_ALWAYS 1
1145 
1148 #define DS_LOG_CRIT 2
1149 
1152 #define DS_LOG_ERROR 3
1153 
1156 #define DS_LOG_NOTIFY 4
1157 
1160 #define DS_LOG_WARN 5
1161 
1164 #define DS_LOG_INFO 6
1165 
1168 #define DS_LOG_DEBUG 7
1169 
1172 #define DS_LOG_FINER 8
1173 
1176 #define DS_LOG_FINEST 9
1177 
1180 #define DS_LOG_MONITOR 128
1181 
1184 #define DS_LOG_TERMINAL 256
1185 
1188 #define DS_LOG_SYSLOG 512
1189 #define DS_LOG_FILEONLY 1024
1190 #define DS_LOG_NO_MONITOR 2048
1191 
1199 typedef void (*ds_loglevelchange_t)(ds_log_t *log, int new_level);
1200 
1207 typedef void (*ds_logcycled_t)(ds_log_t *log);
1208 
1209 
1210 
1211 
1212 DATASRCAPI ds_log_t *ds_new_log(const char *name,const char *logname);
1213 DATASRCAPI ds_log_t *ds_new_level_log(const char *name, const char *logname, ds_loglevelchange_t change_cb);
1214 DATASRCAPI ds_log_t *ds_new_headed_log(const char *name, const char *logname, const char *header);
1215 DATASRCAPI void ds_free_log(ds_log_t *log);
1216 DATASRCAPI void ds_write(ds_log_t *log, void *data, size_t len);
1217 #ifndef WIN32
1218 DATASRCAPI void ds_writev(ds_log_t *log, struct iovec *vector, int count);
1219 #endif
1220 DATASRCAPI void ds_printf(ds_log_t *log, const char *fmt, ...) PRINTF(2,3);
1221 DATASRCAPI void ds_printf_time(ds_log_t *log, const char *fmt, ...) PRINTF(2,3);
1222 DATASRCAPI void ds_printf_time_ap(ds_log_t *log, const char *extra, const char *fmt, va_list ap);
1223 DATASRCAPI void ds_syslog(ds_log_t *log, int priority, const char *fmt, ...) PRINTF(3,4);
1224 DATASRCAPI void ds_cycle_all_logs(const char *suffix, long maxsize);
1225 DATASRCAPI int ds_cycle_log(ds_log_t *log, const char *suffix, long maxsize);
1226 DATASRCAPI char *ds_log_getfilename(ds_log_t *log);
1227 DATASRCAPI int ds_debug_level(const char *text);
1228 DATASRCAPI char *ds_debug_string(int level);
1229 DATASRCAPI char *ds_debug_config_string(int level);
1230 DATASRCAPI void ds_log(ds_log_t *log, int level, const char *fmt,...) PRINTF(3,4);
1231 DATASRCAPI int ds_log_set_log_level(ds_log_t *log, const char *level);
1232 DATASRCAPI void ds_log_change_level_callback(ds_log_t *log, ds_loglevelchange_t change_cb);
1233 DATASRCAPI ds_logcycled_t ds_log_cycled_callback(ds_log_t *log, ds_logcycled_t cycle_cb);
1234 DATASRCAPI int ds_log_get_level(ds_log_t *log);
1235 DATASRCAPI int ds_log_flush(ds_log_t *log);
1236 
1237 
1238 /* lty_chain */
1239 
1240 
1250 DATASRCAPI void ds_add_latency_chain(ds_data_t *dsdata, char suffix, struct timespec *tp);
1251 
1263 DATASRCAPI void ds_add_latency_chain2(ds_data_t *dsdata, char suffix, struct timespec tp, char suffix2, struct timespec *tp2);
1264 
1265 
1266 /* monitor */
1267 
1268 
1272 #define TYPE_NONE 0
1273 
1277 #define TYPE_BINARY 1
1278 
1281 #define TYPE_STRING 2
1282 
1285 #define TYPE_SHORT 3
1286 
1289 #define TYPE_USHORT 4
1290 
1293 #define TYPE_LONG 5
1294 
1297 #define TYPE_ULONG 6
1298 
1301 #define TYPE_LLONG 7
1302 
1305 #define TYPE_ULLONG 8
1306 
1309 #define TYPE_DOUBLE 9
1310 
1315 #define TYPE_TIMESTAMP 10
1316 
1321 #define TYPE_BOOLEAN 11
1322 
1326 #define TYPE_RELATION 20
1327 
1331 #define TYPE_SUBSCRIPTION 21
1332 
1333 
1337 #define TYPE_PRIMITIVE_MASK 31
1338 
1342 #define TYPE_ARRAY 32
1343 
1346 #define TYPE_ACTIVE 64
1347 
1357 #define TYPE_ACTIVE2 128
1358 
1361 #define TYPE_METHOD 256
1362 
1365 #define TYPE_KEY 512
1366 
1369 #define TYPE_HIERARCHY 1024
1370 
1376 #define TYPE_OPTIONAL 2048
1377 
1378 
1384 typedef struct {
1385  size_t size;
1386  union _ds_mondata_value {
1387  void *b;
1388  char **c;
1389  int16_t *s;
1390  uint16_t *us;
1391  int32_t *l;
1392  uint32_t *ul;
1393  int64_t *ll;
1394  uint64_t *ull;
1395  double *d;
1396  } data;
1397  }
1398 ds_array_t;
1399 
1405 typedef struct
1406  {
1407  char *propertyname;
1408  int datatype;
1409  union _ds_mondata_value2
1410  {
1411  void *active_ptr; /* Do not set used by monitoring API */
1412  char *c;
1413  int16_t s;
1414  uint16_t us; /* Also used for TYPE_BOOLEAN */
1415  int32_t l;
1416  uint32_t ul; /* Also used for TYPE_TIMESTAMP */
1417  int64_t ll;
1418  uint64_t ull;
1419  double d;
1420  ds_array_t array;
1421  }
1422  data;
1423  }
1424 ds_monitor_t;
1425 
1426 
1430 typedef struct
1431  {
1432  int typeflags;
1433  char *name;
1434  char *description;
1435  char *docstring;
1436  }
1437 ds_arguments_t;
1438 
1439 
1454 typedef ds_monitor_t *(*ds_monitor_method_cb)(char *templatename, char *key, char *property, int argc, char *argv[]);
1455 
1465 typedef ds_monitor_t *(*ds_monitor_active_cb)(char *templatename, char *key, char *propertyname);
1466 
1467 
1468 
1473 typedef struct
1474  {
1475  char *username;
1476  char *password;
1477  char *ipaddress;
1478  }
1479 ds_monauth_t;
1480 
1490 typedef int (*ds_monitor_authenticator_t)(ds_monauth_t *credentials);
1491 
1492 
1493 
1494 DATASRCAPI char *ds_monitor_module_name(void);
1495 
1496 
1497 DATASRCAPI void ds_monitor_add_server_type(const char *type, const char *root);
1498 DATASRCAPI void ds_monitor_start_template(const char *templatename, const char *description);
1499 DATASRCAPI void ds_monitor_add_template_member(const char *templatename, const char *propertyname, const char *description, int typeflags, ds_arguments_t *args, void *ptr);
1500 DATASRCAPI void ds_monitor_add_template_relation(const char *templatename, const char *propertyname, const char *targettemplate, const char *description, int thisend_multiple, int thatend_multiple);
1501 DATASRCAPI void ds_monitor_add_template_subscription(const char *templatename, const char *propertyname, const char *targettemplate, const char *description, const char *singleton, ds_monitor_active_cb callback_fn);
1502 
1503 
1504 DATASRCAPI void ds_monitor_add_relation(const char *templatename, const char *key, const char *propertyname, const char *targetkey);
1505 DATASRCAPI void ds_monitor_del_relation(const char *templatename, const char *key, const char *propertyname, const char *targetkey);
1506 
1507 DATASRCAPI void ds_monitor_add_subscription(const char *templatename, const char *key, const char *propertyname, const char *value);
1508 DATASRCAPI void ds_monitor_del_subscription(const char *templatename, const char *key, const char *propertyname, const char *value);
1509 
1510 DATASRCAPI void ds_monitor_end_template(const char *templatename);
1511 
1512 DATASRCAPI void ds_monitor_create_group(const char *templatename, const char *key, const char *brief, const char *description);
1513 DATASRCAPI void ds_monitor_delete_group(const char *templatename, const char *key);
1514 
1515 
1516 
1517 DATASRCAPI void ds_monitor_update(const char *templatename, const char *key, ds_monitor_t *mondata);
1518 DATASRCAPI void ds_monitor_update_string(const char *templatename, const char *key, const char *propertyname, const char *value);
1519 DATASRCAPI void ds_monitor_update_ushort(const char *templatename, const char *key, const char *propertyname, uint16_t);
1520 DATASRCAPI void ds_monitor_update_short(const char *templatename, const char *key, const char *propertyname, int16_t value);
1521 DATASRCAPI void ds_monitor_update_ulong(const char *templatename, const char *key, const char *propertyname, uint32_t value);
1522 DATASRCAPI void ds_monitor_update_long(const char *templatename,const char *key, const char *propertyname, int32_t value);
1523 DATASRCAPI void ds_monitor_update_ullong(const char *templatename, const char *key, const char *propertyname, uint64_t value);
1524 DATASRCAPI void ds_monitor_update_llong(const char *templatename, const char *key, const char *propertyname, int64_t value);
1525 DATASRCAPI void ds_monitor_update_double(const char *templatename, const char *key, const char *propertyname, double value);
1526 DATASRCAPI void ds_monitor_update_timestamp(const char *templatename, const char *key, const char *propertyname, int64_t value);
1527 DATASRCAPI void ds_monitor_update_boolean(const char *templatename, const char *key, const char *propertyname, uint8_t value);
1528 
1529 
1530 
1531 DATASRCAPI ds_monitor_t *ds_monitor_new(const char *propertyname, int type, int datasize, const void *datum);
1532 DATASRCAPI ds_monitor_t *ds_monitor_new_array(const char *propertyname, int type);
1533 DATASRCAPI void ds_monitor_add_data(ds_monitor_t *data, const void *datum);
1534 DATASRCAPI void ds_monitor_free(ds_monitor_t *data); /* Needed by plugin */
1535 
1536 DATASRCAPI void ds_monitor_free_data(ds_monitor_t *data);
1537 
1538 
1539 DATASRCAPI ds_monitor_t *ds_monitor_new_string(const char *templatename, const char *key, const char *propertyname, const char *value);
1540 DATASRCAPI ds_monitor_t *ds_monitor_new_ushort(const char *templatename, const char *key, const char *propertyname, uint16_t value);
1541 DATASRCAPI ds_monitor_t *ds_monitor_new_short(const char *templatename, const char *key, const char *propertyname, int16_t value);
1542 DATASRCAPI ds_monitor_t *ds_monitor_new_ulong(const char *templatename, const char *key, const char *propertyname, uint32_t value);
1543 DATASRCAPI ds_monitor_t *ds_monitor_new_long(const char *templatename,const char *key, const char *propertyname, int32_t value);
1544 DATASRCAPI ds_monitor_t *ds_monitor_new_ullong(const char *templatename, const char *key, const char *propertyname, uint64_t value);
1545 DATASRCAPI ds_monitor_t *ds_monitor_new_llong(const char *templatename, const char *key, const char *propertyname, int64_t value);
1546 DATASRCAPI ds_monitor_t *ds_monitor_new_double(const char *templatename, const char *key, const char *propertyname, double value);
1547 DATASRCAPI ds_monitor_t *ds_monitor_new_timestamp(const char *templatename, const char *key, const char *propertyname, int64_t value);
1548 DATASRCAPI ds_monitor_t *ds_monitor_new_boolean(const char *templatename, const char *key, const char *propertyname, uint8_t value);
1549 
1550 
1551 DATASRCAPI ds_monitor_authenticator_t ds_monitor_set_auth(ds_monitor_authenticator_t authenticator);
1552 
1553 
1554 /* net */
1555 
1556 
1557 DATASRCAPI sock_t ds_listen_socket(const char *addr, int port, int backlog);
1558 DATASRCAPI sock_t ds_accept_socket(sock_t fd);
1559 DATASRCAPI sock_t ds_multicast_listen_socket(const char *p_interface, const char *addr, int port);
1560 DATASRCAPI sock_t ds_udp_listen_socket(const char *p_interface, int port);
1561 DATASRCAPI sock_t ds_client_socket(const char *serv, unsigned short port);
1562 DATASRCAPI sock_t ds_client_socket_nonblocking(const char *serv, unsigned short port);
1563 DATASRCAPI int ds_udp_send(const char *data, int len, const char *addr, int port);
1564 DATASRCAPI int ds_udp_sendto(const char *data, int len, struct sockaddr_storage *serv_addr);
1565 DATASRCAPI sock_t ds_udp_client_socket(const char *addr, int port, struct sockaddr_storage *serv_addr);
1566 DATASRCAPI int ds_udp_bind_client_socket(sock_t sock, const char *addr, int port);
1567 DATASRCAPI char *ds_interface_address(const char *ifname);
1568 DATASRCAPI void ds_setnonblocking(sock_t fd);
1569 DATASRCAPI char *ds_getnameinfo(const struct sockaddr_storage *addr, char *buf, size_t buflen);
1570 DATASRCAPI int ds_compare_sockaddr(struct sockaddr_storage *sa, struct sockaddr_storage *sb);
1571 DATASRCAPI int ds_pipe(sock_t fds[2]);
1572 DATASRCAPI int ds_check_subnet(const char *s_address, const char *s_network, const char *s_netmask);
1573 DATASRCAPI struct sockaddr_storage *ds_gethostsockaddr(const char *name, struct sockaddr_storage *populate);
1574 DATASRCAPI struct addrinfo *ds_gethostsockaddrs(const char *name);
1575 
1576 
1577 
1578 /* Message Types */
1579 
1587 #define DS_MSG_CONNECT 0x0100
1588 
1596 #define DS_MSG_DISCONNECT 0x0200
1597 #define DS_MSG_STATUS 0x0400
1598 
1599 
1600 /* Peer Types */
1601 
1602 #define DS_T_USERMASK 0x00ff
1603 
1613 #define DS_T_ACTIVE 0x0001
1614 
1625 #define DS_T_CONTRIB 0x0002
1626 
1627 #define DS_T_MSG 0x0100
1628 
1629 
1630 /* Peer Flags */
1631 
1632 #define DS_F_USERMASK 0x00ff
1633 
1649 #define F_SENDFROMSEQ 0x0001
1650 
1651 #define F_SENDFROMFIELD 0x0002
1652 
1653 
1667 #define F_RECVAUTOREPLAY 0x0004
1668 
1669 
1684 #define F_NOCONNECT 0x0008
1685 
1686 #define F_RECONNECT 0x0100
1687 #define F_FAILOVER 0x0200
1688 
1689 
1690 /* No Data Flags */
1691 
1692 #define F_NODATAMASK 0x000f
1693 
1703 #define F_NOTFOUND 0x0001
1704 
1713 #define F_READDENY 0x0002
1714 
1723 #define F_WRITEDENY 0x0003
1724 
1733 #define F_DELETEOBJECT 0x0004
1734 
1743 #define F_UNAVAILABLE 0x0005
1744 #define F_STATUS 0x0006
1745 
1746 
1747 
1753 #define F_IGNOREREQTIMEOUT 0x0008
1754 
1755 /* Object Types */
1756 
1760 #define DS_PAGE_TYPE 221
1761 
1764 #define DS_RECORD_TYPE 222
1765 
1768 #define DS_RECORD_TYPE2 225
1769 
1772 #define DS_RECORD_TYPE3 226
1773 
1776 #define DS_NEWS_TYPE 223
1777 
1780 #define DS_STORY_TYPE 224
1781 
1784 #define DS_CONTAINER_TYPE 228
1785 
1788 #define DS_PERMISSION_TYPE 230
1789 
1796 #define DS_GENERIC_TYPE 231
1797 
1798 
1799 /* Data Flags */
1800 
1804 #define F_CREATEOBJECT 0x0010
1805 
1808 #define F_CREATEPARENT 0x0020
1809 #define F_PERSISTENT 0x0040
1810 #define F_CREATEDATA 0x0080
1811 
1815 #define F_CLEAR_PERM 0x0400
1816 
1827 #define F_FILTER_PERM 0x0800
1828 
1833 #define F_AUTHGLOBAL 0x0100
1834 
1838 #define F_CLEAR_TYPE3 0x0100
1839 
1843 #define F_FILTER_TYPE3 0x0200
1844 
1847 #define F_CLEAR_TYPE2 0x0400
1848 
1862 #define F_FILTER_TYPE2 0x0800
1863 
1869 #ifdef __DARWIN_NULL
1870 #undef F_NOCACHE
1871 #endif
1872 #define F_NOCACHE 0x0400
1873 
1880 #define F_DELETE_HEADLINE 0x0100
1881 
1889 #define F_CHANGE_HEADLINE 0x0200
1890 
1895 #define F_IMAGE 0x1000
1896 
1900 #define F_NONACTIVE 0x2000
1901 
1904 #define F_AUTHUPDATE 0x4000
1905 
1906 
1914 #define F_CONSTITUENT_NOAUTH 0x4000
1915 
1922 #define F_CHANGEDFIELDS 0x8000
1923 
1924 /* Field Data Types */
1925 
1926 #define FLOAT32_TYPE 1
1927 #define FLOAT64_TYPE 2
1928 #define INT8_TYPE 3
1929 #define INT16_TYPE 4
1930 #define INT32_TYPE 5
1931 #define INT64_TYPE 6
1932 
1933 
1934 /* Object request flags */
1935 
1945 #define DS_REQUEST_FAILOVER 1
1946 
1955 #define DS_REQUEST_CACHE 4
1956 
1957 
1958 
1959 /* Object Status Flags */
1960 
1970 #define S_INFO 0x0000
1971 
1980 #define S_STALE 0x0001
1981 
1990 #define S_NOTSTALE 0x0004
1991 
2003 #define S_UPDCLR 0x0100
2004 
2015 #define S_FAILOVER 0x1101 /* Failover implies S_STALE|S_UPDCLR */
2016 
2017 
2030 #define OBJ_STATUS_INFO 0x0000
2031 
2044 #define OBJ_STATUS_OK 0x0001
2045 
2060 #define OBJ_STATUS_STALE 0x0002
2061 
2062 
2078 #define OBJ_STATUS_LIMITED 0x0008
2079 
2080 
2081 #define OBJ_STATUS_NOTMAPPED 0x0010
2082 
2091 #define SVC_STATUS_OK 0x0001
2092 
2101 #define SVC_STATUS_DOWN 0x0002
2102 
2111 #define SVC_STATUS_LIMITED 0x0008
2112 
2113 
2114 /* Field Macros */
2115 #define DS_MAX_BITFIELD (sizeof(ds_bitfield_t)*8)
2116 
2117 #define DS_BITFIELD_SET(n,p) *(p) |= (1ULL << (n))
2118 #define DS_BITFIELD_CLR(n,p) *(p) &= ~(1ULL << (n))
2119 #define DS_BITFIELD_ISSET(n,p) (*(p) & (1ULL << (n)))
2120 #define DS_BITFIELD_ZERO(p) *(p) = 0
2121 #define DS_BITFIELD_NONZERO(p) memset((char *)(p), 0xffffffff, sizeof(*(p)))
2122 
2123 /* Peer set functions and macros */
2124 
2125 DATASRCAPI int ds_iszero(ds_set_t *p);
2126 DATASRCAPI void ds_or(ds_set_t *p1, ds_set_t *p2, ds_set_t *o);
2127 DATASRCAPI void ds_and(ds_set_t *p1, ds_set_t *p2, ds_set_t *a);
2128 DATASRCAPI int ds_and_iszero(ds_set_t *p1, ds_set_t *p2);
2129 DATASRCAPI int ds_and3_iszero(ds_set_t *p1, ds_set_t *p2, ds_set_t *p3);
2130 DATASRCAPI int ds_isequal(ds_set_t *p1, ds_set_t *p2);
2131 
2136 #define DS_MAX_PEERS 1024
2137 
2142 #define DS_MIN_PEER 0
2143 
2148 #define DS_INTERNAL_DATASRC 1023
2149 
2150 typedef uint32_t dsset_element_t;
2151 
2152 #define DS_NUMBITS (sizeof(dsset_element_t) * 8)
2153 #define DS_NUM_ELEMS (DS_MAX_PEERS+DS_NUMBITS-1)/DS_NUMBITS
2154 #define DS_NUM_BYTES (DS_NUM_ELEMS * sizeof(dsset_element_t))
2155 
2156 struct _ds_peer_set
2157  {
2158  dsset_element_t bits[DS_NUM_ELEMS];
2159  };
2160 
2165 #define DS_SET(n,p) ((p)->bits[(n)/DS_NUMBITS] |= ((unsigned)1 << ((n) % DS_NUMBITS)))
2166 
2171 #define DS_CLR(n,p) ((p)->bits[(n)/DS_NUMBITS] &= ~((unsigned)1 << ((n) % DS_NUMBITS)))
2172 
2177 #define DS_ISSET(n,p) ((p)->bits[(n)/DS_NUMBITS] & ((unsigned)1 << ((n) % DS_NUMBITS)))
2178 
2183 #define DS_ZERO(p) memset((char *)(p)->bits, 0, DS_NUM_BYTES)
2184 
2189 #define DS_NONZERO(p) memset((char *)(p)->bits, 0xff, DS_NUM_BYTES)
2190 
2195 #define DS_ISZERO(p) ds_iszero(p)
2196 
2201 #define DS_AND(p1, p2, a) ds_and(p1, p2, a)
2202 
2207 #define DS_OR(p1, p2, o) ds_or(p1, p2, o)
2208 
2213 #define DS_AND_ISZERO(p1, p2) ds_and_iszero(p1, p2)
2214 
2219 #define DS_AND3_ISZERO(p1, p2, p3) ds_and3_iszero(p1, p2, p3)
2220 
2225 #define DS_ISEQUAL(p1, p2) ds_isequal(p1, p2)
2226 
2227 DATASRCAPI ds_data_t *ds_init_data(const char *subject, unsigned short type, unsigned short flags);
2228 DATASRCAPI void ds_set_subject(ds_data_t *data, const char *subject);
2229 
2230 DATASRCAPI void ds_add_data(ds_data_t *data, int32_t fieldnum, const char *value);
2231 DATASRCAPI void ds_add_data_fmt(ds_data_t *data, int32_t fieldnum, const char *fmt, ...);
2232 DATASRCAPI void ds_add_data_str(ds_data_t *data, int32_t fieldnum, const char *value);
2233 DATASRCAPI void ds_add_data_float32(ds_data_t *data, int32_t fieldnum, float value);
2234 DATASRCAPI void ds_add_data_float64(ds_data_t *data, int32_t fieldnum, double value);
2235 DATASRCAPI void ds_add_data_int8(ds_data_t *data, int32_t fieldnum, int8_t value);
2236 DATASRCAPI void ds_add_data_int16(ds_data_t *data, int32_t fieldnum, int16_t value);
2237 DATASRCAPI void ds_add_data_int32(ds_data_t *data, int32_t fieldnum, int32_t value);
2238 DATASRCAPI void ds_add_data_int64(ds_data_t *data, int32_t fieldnum, int64_t value);
2239 DATASRCAPI void ds_add_data_char(ds_data_t *data, int32_t fieldnum, char value);
2240 
2241 DATASRCAPI ds_data_t *ds_clone_data(ds_data_t *data);
2242 
2243 #define ds_add_data_short(d,f,v) ds_add_data_int16(d,f,v)
2244 #define ds_add_data_int(d,f,v) ds_add_data_int32(d,f,v)
2245 #define ds_add_data_long(d,f,v) ds_add_data_int32(d,f,v)
2246 #define ds_add_data_float(d,f,v) ds_add_data_float32(d,f,v)
2247 #define ds_add_data_double(d,f,v) ds_add_data_float64(d,f,v)
2248 
2249 DATASRCAPI void ds_send_data(ds_data_t *data);
2250 DATASRCAPI void ds_send_data_to_peer(int peer, ds_data_t *data);
2251 DATASRCAPI void ds_send_data_no_free(ds_data_t *data);
2252 DATASRCAPI void ds_send_data_to_peer_no_free(int peer, ds_data_t *data);
2253 DATASRCAPI void ds_send_nodata(const char *subject, unsigned short flags);
2254 DATASRCAPI void ds_send_nodata_to_peer(int peer, const char *subject, unsigned short flags);
2255 DATASRCAPI void ds_free_data(ds_data_t *data);
2256 DATASRCAPI void ds_send_status(const char *subject, unsigned short flags, unsigned short code, const char *msgstr);
2257 DATASRCAPI void ds_send_status_to_peer(int peer,const char *subject, unsigned short flags, unsigned short code, const char *msgstr);
2258 DATASRCAPI void ds_send_data_direct(ds_data_t *data);
2259 DATASRCAPI void ds_send_nodata_direct(const char *subject, unsigned short flags);
2260 DATASRCAPI void ds_send_status_direct(const char *subject, unsigned short flags, unsigned short code, const char *msgstr);
2261 
2262 DATASRCAPI void ds_send_map_to_peer(int peer, const char *subject, const char *mapped, unsigned short flags);
2263 DATASRCAPI void ds_send_map(const char *subject, const char *mapped, unsigned short flags);
2264 
2265 
2276 typedef void (*ds_delay_send_cb)(void *context, ds_data_t *dsdata);
2277 
2278 DATASRCAPI ds_delay_t *ds_new_delay(double delay_time, char *prefix, double batch_time);
2279 DATASRCAPI ds_delay_t *ds_new_delay_with_callback(double delay_time, char *prefix, double batch_time, void *callback_param, ds_delay_send_cb callback_func);
2280 DATASRCAPI void ds_delay_data(ds_delay_t *delay, ds_data_t *dsdata);
2281 
2282 DATASRCAPI int32_t ds_add_record_str(ds_data_t *data, const char *field, const char *value);
2283 DATASRCAPI int32_t ds_add_record_int(ds_data_t *data,const char *field, int value);
2284 DATASRCAPI int32_t ds_add_record_char(ds_data_t *data,const char *field, char value);
2285 DATASRCAPI int32_t ds_add_record_float(ds_data_t *data,const char *field, double value);
2286 DATASRCAPI int32_t ds_add_record_fmt(ds_data_t *data,const char *field, const char *fmt, ...);
2287 
2288 DATASRCAPI ds_data_t *ds_init_page(const char *subject, int rows, int cols, const char *type, unsigned short flags);
2289 DATASRCAPI void ds_add_page_row(ds_data_t *data, int row, int col, const char *str);
2290 DATASRCAPI void ds_add_page_field(ds_data_t *data, int32_t fieldnum, const char *value);
2291 DATASRCAPI void ds_add_page_field_by_name(ds_data_t *data, const char *field, const char *value);
2292 
2293 DATASRCAPI ds_data_t *ds_init_news(const char *subject, unsigned short flags);
2294 DATASRCAPI void ds_add_news_headline(ds_data_t *data, const char *headline);
2295 DATASRCAPI void ds_add_news_storycode(ds_data_t *data, const char *story);
2296 DATASRCAPI void ds_add_news_datetime(ds_data_t *data, const char *datestr);
2297 DATASRCAPI void ds_add_news_authstr(ds_data_t *data, const char *authstr);
2298 DATASRCAPI void ds_add_news_product_code(ds_data_t *data, const char *code);
2299 DATASRCAPI void ds_add_news_topic_code(ds_data_t *data, const char *code);
2300 DATASRCAPI void ds_add_news_company_code(ds_data_t *data, const char *code);
2301 DATASRCAPI void ds_add_news_user_code(ds_data_t *data, int codenum, const char *code);
2302 DATASRCAPI void ds_add_news_field(ds_data_t *dsdata, const char *fieldname, const char *value);
2303 
2304 DATASRCAPI ds_data_t *ds_init_container(const char *subject, const unsigned short flags);
2305 DATASRCAPI void ds_add_container_symbol_and_request(ds_data_t *data, const char *symbol, const int request);
2306 DATASRCAPI void ds_add_container_symbol(ds_data_t *data, const char *symbol);
2307 DATASRCAPI void ds_add_container_symbol_at_position(ds_data_t *data, int position, const char *symbol);
2308 DATASRCAPI void ds_remove_container_symbol(ds_data_t *data, const char *symbol);
2309 DATASRCAPI void ds_cleardown_container_with_prefix(ds_data_t *data, const char *prefix);
2310 
2311 DATASRCAPI ds_data_t *ds_init_permission(const char *subject, const char *key, unsigned short flags);
2312 DATASRCAPI void ds_add_permission_key(ds_data_t *data, const char *key);
2313 
2314 DATASRCAPI void ds_add_binary(ds_data_t *data, int32_t fieldnum, char *value, int len, char type);
2315 DATASRCAPI void ds_add_binary_float32(ds_data_t *data, int32_t fieldnum, float value);
2316 DATASRCAPI void ds_add_binary_float64(ds_data_t *data, int32_t fieldnum, double value);
2317 DATASRCAPI void ds_add_binary_int8(ds_data_t *data, int32_t fieldnum, int8_t value);
2318 DATASRCAPI void ds_add_binary_int16(ds_data_t *data, int32_t fieldnum, int16_t value);
2319 DATASRCAPI void ds_add_binary_int32(ds_data_t *data, int32_t fieldnum, int32_t value);
2320 DATASRCAPI void ds_add_binary_int64(ds_data_t *data, int32_t fieldnum, int64_t value);
2321 DATASRCAPI void ds_add_binary_uint8(ds_data_t *data, int32_t fieldnum, uint8_t value);
2322 DATASRCAPI void ds_add_binary_uint16(ds_data_t *data, int32_t fieldnum, uint16_t value);
2323 DATASRCAPI void ds_add_binary_uint32(ds_data_t *data, int32_t fieldnum, uint32_t value);
2324 DATASRCAPI void ds_add_binary_uint64(ds_data_t *data, int32_t fieldnum, uint64_t value);
2325 DATASRCAPI void ds_add_binary_string(ds_data_t *data, int32_t fieldnum, char *value);
2326 DATASRCAPI void ds_add_binary_opaque(ds_data_t *data, int32_t fieldnum, char *value, int len);
2327 DATASRCAPI void ds_add_binary_time(ds_data_t *data, int32_t fieldnum, time_t value);
2328 DATASRCAPI void ds_add_binary_time_millis(ds_data_t *data, int32_t fieldnum, int64_t value);
2329 DATASRCAPI void ds_add_binary_timeval(ds_data_t *data, int32_t fieldnum, struct timeval value);
2330 DATASRCAPI void ds_add_binary_timespec(ds_data_t *data, int32_t fieldnum, struct timespec value);
2331 
2332 #define ds_add_binary_char(d,f,v) ds_add_binary_int8(d,f,v);
2333 #define ds_add_binary_short(d,f,v) ds_add_binary_int16(d,f,v);
2334 #define ds_add_binary_int(d,f,v) ds_add_binary_int32(d,f,v);
2335 #define ds_add_binary_long(d,f,v) ds_add_binary_int32(d,f,v);
2336 #define ds_add_binary_float(d,f,v) ds_add_binary_float32(d,f,v);
2337 #define ds_add_binary_double(d,f,v) ds_add_binary_float64(d,f,v);
2338 #define ds_add_binary_time_micros(d,f,v) ds_add_binary_timeval(d,f,v);
2339 #define ds_add_binary_time_nanos(d,f,v) ds_add_binary_timespec(d,f,v);
2340 
2341 
2345 #define NEWS_HEADLINE_FIELDNUM 0
2346 
2349 #define NEWS_STORYCODE_FIELDNUM 1
2350 
2353 #define NEWS_DATETIME_FIELDNUM 2
2354 
2357 #define NEWS_AUTHSTR_FIELDNUM 5
2358 
2361 #define NEWS_PRODUCT_CODE_FIELDNUM 100
2362 
2365 #define NEWS_TOPIC_CODE_FIELDNUM 101
2366 
2369 #define NEWS_COMPANY_CODE_FIELDNUM 102
2370 
2373 #define NEWS_USER_CODE_FIELDNUM 200
2374 
2377 #define NEWS_USER_CODE_MAX 10
2378 
2379 #define NEWS_SIZE_FIELDNUM 300
2380 #define NEWS_REASON_FIELDNUM 301
2381 
2382 #define NEWS_REQ_SEARCH 1000
2383 #define NEWS_REQ_STORYCODE 1001
2384 #define NEWS_REQ_DATE_TO 1002
2385 #define NEWS_REQ_DATE_FROM 1003
2386 #define NEWS_REQ_FLAGS 1004
2387 
2388 #define NEWS_GENERIC_FIELDNUM 1024
2389 
2390 /* peer */
2391 
2392 
2393 DATASRCAPI extern int ds_num_peers;
2394 
2395 
2396 DATASRCAPI int ds_peer_details(int peer, char **name);
2397 DATASRCAPI int ds_peer_host_details(int peer, char **addr);
2398 DATASRCAPI int ds_peer_id(int peer);
2399 DATASRCAPI char *ds_peer_name(int peer);
2400 DATASRCAPI int ds_peer_flags(int peer);
2401 DATASRCAPI int ds_peer_local_type(int peer);
2402 DATASRCAPI int ds_peer_type(int peer);
2403 DATASRCAPI int ds_peer_up(int peer);
2404 DATASRCAPI void ds_peer_add_extra_handshake_data(int peer, const char *data);
2405 DATASRCAPI int ds_peer_all_type(int flag);
2406 
2407 DATASRCAPI void ds_set_status_down(void);
2408 DATASRCAPI void ds_set_status_down_to_peer(int peer);
2409 DATASRCAPI void ds_set_status_msg(unsigned short msgid, const char *msgstr);
2410 DATASRCAPI void ds_set_status_msg_to_peer(int peer, unsigned short msgid, const char *msgstr);
2411 DATASRCAPI void ds_set_status_up(void);
2412 DATASRCAPI void ds_set_status_up_to_peer(int peer);
2413 DATASRCAPI int ds_peer_by_label(const char *label);
2414 DATASRCAPI int ds_peer_by_local_label(const char *label);
2415 DATASRCAPI char *ds_peer_label_byindex(int index);
2416 DATASRCAPI int ds_peer_enabled_state(int peer);
2417 
2418 /* pkt */
2419 
2426 struct _ds_data
2427  {
2428  unsigned short seq;
2429  unsigned short flags;
2430  unsigned short type;
2431  char *subject;
2432  unsigned short count;
2433  ds_field_t *fields;
2434  time_t time;
2435  };
2436 
2443 struct _ds_field
2444  {
2445  int32_t fieldnum;
2446  int32_t len;
2447  char *value;
2448  unsigned short flags;
2449  };
2450 
2451 
2452 /* replay */
2453 
2454 
2455 DATASRCAPI void ds_replay(recv_replay_t callback);
2456 DATASRCAPI int ds_replay_from_file(recv_replay_t callback, char *filename);
2457 DATASRCAPI void ds_replay_from_log(recv_replay_t callback, ds_log_t *log);
2458 DATASRCAPI void ds_replay_by_time(time_t t, recv_replay_t callback);
2459 DATASRCAPI int ds_replay_by_time_from_file(time_t t, recv_replay_t callback, char *filename);
2460 DATASRCAPI void ds_replay_by_time_from_log(time_t t, recv_replay_t callback, ds_log_t *log);
2461 DATASRCAPI void ds_replay_by_field(int fieldnum, char *value, recv_replay_t callback);
2462 DATASRCAPI int ds_replay_by_field_from_file(int fieldnum, char *value, recv_replay_t callback, char *filename);
2463 DATASRCAPI void ds_replay_by_field_from_log(int fieldnum, char *value, recv_replay_t callback, ds_log_t *log);
2464 
2465 
2466 /* udp */
2467 
2468 
2473 typedef struct _ds_udp_event ds_udp_event_t;
2474 
2486 typedef int (*ds_udp_event_cb)(int argc, char *argv[], int val, void *data);
2487 
2488 
2489 DATASRCAPI ds_udp_event_t *ds_add_udp_event(const char *command, ds_udp_event_cb cb, int val, void *data);
2490 DATASRCAPI void ds_del_udp_event(ds_udp_event_t *event);
2491 
2492 DATASRCAPI void ds_udpsignal_send(const char *message);
2493 DATASRCAPI void ds_udpsignal_send_argv(const char *message, char *argv[]);
2494 
2495 /* Deprecated methods of handling udp commands */
2496 DATASRCAPI int ds_udpsignal_addjob(const char *cmd,void (*fn)(int argc,char *argv[]), const char *description);
2497 DATASRCAPI int ds_udpsignal_deljob(const char *cmd, void (*fn)(int argc, char *argv[]));
2498 
2499 
2500 /* misc */
2501 
2502 DATASRCAPI void ds_set_productname(const char *name);
2503 
2504 /* advmap */
2505 
2506 DATASRCAPI char *ds_request_object(const char *name);
2507 DATASRCAPI char *ds_request_object_with_flags(const char *name,int flags);
2508 DATASRCAPI int ds_request_objects(int count, char **obs, char ***services);
2509 DATASRCAPI int ds_request_objects_with_flags(int count, char **obs, int flags, char ***services);
2510 DATASRCAPI void ds_discard_object(const char *name);
2511 DATASRCAPI void ds_discard_objects(int count, char **obs);
2512 DATASRCAPI char * ds_get_service(const char *name);
2513 DATASRCAPI int ds_send_contribution(ds_data_t *dsdata);
2514 DATASRCAPI int ds_get_num_services(void);
2515 DATASRCAPI int ds_get_service_by_index(int index, char **name_ptr);
2516 DATASRCAPI int ds_object_available(const char *name);
2517 DATASRCAPI int ds_object_can_contrib(const char *name);
2518 DATASRCAPI void ds_purge_object(const char *name);
2519 DATASRCAPI int ds_required_services_status(char *buf, size_t buflen);
2520 DATASRCAPI int ds_get_service_type(const char *servicename);
2521 DATASRCAPI int ds_get_is_contrib_source(const char *name, int peer);
2522 
2524 DATASRCAPI int ds_set_request_hint(const char *name, int num, char **hints);
2525 DATASRCAPI char **ds_get_request_hints(const char *name, int *ret);
2526 DATASRCAPI void ds_set_object_data(const char *name, void *data);
2527 DATASRCAPI void *ds_get_object_data(const char *name);
2528 
2529 /* signature */
2530 DATASRCAPI int ds_signature_check(char *key_id, char *token);
2531 DATASRCAPI int ds_signature_verify_username(char *expected_username, char *token);
2532 
2533 
2540 #define DS_SIGNATURE_OK 0
2541 
2547 #define DS_SIGNATURE_INVALID_TOKEN 1
2548 
2554 #define DS_SIGNATURE_UNKNOWN_KEYID 2
2555 
2561 #define DS_SIGNATURE_ALREADY_USED 3
2562 #endif /* __DATASRC_H__ */
2563 
2564 #ifdef __cplusplus
2565 } /* extern "C" */
2566 #endif
2567 
ds_init_t::recv_update
recv_update_t recv_update
Definition: datasrc.h:366
ds_init_t::log_root
char * log_root
Definition: datasrc.h:361
_ds_field::flags
unsigned short flags
Definition: datasrc.h:2448
ds_init_t
Definition: datasrc.h:357
ds_monitor_authenticator_t
int(* ds_monitor_authenticator_t)(ds_monauth_t *credentials)
Definition of the function type used for monitoring authentication callback.
Definition: datasrc.h:1490
ds_loglevelchange_t
void(* ds_loglevelchange_t)(ds_log_t *log, int new_level)
Callback used when the logging level of a log file is changed.
Definition: datasrc.h:1199
ds_init_t::application_root
char * application_root
Definition: datasrc.h:360
_ds_data::subject
char * subject
Definition: datasrc.h:2431
ds_delay_t
struct _ds_delay ds_delay_t
The delay channel object type.
Definition: datasrc.h:164
_ds_data::seq
unsigned short seq
Definition: datasrc.h:2428
ds_monitor_active_cb
ds_monitor_t *(* ds_monitor_active_cb)(char *templatename, char *key, char *propertyname)
Definition of the function type used for active request callbacks.
Definition: datasrc.h:1465
ds_config_enum_t
Enumerated types structure.
Definition: datasrc.h:919
_ds_field
A field within a data update.
Definition: datasrc.h:2443
ds_init_t::application_name
char * application_name
Definition: datasrc.h:359
recv_update_t
void(* recv_update_t)(int peer, ds_data_t *pkt)
Definition: datasrc.h:191
ds_timed_event_cb
int(* ds_timed_event_cb)(int id, int val, void *data)
Definition of the callback for use with timed events.
Definition: datasrc.h:1042
ds_array_t
The container object for monitoring array types.
Definition: datasrc.h:1384
ds_set_request_hint
DATASRCAPI int ds_set_request_hint(const char *name, int num, char **hints)
ds_logcycled_t
void(* ds_logcycled_t)(ds_log_t *log)
Callback used when the log has cycled.
Definition: datasrc.h:1207
ds_arguments_t::typeflags
int typeflags
Definition: datasrc.h:1432
recv_object_status_t
void(* recv_object_status_t)(int peer, char *subject, int status, unsigned short code, char *msgstr)
Definition: datasrc.h:314
ds_monauth_t
Monitoring credentials object.
Definition: datasrc.h:1473
ds5_subscriptionlistener_t
Definition: datasrc.h:649
_ds_data::count
unsigned short count
Definition: datasrc.h:2432
ds_init_t::recv_object_status
recv_object_status_t recv_object_status
Definition: datasrc.h:372
ds_config_enum_t::name
char * name
Definition: datasrc.h:921
ds_arguments_t::docstring
char * docstring
Definition: datasrc.h:1435
ds_init_t::recv_service_status
recv_service_status_t recv_service_status
Definition: datasrc.h:377
ds_config_enum_t::docstring
char * docstring
Definition: datasrc.h:923
sock_t
int sock_t
The network socket datatype.
Definition: datasrc.h:128
ds5_subscription_t
struct _ds5_subscription_s ds5_subscription_t
Definition: datasrc.h:634
ds_arguments_t::description
char * description
Definition: datasrc.h:1434
ds5_connectionlistener_t
Definition: datasrc.h:595
ds_add_latency_chain2
DATASRCAPI void ds_add_latency_chain2(ds_data_t *dsdata, char suffix, struct timespec tp, char suffix2, struct timespec *tp2)
function used to add two measurement points to latency chain data
_ds_data::fields
ds_field_t * fields
Definition: datasrc.h:2433
ds_init_t::flags
unsigned short flags
Definition: datasrc.h:362
recv_discard_t
void(* recv_discard_t)(int peer, int count, char **subjects, unsigned short flags)
Definition: datasrc.h:293
ds_arguments_t::name
char * name
Definition: datasrc.h:1433
_ds5_namespace_s
Definition of the interface that you should implement if you require custom subject matching logic...
Definition: datasrc.h:432
ds5_publisher_t
struct _ds5_publisher_s ds5_publisher_t
Definition: datasrc.h:501
ds_udp_event_t
struct _ds_udp_event ds_udp_event_t
Opaque type defining a udp event.
Definition: datasrc.h:2473
ds_monitor_t::propertyname
char * propertyname
Definition: datasrc.h:1407
ds_monitor_t
The container object for all monitoring values.
Definition: datasrc.h:1405
_ds_data::flags
unsigned short flags
Definition: datasrc.h:2429
recv_replay_t
void(* recv_replay_t)(int peer, ds_data_t *pkt, time_t tm)
Definition: datasrc.h:209
ds_arguments_t
Structure defining the arguments for Monitoring methods.
Definition: datasrc.h:1430
ds_log_t
struct _ds_log ds_log_t
The log file object.
Definition: datasrc.h:175
ds_init_t::type
unsigned short type
Definition: datasrc.h:363
_ds5_namespace_s::free
void(* free)(ds5_namespace_t *nspace)
Invoked when the namespace should be deleted.
Definition: datasrc.h:439
ds_set_t
struct _ds_peer_set ds_set_t
Defines a set of DataSource peers.
Definition: datasrc.h:153
recv_peer_status_t
void(* recv_peer_status_t)(int peer, int status, int val, void *data)
Definition: datasrc.h:253
ds_timed_event_t
struct _ds_timed_event ds_timed_event_t
Opaque type defining a timed event.
Definition: datasrc.h:988
ds_array_t::size
size_t size
Definition: datasrc.h:1385
_ds_data
A data update object.
Definition: datasrc.h:2426
_ds_field::value
char * value
Definition: datasrc.h:2447
ds_monauth_t::username
char * username
Definition: datasrc.h:1475
ds_io_event_cb
int(* ds_io_event_cb)(sock_t sock, int val, void *data)
Definition of the callback for use with read and write events.
Definition: datasrc.h:1030
recv_request_t
void(* recv_request_t)(int peer, int count, char **subjects, unsigned short flags)
Definition: datasrc.h:273
_ds_data::type
unsigned short type
Definition: datasrc.h:2430
ds_write_event_t
struct _ds_io_event ds_write_event_t
Opaque type defining a write event.
Definition: datasrc.h:1010
ds_config_enum_t::value
double value
Definition: datasrc.h:922
ds_init_t::recv_request
recv_request_t recv_request
Definition: datasrc.h:364
ds_monauth_t::password
char * password
Definition: datasrc.h:1476
ds_config_ctx_t
struct _config_ctx ds_config_ctx_t
The configuration context data type.
Definition: datasrc.h:170
ds_init_t::recv_map
recv_map_t recv_map
Definition: datasrc.h:378
ds5_dataprovider_t
Definition: datasrc.h:519
_ds_field::fieldnum
int32_t fieldnum
Definition: datasrc.h:2445
ds_init_t::recv_peer_status
recv_peer_status_t recv_peer_status
Definition: datasrc.h:368
ds_init_t::logfile
char * logfile
Definition: datasrc.h:381
ds_init_t::log
ds_log_t * log
Definition: datasrc.h:382
ds_except_event_t
struct _ds_io_event ds_except_event_t
Opaque type defining an exception event.
Definition: datasrc.h:995
ds_read_event_t
struct _ds_io_event ds_read_event_t
Opaque type defining a read event.
Definition: datasrc.h:1003
ds_add_latency_chain
DATASRCAPI void ds_add_latency_chain(ds_data_t *dsdata, char suffix, struct timespec *tp)
function used to add a measurement point to latency chain data
ds_delay_send_cb
void(* ds_delay_send_cb)(void *context, ds_data_t *dsdata)
Definition: datasrc.h:2276
ds_config_func
void(* ds_config_func)(char *name, int num, char **values)
Definition of function type used for configuration callbacks.
Definition: datasrc.h:940
_ds_field::len
int32_t len
Definition: datasrc.h:2446
ds_generic_event_t
struct _ds_io_event ds_generic_event_t
Opaque type defining a generic read/write event.
Definition: datasrc.h:1017
ds_init_t::recv_nodata
recv_nodata_t recv_nodata
Definition: datasrc.h:367
recv_nodata_t
void(* recv_nodata_t)(int peer, char *subject, unsigned short flags)
Definition: datasrc.h:229
ds_monauth_t::ipaddress
char * ipaddress
Definition: datasrc.h:1477
recv_map_t
void(* recv_map_t)(int peer, char *from, char *to)
Definition: datasrc.h:337
recv_service_status_t
void(* recv_service_status_t)(char *service, int status)
Definition: datasrc.h:325
ds_udp_event_cb
int(* ds_udp_event_cb)(int argc, char *argv[], int val, void *data)
Definition of the callback for use with udp events.
Definition: datasrc.h:2486
_ds5_namespace_s::match
int(* match)(ds5_namespace_t *nspace, const char *subject)
Tests a subject to see if it falls within this namespace.
Definition: datasrc.h:449
ds_monitor_t::datatype
int datatype
Definition: datasrc.h:1408
ds_init_t::recv_discard
recv_discard_t recv_discard
Definition: datasrc.h:365
Generated on Fri Aug 10 2018 18:43:49 for Transformer SDK For C