evt.c 61 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174217521762177217821792180218121822183218421852186218721882189219021912192219321942195219621972198219922002201220222032204220522062207220822092210221122122213221422152216221722182219222022212222222322242225222622272228222922302231223222332234223522362237223822392240224122422243224422452246224722482249225022512252225322542255225622572258225922602261226222632264226522662267226822692270227122722273227422752276
  1. /*
  2. * Copyright (c) 2004-2005 Mark Haverkamp
  3. * Copyright (c) 2004-2005 Open Source Development Lab
  4. *
  5. * All rights reserved.
  6. *
  7. * This software licensed under BSD license, the text of which follows:
  8. *
  9. * Redistribution and use in source and binary forms, with or without
  10. * modification, are permitted provided that the following conditions are met:
  11. *
  12. * - Redistributions of source code must retain the above copyright notice,
  13. * this list of conditions and the following disclaimer.
  14. * - Redistributions in binary form must reproduce the above copyright notice,
  15. * this list of conditions and the following disclaimer in the documentation
  16. * and/or other materials provided with the distribution.
  17. * - Neither the name of the Open Source Developement Lab nor the names of its
  18. * contributors may be used to endorse or promote products derived from this
  19. * software without specific prior written permission.
  20. *
  21. * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
  22. * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  23. * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  24. * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
  25. * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  26. * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  27. * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  28. * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  29. * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  30. * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
  31. * THE POSSIBILITY OF SUCH DAMAGE.
  32. */
  33. #include <sys/types.h>
  34. #include <errno.h>
  35. #include <stdio.h>
  36. #include <stdlib.h>
  37. #include <string.h>
  38. #include <unistd.h>
  39. #include <sys/time.h>
  40. #include <sys/socket.h>
  41. #include "../include/ipc_evt.h"
  42. #include "util.h"
  43. #include "../exec/totem.h"
  44. #include "../include/list.h"
  45. static void evtHandleInstanceDestructor(void *instance);
  46. static void chanHandleInstanceDestructor(void *instance);
  47. static void eventHandleInstanceDestructor(void *instance);
  48. /*
  49. * Versions of the SAF AIS specification supported by this library
  50. */
  51. static SaVersionT supported_versions[] = {
  52. {'B', 0x01, 0x01}
  53. };
  54. static struct saVersionDatabase evt_version_database = {
  55. sizeof(supported_versions) / sizeof(SaVersionT),
  56. supported_versions
  57. };
  58. /*
  59. * Event instance data
  60. */
  61. struct saHandleDatabase evt_instance_handle_db = {
  62. .handleCount = 0,
  63. .handles = 0,
  64. .mutex = PTHREAD_MUTEX_INITIALIZER,
  65. .handleInstanceDestructor = evtHandleInstanceDestructor
  66. };
  67. /*
  68. * Channel instance data
  69. */
  70. struct saHandleDatabase channel_handle_db = {
  71. .handleCount = 0,
  72. .handles = 0,
  73. .mutex = PTHREAD_MUTEX_INITIALIZER,
  74. .handleInstanceDestructor = chanHandleInstanceDestructor
  75. };
  76. /*
  77. * Event instance data
  78. */
  79. struct saHandleDatabase event_handle_db = {
  80. .handleCount = 0,
  81. .handles = 0,
  82. .mutex = PTHREAD_MUTEX_INITIALIZER,
  83. .handleInstanceDestructor = eventHandleInstanceDestructor
  84. };
  85. struct res_overlay {
  86. mar_res_header_t header __attribute__((aligned(8)));
  87. char data[MESSAGE_SIZE_MAX];
  88. };
  89. struct handle_list {
  90. SaUint64T hl_handle;
  91. struct list_head hl_entry;
  92. };
  93. /*
  94. * data required to support events for a given initialization
  95. *
  96. * ei_dispatch_fd: fd used for getting callback data e.g. async event data
  97. * ei_response_fd: fd used for everything else (i.e. evt sync api commands).
  98. * ei_callback: callback function.
  99. * ei_version: version sent to the evtInitialize call.
  100. * ei_node_id: our node id.
  101. * ei_node_name: our node name.
  102. * ei_finalize: instance in finalize flag
  103. * ei_dispatch_mutex: mutex for dispatch fd
  104. * ei_response_mutex: mutex for response fd
  105. * ei_channel_list: list of associated channels (struct handle_list)
  106. * ei_data_available: Indicates that there is a pending event message though
  107. * there may not be a poll event. This can happen
  108. * when we get a SA_AIS_ERR_TRY_AGAIN when asking for an
  109. * event.
  110. *
  111. */
  112. struct event_instance {
  113. int ei_dispatch_fd;
  114. int ei_response_fd;
  115. SaEvtCallbacksT ei_callback;
  116. SaVersionT ei_version;
  117. SaClmNodeIdT ei_node_id;
  118. SaNameT ei_node_name;
  119. int ei_finalize;
  120. pthread_mutex_t ei_dispatch_mutex;
  121. pthread_mutex_t ei_response_mutex;
  122. struct list_head ei_channel_list;
  123. int ei_data_available;
  124. };
  125. /*
  126. * Data associated with an opened channel
  127. *
  128. * eci_channel_name: name of channel
  129. * eci_open_flags: channel open flags
  130. * eci_svr_channel_handle: channel handle returned from server
  131. * eci_closing: channel in process of being closed
  132. * eci_mutex: channel mutex
  133. * eci_event_list: events associated with this
  134. * channel (struct handle_list)
  135. * eci_hl: pointer to event instance handle struct
  136. * for this channel.
  137. */
  138. struct event_channel_instance {
  139. SaNameT eci_channel_name;
  140. SaEvtChannelOpenFlagsT eci_open_flags;
  141. uint32_t eci_svr_channel_handle;
  142. SaEvtHandleT eci_instance_handle;
  143. int eci_closing;
  144. pthread_mutex_t eci_mutex;
  145. struct list_head eci_event_list;
  146. struct handle_list *eci_hl;
  147. };
  148. /*
  149. * Event data.
  150. *
  151. * Store event data from saEvtEventAllocate function.
  152. * Store event data from received events.
  153. *
  154. * edi_channel_handle: handle (local) of assocated channel
  155. * edi_patterns: event patterns
  156. * edi_priority: event priority
  157. * edi_retention_time: event's retention time
  158. * edi_pub_name: event's publisher name
  159. * edi_pub_node: event's publisher node
  160. * edi_pub_time: event's publish time
  161. * edi_event_id: event's Id
  162. * edi_event_data: event's data
  163. * edi_event_data_size: size of edi_event_data
  164. * edi_freeing: event is being freed
  165. * edi_mutex: event data mutex
  166. * edi_hl: pointer to channel's handle
  167. * struct for this event.
  168. * edi_ro: read only flag
  169. */
  170. struct event_data_instance {
  171. SaEvtChannelHandleT edi_channel_handle;
  172. SaEvtEventPatternArrayT edi_patterns;
  173. SaUint8T edi_priority;
  174. SaTimeT edi_retention_time;
  175. SaNameT edi_pub_name;
  176. SaClmNodeIdT edi_pub_node;
  177. SaTimeT edi_pub_time;
  178. SaEvtEventIdT edi_event_id;
  179. void *edi_event_data;
  180. SaSizeT edi_event_data_size;
  181. int edi_freeing;
  182. pthread_mutex_t edi_mutex;
  183. struct handle_list *edi_hl;
  184. int edi_ro;
  185. };
  186. #define min(a,b) ((a) < (b) ? (a) : (b))
  187. static inline int is_valid_event_id(SaEvtEventIdT evt_id)
  188. {
  189. if (evt_id > 1000) {
  190. return 1;
  191. } else {
  192. return 0;
  193. }
  194. }
  195. /*
  196. * Clean up function for an evt instance (saEvtInitialize) handle
  197. * Not to be confused with event data.
  198. */
  199. static void evtHandleInstanceDestructor(void *instance)
  200. {
  201. struct event_instance *evti = instance;
  202. struct event_channel_instance *eci;
  203. struct handle_list *hl;
  204. struct list_head *l, *nxt;
  205. uint64_t handle;
  206. SaAisErrorT error;
  207. /*
  208. * Free up any channel data
  209. */
  210. for (l = evti->ei_channel_list.next;
  211. l != &evti->ei_channel_list; l = nxt) {
  212. nxt = l->next;
  213. hl = list_entry(l, struct handle_list, hl_entry);
  214. handle = hl->hl_handle;
  215. error = saHandleInstanceGet(&channel_handle_db, hl->hl_handle,
  216. (void*)&eci);
  217. if (error != SA_AIS_OK) {
  218. /*
  219. * already gone
  220. */
  221. continue;
  222. }
  223. saHandleDestroy(&channel_handle_db, handle);
  224. saHandleInstancePut(&channel_handle_db, handle);
  225. }
  226. }
  227. /*
  228. * Clean up function for an open channel handle
  229. */
  230. static void chanHandleInstanceDestructor(void *instance)
  231. {
  232. struct event_channel_instance *eci = instance;
  233. struct list_head *l, *nxt;
  234. struct handle_list *hl;
  235. uint64_t handle;
  236. if (eci->eci_hl) {
  237. list_del(&eci->eci_hl->hl_entry);
  238. free(eci->eci_hl);
  239. eci->eci_hl = 0;
  240. }
  241. /*
  242. * Free up any channel associated events
  243. */
  244. for (l = eci->eci_event_list.next; l != &eci->eci_event_list; l = nxt) {
  245. nxt = l->next;
  246. hl = list_entry(l, struct handle_list, hl_entry);
  247. handle = hl->hl_handle;
  248. saEvtEventFree(handle);
  249. }
  250. }
  251. /*
  252. * Clean up function for an event handle
  253. */
  254. static void eventHandleInstanceDestructor(void *instance)
  255. {
  256. struct event_data_instance *edi = instance;
  257. int i;
  258. if (edi->edi_hl) {
  259. list_del(&edi->edi_hl->hl_entry);
  260. free(edi->edi_hl);
  261. edi->edi_hl = 0;
  262. }
  263. if (edi->edi_patterns.patterns) {
  264. for (i = 0; i < edi->edi_patterns.patternsNumber; i++) {
  265. free(edi->edi_patterns.patterns[i].pattern);
  266. }
  267. free(edi->edi_patterns.patterns);
  268. }
  269. if (edi->edi_event_data) {
  270. free(edi->edi_event_data);
  271. }
  272. }
  273. static SaAisErrorT evt_recv_event(int fd, struct lib_event_data **msg)
  274. {
  275. SaAisErrorT error;
  276. mar_res_header_t hdr;
  277. void *data;
  278. error = saRecvRetry(fd, &hdr, sizeof(hdr));
  279. if (error != SA_AIS_OK) {
  280. goto msg_out;
  281. }
  282. *msg = malloc(hdr.size);
  283. if (!*msg) {
  284. error = SA_AIS_ERR_LIBRARY;
  285. goto msg_out;
  286. }
  287. data = (void *)((unsigned long)*msg) + sizeof(hdr);
  288. memcpy(*msg, &hdr, sizeof(hdr));
  289. if (hdr.size > sizeof(hdr)) {
  290. error = saRecvRetry(fd, data, hdr.size - sizeof(hdr));
  291. if (error != SA_AIS_OK) {
  292. goto msg_out;
  293. }
  294. }
  295. msg_out:
  296. return error;
  297. }
  298. /*
  299. * The saEvtInitialize() function initializes the Event Service for the
  300. * invoking process. A user of the Event Service must invoke this function
  301. * before it invokes any other function of the Event Service API. Each
  302. * initialization returns a different callback handle that the process
  303. * can use to communicate with that library instance.
  304. */
  305. SaAisErrorT
  306. saEvtInitialize(
  307. SaEvtHandleT *evtHandle,
  308. const SaEvtCallbacksT *callbacks,
  309. SaVersionT *version)
  310. {
  311. SaAisErrorT error = SA_AIS_OK;
  312. struct event_instance *evti;
  313. if (!version || !evtHandle) {
  314. error = SA_AIS_ERR_INVALID_PARAM;
  315. goto error_nofree;
  316. }
  317. /*
  318. * validate the requested version with what we support
  319. */
  320. error = saVersionVerify(&evt_version_database, version);
  321. if (error != SA_AIS_OK) {
  322. goto error_nofree;
  323. }
  324. /*
  325. * Allocate instance data, allocate unique handle for instance,
  326. * assign instance data to unique handle
  327. */
  328. error = saHandleCreate(&evt_instance_handle_db, sizeof(*evti),
  329. evtHandle);
  330. if (error != SA_AIS_OK) {
  331. goto error_nofree;
  332. }
  333. error = saHandleInstanceGet(&evt_instance_handle_db, *evtHandle,
  334. (void*)&evti);
  335. if (error != SA_AIS_OK) {
  336. if (error == SA_AIS_ERR_BAD_HANDLE) {
  337. error = SA_AIS_ERR_LIBRARY;
  338. }
  339. goto error_handle_free;
  340. }
  341. memset(evti, 0, sizeof(*evti));
  342. list_init(&evti->ei_channel_list);
  343. /*
  344. * Save the version so we can check with the event server
  345. * and see if it supports this version.
  346. */
  347. evti->ei_version = *version;
  348. /*
  349. * Set up communication with the event server
  350. */
  351. error = saServiceConnect(&evti->ei_response_fd,
  352. &evti->ei_dispatch_fd, EVT_SERVICE);
  353. if (error != SA_AIS_OK) {
  354. goto error_handle_put;
  355. }
  356. /*
  357. * The callback function is saved in the event instance for
  358. * saEvtDispatch() to use.
  359. */
  360. if (callbacks) {
  361. memcpy(&evti->ei_callback, callbacks,
  362. sizeof(evti->ei_callback));
  363. }
  364. pthread_mutex_init(&evti->ei_dispatch_mutex, NULL);
  365. pthread_mutex_init(&evti->ei_response_mutex, NULL);
  366. saHandleInstancePut(&evt_instance_handle_db, *evtHandle);
  367. return SA_AIS_OK;
  368. error_handle_put:
  369. saHandleInstancePut(&evt_instance_handle_db, *evtHandle);
  370. error_handle_free:
  371. (void)saHandleDestroy(&evt_instance_handle_db, *evtHandle);
  372. error_nofree:
  373. return error;
  374. }
  375. /*
  376. * The saEvtSelectionObjectGet() function returns the operating system
  377. * handle selectionObject, associated with the handle evtHandle, allowing
  378. * the invoking process to ascertain when callbacks are pending. This
  379. * function allows a process to avoid repeated invoking saEvtDispatch() to
  380. * see if there is a new event, thus, needlessly consuming CPU time. In a
  381. * POSIX environment the system handle could be a file descriptor that is
  382. * used with the poll() or select() system calls to detect incoming callbacks.
  383. */
  384. SaAisErrorT
  385. saEvtSelectionObjectGet(
  386. SaEvtHandleT evtHandle,
  387. SaSelectionObjectT *selectionObject)
  388. {
  389. struct event_instance *evti;
  390. SaAisErrorT error;
  391. if (!selectionObject) {
  392. return SA_AIS_ERR_INVALID_PARAM;
  393. }
  394. error = saHandleInstanceGet(&evt_instance_handle_db, evtHandle,
  395. (void *)&evti);
  396. if (error != SA_AIS_OK) {
  397. return error;
  398. }
  399. *selectionObject = evti->ei_dispatch_fd;
  400. saHandleInstancePut(&evt_instance_handle_db, evtHandle);
  401. return SA_AIS_OK;
  402. }
  403. /*
  404. * Alocate an event data structure and associated handle to be
  405. * used to supply event data to a call back function.
  406. */
  407. static SaAisErrorT make_event(SaEvtEventHandleT *event_handle,
  408. struct lib_event_data *evt)
  409. {
  410. struct event_data_instance *edi;
  411. struct event_channel_instance *eci;
  412. mar_evt_event_pattern_t *pat;
  413. SaUint8T *str;
  414. SaAisErrorT error;
  415. struct handle_list *hl;
  416. int i;
  417. error = saHandleCreate(&event_handle_db, sizeof(*edi),
  418. event_handle);
  419. if (error != SA_AIS_OK) {
  420. if (error == SA_AIS_ERR_NO_MEMORY) {
  421. error = SA_AIS_ERR_LIBRARY;
  422. }
  423. goto make_evt_done;
  424. }
  425. error = saHandleInstanceGet(&event_handle_db, *event_handle,
  426. (void*)&edi);
  427. if (error != SA_AIS_OK) {
  428. saHandleDestroy(&event_handle_db, *event_handle);
  429. goto make_evt_done;
  430. }
  431. error = saHandleInstanceGet(&channel_handle_db,
  432. evt->led_lib_channel_handle,
  433. (void*)&eci);
  434. if (error != SA_AIS_OK) {
  435. saHandleDestroy(&event_handle_db, *event_handle);
  436. goto make_evt_done_put;
  437. }
  438. pthread_mutex_init(&edi->edi_mutex, NULL);
  439. edi->edi_ro = 1;
  440. edi->edi_freeing = 0;
  441. edi->edi_channel_handle = evt->led_lib_channel_handle;
  442. edi->edi_priority = evt->led_priority;
  443. edi->edi_retention_time = evt->led_retention_time;
  444. edi->edi_pub_node = evt->led_publisher_node_id;
  445. edi->edi_pub_time = evt->led_publish_time;
  446. edi->edi_event_data_size = evt->led_user_data_size;
  447. edi->edi_event_id = evt->led_event_id;
  448. marshall_from_mar_name_t (&edi->edi_pub_name, &evt->led_publisher_name);
  449. if (edi->edi_event_data_size) {
  450. edi->edi_event_data = malloc(edi->edi_event_data_size);
  451. if (!edi->edi_event_data) {
  452. saHandleDestroy(&event_handle_db, *event_handle);
  453. /*
  454. * saEvtDispatch doesn't return SA_AIS_ERR_NO_MEMORY
  455. */
  456. error = SA_AIS_ERR_LIBRARY;
  457. goto make_evt_done_put2;
  458. }
  459. memcpy(edi->edi_event_data,
  460. evt->led_body + evt->led_user_data_offset,
  461. edi->edi_event_data_size);
  462. }
  463. /*
  464. * Move the pattern bits into the SaEvtEventPatternArrayT
  465. */
  466. edi->edi_patterns.patternsNumber = evt->led_patterns_number;
  467. edi->edi_patterns.allocatedNumber = evt->led_patterns_number;
  468. edi->edi_patterns.patterns = malloc(sizeof(SaEvtEventPatternT) *
  469. edi->edi_patterns.patternsNumber);
  470. if (!edi->edi_patterns.patterns) {
  471. /*
  472. * The destructor will take care of freeing event data already
  473. * allocated.
  474. */
  475. edi->edi_patterns.patternsNumber = 0;
  476. saHandleDestroy(&event_handle_db, *event_handle);
  477. /*
  478. * saEvtDispatch doesn't return SA_AIS_ERR_NO_MEMORY
  479. */
  480. error = SA_AIS_ERR_LIBRARY;
  481. goto make_evt_done_put2;
  482. }
  483. memset(edi->edi_patterns.patterns, 0, sizeof(SaEvtEventPatternT) *
  484. edi->edi_patterns.patternsNumber);
  485. pat = (mar_evt_event_pattern_t *)evt->led_body;
  486. str = evt->led_body + sizeof(mar_evt_event_pattern_t) *
  487. edi->edi_patterns.patternsNumber;
  488. for (i = 0; i < evt->led_patterns_number; i++) {
  489. edi->edi_patterns.patterns[i].patternSize = pat->pattern_size;
  490. edi->edi_patterns.patterns[i].allocatedSize = pat->pattern_size;
  491. edi->edi_patterns.patterns[i].pattern = malloc(pat->pattern_size);
  492. if (!edi->edi_patterns.patterns[i].pattern) {
  493. DPRINT (("make_event: couldn't alloc %llu bytes\n",
  494. (unsigned long long)pat->pattern_size));
  495. saHandleDestroy(&event_handle_db, *event_handle);
  496. error = SA_AIS_ERR_LIBRARY;
  497. goto make_evt_done_put2;
  498. }
  499. // TODO marshall pattern
  500. memcpy(edi->edi_patterns.patterns[i].pattern,
  501. str, pat->pattern_size);
  502. str += pat->pattern_size;
  503. pat++;
  504. }
  505. hl = malloc(sizeof(*hl));
  506. if (!hl) {
  507. saHandleDestroy(&event_handle_db, *event_handle);
  508. error = SA_AIS_ERR_LIBRARY;
  509. } else {
  510. edi->edi_hl = hl;
  511. hl->hl_handle = *event_handle;
  512. list_init(&hl->hl_entry);
  513. list_add(&hl->hl_entry, &eci->eci_event_list);
  514. }
  515. make_evt_done_put2:
  516. saHandleInstancePut (&channel_handle_db, evt->led_lib_channel_handle);
  517. make_evt_done_put:
  518. saHandleInstancePut (&event_handle_db, *event_handle);
  519. make_evt_done:
  520. return error;
  521. }
  522. /*
  523. * The saEvtDispatch() function invokes, in the context of the calling
  524. * thread, one or all of the pending callbacks for the handle evtHandle.
  525. */
  526. SaAisErrorT
  527. saEvtDispatch(
  528. SaEvtHandleT evtHandle,
  529. SaDispatchFlagsT dispatchFlags)
  530. {
  531. struct pollfd ufds;
  532. int timeout = -1;
  533. SaAisErrorT error;
  534. int dispatch_avail;
  535. struct event_instance *evti;
  536. SaEvtEventHandleT event_handle;
  537. SaEvtCallbacksT callbacks;
  538. int ignore_dispatch = 0;
  539. int cont = 1; /* always continue do loop except when set to 0 */
  540. int poll_fd;
  541. struct res_overlay dispatch_data;
  542. struct lib_event_data *evt = 0;
  543. struct res_evt_event_data res;
  544. if (dispatchFlags < SA_DISPATCH_ONE ||
  545. dispatchFlags > SA_DISPATCH_BLOCKING) {
  546. return SA_AIS_ERR_INVALID_PARAM;
  547. }
  548. error = saHandleInstanceGet(&evt_instance_handle_db, evtHandle,
  549. (void *)&evti);
  550. if (error != SA_AIS_OK) {
  551. return error;
  552. }
  553. /*
  554. * Timeout instantly for SA_DISPATCH_ALL
  555. */
  556. if (dispatchFlags == SA_DISPATCH_ALL || dispatchFlags == SA_DISPATCH_ONE) {
  557. timeout = 0;
  558. }
  559. do {
  560. poll_fd = evti->ei_dispatch_fd;
  561. ufds.fd = poll_fd;
  562. ufds.events = POLLIN;
  563. ufds.revents = 0;
  564. error = saPollRetry(&ufds, 1, timeout);
  565. if (error != SA_AIS_OK) {
  566. goto dispatch_put;
  567. }
  568. pthread_mutex_lock(&evti->ei_dispatch_mutex);
  569. /*
  570. * Handle has been finalized in another thread
  571. */
  572. if (evti->ei_finalize == 1) {
  573. error = SA_AIS_OK;
  574. goto dispatch_unlock;
  575. }
  576. /*
  577. * If we know that we have an event waiting, we can skip the
  578. * polling and just ask for it.
  579. */
  580. if (!evti->ei_data_available) {
  581. /*
  582. * Check the poll data in case the fd status has changed
  583. * since taking the lock
  584. */
  585. error = saPollRetry(&ufds, 1, 0);
  586. if (error != SA_AIS_OK) {
  587. goto dispatch_unlock;
  588. }
  589. if ((ufds.revents & (POLLERR|POLLHUP|POLLNVAL)) != 0) {
  590. error = SA_AIS_ERR_BAD_HANDLE;
  591. goto dispatch_unlock;
  592. }
  593. dispatch_avail = ufds.revents & POLLIN;
  594. if (dispatch_avail == 0 &&
  595. (dispatchFlags == SA_DISPATCH_ALL ||
  596. dispatchFlags == SA_DISPATCH_ONE)) {
  597. pthread_mutex_unlock(&evti->ei_dispatch_mutex);
  598. break; /* exit do while cont is 1 loop */
  599. } else if (dispatch_avail == 0) {
  600. pthread_mutex_unlock(&evti->ei_dispatch_mutex);
  601. continue; /* next poll */
  602. }
  603. if (ufds.revents & POLLIN) {
  604. error = saRecvRetry (evti->ei_dispatch_fd, &dispatch_data.header,
  605. sizeof (mar_res_header_t));
  606. if (error != SA_AIS_OK) {
  607. goto dispatch_unlock;
  608. }
  609. if (dispatch_data.header.size > sizeof (mar_res_header_t)) {
  610. error = saRecvRetry (evti->ei_dispatch_fd, &dispatch_data.data,
  611. dispatch_data.header.size - sizeof (mar_res_header_t));
  612. if (error != SA_AIS_OK) {
  613. goto dispatch_unlock;
  614. }
  615. }
  616. } else {
  617. pthread_mutex_unlock(&evti->ei_dispatch_mutex);
  618. continue;
  619. }
  620. } else {
  621. /*
  622. * We know that we have an event available from before.
  623. * Fake up a header message and the switch statement will
  624. * take care of the rest.
  625. */
  626. dispatch_data.header.id = MESSAGE_RES_EVT_AVAILABLE;
  627. }
  628. /*
  629. * Make copy of callbacks, message data, unlock instance,
  630. * and call callback. A risk of this dispatch method is that
  631. * the callback routines may operate at the same time that
  632. * EvtFinalize has been called in another thread.
  633. */
  634. memcpy(&callbacks, &evti->ei_callback, sizeof(evti->ei_callback));
  635. pthread_mutex_unlock(&evti->ei_dispatch_mutex);
  636. /*
  637. * Dispatch incoming response
  638. */
  639. switch (dispatch_data.header.id) {
  640. case MESSAGE_RES_EVT_AVAILABLE:
  641. evti->ei_data_available = 0;
  642. /*
  643. * There are events available. Send a request for one and then
  644. * dispatch it.
  645. */
  646. res.evd_head.id = MESSAGE_REQ_EVT_EVENT_DATA;
  647. res.evd_head.size = sizeof(res);
  648. pthread_mutex_lock(&evti->ei_response_mutex);
  649. error = saSendRetry(evti->ei_response_fd, &res, sizeof(res));
  650. if (error != SA_AIS_OK) {
  651. DPRINT (("MESSAGE_RES_EVT_AVAILABLE: send failed: %d\n", error));
  652. pthread_mutex_unlock(&evti->ei_response_mutex);
  653. break;
  654. }
  655. error = evt_recv_event(evti->ei_response_fd, &evt);
  656. pthread_mutex_unlock(&evti->ei_response_mutex);
  657. if (error != SA_AIS_OK) {
  658. DPRINT (("MESSAGE_RES_EVT_AVAILABLE: receive failed: %d\n", error));
  659. break;
  660. }
  661. /*
  662. * No data available. This is OK, another thread may have
  663. * grabbed it.
  664. */
  665. if (evt->led_head.error == SA_AIS_ERR_NOT_EXIST) {
  666. error = SA_AIS_OK;
  667. break;
  668. }
  669. if (evt->led_head.error != SA_AIS_OK) {
  670. error = evt->led_head.error;
  671. /*
  672. * If we get a try again response, we've lost the poll event
  673. * so we have a data available flag so that we know that there
  674. * really is an event waiting the next time dispatch gets
  675. * called.
  676. */
  677. if (error == SA_AIS_ERR_TRY_AGAIN) {
  678. evti->ei_data_available = 1;
  679. } else {
  680. DPRINT (("MESSAGE_RES_EVT_AVAILABLE: Error returned: %d\n", error));
  681. }
  682. break;
  683. }
  684. error = make_event(&event_handle, evt);
  685. if (error != SA_AIS_OK) {
  686. break;
  687. }
  688. /*
  689. * Only call if there was a function registered
  690. */
  691. if (callbacks.saEvtEventDeliverCallback) {
  692. callbacks.saEvtEventDeliverCallback(evt->led_sub_id,
  693. event_handle, evt->led_user_data_size);
  694. }
  695. break;
  696. case MESSAGE_RES_EVT_CHAN_OPEN_CALLBACK:
  697. {
  698. struct res_evt_open_chan_async *resa =
  699. (struct res_evt_open_chan_async *)&dispatch_data;
  700. struct event_channel_instance *eci;
  701. /*
  702. * Check for errors. If there are none, then
  703. * look up the local channel via the handle that we
  704. * got from the callback request. All we need to do
  705. * is place in the handle from the server side and then
  706. * we can call the callback.
  707. */
  708. error = resa->ica_head.error;
  709. if (error == SA_AIS_OK) {
  710. error = saHandleInstanceGet(&channel_handle_db,
  711. resa->ica_c_handle, (void*)&eci);
  712. if (error == SA_AIS_OK) {
  713. eci->eci_svr_channel_handle = resa->ica_channel_handle;
  714. saHandleInstancePut (&channel_handle_db,
  715. resa->ica_c_handle);
  716. }
  717. }
  718. /*
  719. * Only call if there was a function registered
  720. */
  721. if (callbacks.saEvtChannelOpenCallback) {
  722. callbacks.saEvtChannelOpenCallback(resa->ica_invocation,
  723. resa->ica_c_handle, error);
  724. }
  725. }
  726. break;
  727. default:
  728. DPRINT (("Dispatch: Bad message type 0x%x\n", dispatch_data.header.id));
  729. error = SA_AIS_ERR_LIBRARY;
  730. goto dispatch_put;
  731. }
  732. /*
  733. * If empty is zero it means the we got the
  734. * message from the queue and we are responsible
  735. * for freeing it.
  736. */
  737. if (evt) {
  738. free(evt);
  739. evt = 0;
  740. }
  741. /*
  742. * Determine if more messages should be processed
  743. */
  744. switch (dispatchFlags) {
  745. case SA_DISPATCH_ONE:
  746. if (ignore_dispatch) {
  747. ignore_dispatch = 0;
  748. } else {
  749. cont = 0;
  750. }
  751. break;
  752. case SA_DISPATCH_ALL:
  753. if (ignore_dispatch) {
  754. ignore_dispatch = 0;
  755. }
  756. break;
  757. case SA_DISPATCH_BLOCKING:
  758. break;
  759. }
  760. } while (cont);
  761. goto dispatch_put;
  762. dispatch_unlock:
  763. pthread_mutex_unlock(&evti->ei_dispatch_mutex);
  764. dispatch_put:
  765. saHandleInstancePut(&evt_instance_handle_db, evtHandle);
  766. return error;
  767. }
  768. /*
  769. * The saEvtFinalize() function closes the association, represented by the
  770. * evtHandle parameter, between the process and the Event Service. It may
  771. * free up resources.
  772. * This function cannot be invoked before the process has invoked the
  773. * corresponding saEvtInitialize() function for the Event Service. After
  774. * this function is invoked, the selection object is no longer valid.
  775. * Moreover, the Event Service is unavailable for further use unless it is
  776. * reinitialized using the saEvtInitialize() function.
  777. */
  778. SaAisErrorT
  779. saEvtFinalize(SaEvtHandleT evtHandle)
  780. {
  781. struct event_instance *evti;
  782. SaAisErrorT error;
  783. error = saHandleInstanceGet(&evt_instance_handle_db, evtHandle,
  784. (void *)&evti);
  785. if (error != SA_AIS_OK) {
  786. return error;
  787. }
  788. pthread_mutex_lock(&evti->ei_response_mutex);
  789. /*
  790. * Another thread has already started finalizing
  791. */
  792. if (evti->ei_finalize) {
  793. pthread_mutex_unlock(&evti->ei_response_mutex);
  794. saHandleInstancePut(&evt_instance_handle_db, evtHandle);
  795. return SA_AIS_ERR_BAD_HANDLE;
  796. }
  797. evti->ei_finalize = 1;
  798. pthread_mutex_unlock(&evti->ei_response_mutex);
  799. saHandleDestroy(&evt_instance_handle_db, evtHandle);
  800. /*
  801. * Disconnect from the server
  802. */
  803. if (evti->ei_response_fd != -1) {
  804. shutdown(evti->ei_response_fd, 0);
  805. close(evti->ei_response_fd);
  806. }
  807. if (evti->ei_dispatch_fd != -1) {
  808. shutdown(evti->ei_dispatch_fd, 0);
  809. close(evti->ei_dispatch_fd);
  810. }
  811. saHandleInstancePut(&evt_instance_handle_db, evtHandle);
  812. return error;
  813. }
  814. /*
  815. * The saEvtChannelOpen() function creates a new event channel or open an
  816. * existing channel. The saEvtChannelOpen() function is a blocking operation
  817. * and returns a new event channel handle. An event channel may be opened
  818. * multiple times by the same or different processes for publishing, and
  819. * subscribing to, events. If a process opens an event channel multiple
  820. * times, it is possible to receive the same event multiple times. However,
  821. * a process shall never receive an event more than once on a particular
  822. * event channel handle. If a process opens a channel twice and an event is
  823. * matched on both open channels, the Event Service performs two
  824. * callbacks -- one for each opened channel.
  825. */
  826. SaAisErrorT
  827. saEvtChannelOpen(
  828. SaEvtHandleT evtHandle,
  829. const SaNameT *channelName,
  830. SaEvtChannelOpenFlagsT channelOpenFlags,
  831. SaTimeT timeout,
  832. SaEvtChannelHandleT *channelHandle)
  833. {
  834. struct event_instance *evti;
  835. struct req_evt_channel_open req;
  836. struct res_evt_channel_open res;
  837. struct event_channel_instance *eci;
  838. struct handle_list *hl;
  839. SaAisErrorT error;
  840. struct iovec iov;
  841. if (!channelHandle || !channelName) {
  842. return SA_AIS_ERR_INVALID_PARAM;
  843. }
  844. if ((channelOpenFlags & ~(SA_EVT_CHANNEL_CREATE|SA_EVT_CHANNEL_PUBLISHER|
  845. SA_EVT_CHANNEL_SUBSCRIBER)) != 0) {
  846. return SA_AIS_ERR_BAD_FLAGS;
  847. }
  848. error = saHandleInstanceGet(&evt_instance_handle_db, evtHandle,
  849. (void*)&evti);
  850. if (error != SA_AIS_OK) {
  851. goto chan_open_done;
  852. }
  853. /*
  854. * create a handle for this open channel
  855. */
  856. error = saHandleCreate(&channel_handle_db, sizeof(*eci),
  857. channelHandle);
  858. if (error != SA_AIS_OK) {
  859. goto chan_open_put;
  860. }
  861. error = saHandleInstanceGet(&channel_handle_db, *channelHandle,
  862. (void*)&eci);
  863. if (error != SA_AIS_OK) {
  864. saHandleDestroy(&channel_handle_db, *channelHandle);
  865. goto chan_open_put;
  866. }
  867. list_init(&eci->eci_event_list);
  868. /*
  869. * Send the request to the server and wait for a response
  870. */
  871. req.ico_head.size = sizeof(req);
  872. req.ico_head.id = MESSAGE_REQ_EVT_OPEN_CHANNEL;
  873. req.ico_c_handle = *channelHandle;
  874. req.ico_timeout = timeout;
  875. req.ico_open_flag = channelOpenFlags;
  876. marshall_to_mar_name_t (&req.ico_channel_name, (SaNameT *)channelName);
  877. iov.iov_base = &req;
  878. iov.iov_len = sizeof(req);
  879. pthread_mutex_lock(&evti->ei_response_mutex);
  880. error = saSendMsgReceiveReply(evti->ei_response_fd, &iov, 1,
  881. &res, sizeof(res));
  882. pthread_mutex_unlock (&evti->ei_response_mutex);
  883. if (error != SA_AIS_OK) {
  884. goto chan_open_free;
  885. }
  886. if (res.ico_head.id != MESSAGE_RES_EVT_OPEN_CHANNEL) {
  887. error = SA_AIS_ERR_LIBRARY;
  888. goto chan_open_free;
  889. }
  890. error = res.ico_head.error;
  891. if (error != SA_AIS_OK) {
  892. goto chan_open_free;
  893. }
  894. eci->eci_svr_channel_handle = res.ico_channel_handle;
  895. eci->eci_channel_name = *channelName;
  896. eci->eci_open_flags = channelOpenFlags;
  897. eci->eci_instance_handle = evtHandle;
  898. eci->eci_closing = 0;
  899. hl = malloc(sizeof(*hl));
  900. if (!hl) {
  901. error = SA_AIS_ERR_NO_MEMORY;
  902. goto chan_open_free;
  903. }
  904. eci->eci_hl = hl;
  905. hl->hl_handle = *channelHandle;
  906. list_init(&hl->hl_entry);
  907. list_add(&hl->hl_entry, &evti->ei_channel_list);
  908. pthread_mutex_init(&eci->eci_mutex, NULL);
  909. saHandleInstancePut (&evt_instance_handle_db, evtHandle);
  910. saHandleInstancePut (&channel_handle_db, *channelHandle);
  911. return SA_AIS_OK;
  912. chan_open_free:
  913. saHandleDestroy(&channel_handle_db, *channelHandle);
  914. saHandleInstancePut (&channel_handle_db, *channelHandle);
  915. chan_open_put:
  916. saHandleInstancePut (&evt_instance_handle_db, evtHandle);
  917. chan_open_done:
  918. return error;
  919. }
  920. /*
  921. * The saEvtChannelClose() function closes an event channel and frees
  922. * resources allocated for that event channel in the invoking process.
  923. */
  924. SaAisErrorT
  925. saEvtChannelClose(SaEvtChannelHandleT channelHandle)
  926. {
  927. SaAisErrorT error;
  928. struct event_instance *evti;
  929. struct event_channel_instance *eci;
  930. struct req_evt_channel_close req;
  931. struct res_evt_channel_close res;
  932. struct iovec iov;
  933. error = saHandleInstanceGet(&channel_handle_db, channelHandle,
  934. (void*)&eci);
  935. if (error != SA_AIS_OK) {
  936. goto chan_close_done;
  937. }
  938. /*
  939. * get the evt handle for the fd
  940. */
  941. error = saHandleInstanceGet(&evt_instance_handle_db,
  942. eci->eci_instance_handle, (void*)&evti);
  943. if (error != SA_AIS_OK) {
  944. goto chan_close_put1;
  945. }
  946. /*
  947. * Make sure that the channel isn't being closed elsewhere
  948. */
  949. pthread_mutex_lock(&eci->eci_mutex);
  950. if (eci->eci_closing) {
  951. pthread_mutex_unlock(&eci->eci_mutex);
  952. saHandleInstancePut(&channel_handle_db, channelHandle);
  953. return SA_AIS_ERR_BAD_HANDLE;
  954. }
  955. eci->eci_closing = 1;
  956. pthread_mutex_unlock(&eci->eci_mutex);
  957. /*
  958. * Send the request to the server and wait for a response
  959. */
  960. req.icc_head.size = sizeof(req);
  961. req.icc_head.id = MESSAGE_REQ_EVT_CLOSE_CHANNEL;
  962. req.icc_channel_handle = eci->eci_svr_channel_handle;
  963. iov.iov_base = &req;
  964. iov.iov_len = sizeof (req);
  965. pthread_mutex_lock(&evti->ei_response_mutex);
  966. error = saSendMsgReceiveReply (evti->ei_response_fd, &iov, 1,
  967. &res, sizeof (res));
  968. pthread_mutex_unlock(&evti->ei_response_mutex);
  969. if (error != SA_AIS_OK) {
  970. eci->eci_closing = 0;
  971. goto chan_close_put2;
  972. }
  973. if (res.icc_head.id != MESSAGE_RES_EVT_CLOSE_CHANNEL) {
  974. error = SA_AIS_ERR_LIBRARY;
  975. eci->eci_closing = 0;
  976. goto chan_close_put2;
  977. }
  978. error = res.icc_head.error;
  979. if (error == SA_AIS_ERR_TRY_AGAIN) {
  980. pthread_mutex_lock(&eci->eci_mutex);
  981. eci->eci_closing = 0;
  982. pthread_mutex_unlock(&eci->eci_mutex);
  983. goto chan_close_put2;
  984. }
  985. saHandleInstancePut(&evt_instance_handle_db,
  986. eci->eci_instance_handle);
  987. saHandleDestroy(&channel_handle_db, channelHandle);
  988. saHandleInstancePut(&channel_handle_db, channelHandle);
  989. return error;
  990. chan_close_put2:
  991. saHandleInstancePut(&evt_instance_handle_db,
  992. eci->eci_instance_handle);
  993. chan_close_put1:
  994. saHandleInstancePut(&channel_handle_db, channelHandle);
  995. chan_close_done:
  996. return error;
  997. }
  998. /*
  999. * The saEvtChannelOpenAsync() function creates a new event channel or open an
  1000. * existing channel. The saEvtChannelOpenAsync() function is a non-blocking
  1001. * operation. A new event channel handle is returned in the channel open
  1002. * callback function (SaEvtChannelOpenCallbackT).
  1003. */
  1004. SaAisErrorT
  1005. saEvtChannelOpenAsync(SaEvtHandleT evtHandle,
  1006. SaInvocationT invocation,
  1007. const SaNameT *channelName,
  1008. SaEvtChannelOpenFlagsT channelOpenFlags)
  1009. {
  1010. struct event_instance *evti;
  1011. struct req_evt_channel_open req;
  1012. struct res_evt_channel_open res;
  1013. struct event_channel_instance *eci;
  1014. SaEvtChannelHandleT channel_handle;
  1015. SaAisErrorT error;
  1016. struct handle_list *hl;
  1017. struct iovec iov;
  1018. if (!channelName) {
  1019. return SA_AIS_ERR_INVALID_PARAM;
  1020. }
  1021. if ((channelOpenFlags & ~(SA_EVT_CHANNEL_CREATE|SA_EVT_CHANNEL_PUBLISHER|
  1022. SA_EVT_CHANNEL_SUBSCRIBER)) != 0) {
  1023. return SA_AIS_ERR_BAD_FLAGS;
  1024. }
  1025. error = saHandleInstanceGet(&evt_instance_handle_db, evtHandle,
  1026. (void*)&evti);
  1027. if (error != SA_AIS_OK) {
  1028. goto chan_open_done;
  1029. }
  1030. /*
  1031. * Make sure that an open channel callback has been
  1032. * registered before allowing the open to continue.
  1033. */
  1034. if (!evti->ei_callback.saEvtChannelOpenCallback) {
  1035. error = SA_AIS_ERR_INIT;
  1036. goto chan_open_put;
  1037. }
  1038. /*
  1039. * create a handle for this open channel
  1040. */
  1041. error = saHandleCreate(&channel_handle_db, sizeof(*eci),
  1042. &channel_handle);
  1043. if (error != SA_AIS_OK) {
  1044. goto chan_open_put;
  1045. }
  1046. error = saHandleInstanceGet(&channel_handle_db, channel_handle,
  1047. (void*)&eci);
  1048. if (error != SA_AIS_OK) {
  1049. saHandleDestroy(&channel_handle_db, channel_handle);
  1050. goto chan_open_put;
  1051. }
  1052. list_init(&eci->eci_event_list);
  1053. /*
  1054. * Send the request to the server. The response isn't the open channel,
  1055. * just an ack. The open channel will be returned when the channel open
  1056. * callback is called.
  1057. */
  1058. req.ico_head.size = sizeof(req);
  1059. req.ico_head.id = MESSAGE_REQ_EVT_OPEN_CHANNEL_ASYNC;
  1060. req.ico_c_handle = channel_handle;
  1061. req.ico_timeout = 0;
  1062. req.ico_invocation = invocation;
  1063. req.ico_open_flag = channelOpenFlags;
  1064. marshall_to_mar_name_t (&req.ico_channel_name, (SaNameT *)channelName);
  1065. iov.iov_base = &req;
  1066. iov.iov_len = sizeof(req);
  1067. pthread_mutex_lock(&evti->ei_response_mutex);
  1068. error = saSendMsgReceiveReply (evti->ei_response_fd, &iov, 1,
  1069. &res, sizeof (res));
  1070. pthread_mutex_unlock(&evti->ei_response_mutex);
  1071. if (error != SA_AIS_OK) {
  1072. goto chan_open_free;
  1073. }
  1074. if (res.ico_head.id != MESSAGE_RES_EVT_OPEN_CHANNEL) {
  1075. error = SA_AIS_ERR_LIBRARY;
  1076. goto chan_open_free;
  1077. }
  1078. error = res.ico_head.error;
  1079. if (error != SA_AIS_OK) {
  1080. goto chan_open_free;
  1081. }
  1082. eci->eci_svr_channel_handle = 0; /* filled in by callback */
  1083. eci->eci_channel_name = *channelName;
  1084. eci->eci_open_flags = channelOpenFlags;
  1085. eci->eci_instance_handle = evtHandle;
  1086. eci->eci_closing = 0;
  1087. list_init(&eci->eci_event_list);
  1088. hl = malloc(sizeof(*hl));
  1089. if (!hl) {
  1090. error = SA_AIS_ERR_NO_MEMORY;
  1091. goto chan_open_free;
  1092. }
  1093. eci->eci_hl = hl;
  1094. hl->hl_handle = channel_handle;
  1095. list_init(&hl->hl_entry);
  1096. list_add(&hl->hl_entry, &evti->ei_channel_list);
  1097. pthread_mutex_init(&eci->eci_mutex, NULL);
  1098. saHandleInstancePut (&evt_instance_handle_db, evtHandle);
  1099. saHandleInstancePut (&channel_handle_db, channel_handle);
  1100. return SA_AIS_OK;
  1101. chan_open_free:
  1102. saHandleDestroy(&channel_handle_db, channel_handle);
  1103. saHandleInstancePut (&channel_handle_db, channel_handle);
  1104. chan_open_put:
  1105. saHandleInstancePut (&evt_instance_handle_db, evtHandle);
  1106. chan_open_done:
  1107. return error;
  1108. }
  1109. /*
  1110. * The SaEvtChannelUnlink function deletes an existing event channel
  1111. * from the cluster.
  1112. *
  1113. * After completion of the invocation:
  1114. * - An open of the channel name without a create will fail.
  1115. * - The channel remains available to any already opened instances.
  1116. * - If an open/create is performed on this channel name a new instance
  1117. * is created.
  1118. * - The ulinked channel's resources will be deleted when the last open
  1119. * instance is closed.
  1120. *
  1121. * Note that an event channel is only deleted from the cluster
  1122. * namespace when saEvtChannelUnlink() is invoked on it. The deletion
  1123. * of an event channel frees all resources allocated by the Event
  1124. * Service for it, such as published events with non-zero retention
  1125. * time.
  1126. */
  1127. SaAisErrorT
  1128. saEvtChannelUnlink(
  1129. SaEvtHandleT evtHandle,
  1130. const SaNameT *channelName)
  1131. {
  1132. struct event_instance *evti;
  1133. struct req_evt_channel_unlink req;
  1134. struct res_evt_channel_unlink res;
  1135. struct iovec iov;
  1136. SaAisErrorT error;
  1137. if (!channelName) {
  1138. return SA_AIS_ERR_INVALID_PARAM;
  1139. }
  1140. error = saHandleInstanceGet(&evt_instance_handle_db, evtHandle,
  1141. (void*)&evti);
  1142. if (error != SA_AIS_OK) {
  1143. goto chan_unlink_done;
  1144. }
  1145. /*
  1146. * Send the request to the server and wait for a response
  1147. */
  1148. req.iuc_head.size = sizeof(req);
  1149. req.iuc_head.id = MESSAGE_REQ_EVT_UNLINK_CHANNEL;
  1150. marshall_to_mar_name_t (&req.iuc_channel_name, (SaNameT *)channelName);
  1151. iov.iov_base = &req;
  1152. iov.iov_len = sizeof(req);
  1153. pthread_mutex_lock(&evti->ei_response_mutex);
  1154. error = saSendMsgReceiveReply (evti->ei_response_fd, &iov, 1,
  1155. &res, sizeof (res));
  1156. pthread_mutex_unlock(&evti->ei_response_mutex);
  1157. if (error != SA_AIS_OK) {
  1158. goto chan_unlink_put;
  1159. }
  1160. if (res.iuc_head.id != MESSAGE_RES_EVT_UNLINK_CHANNEL) {
  1161. error = SA_AIS_ERR_LIBRARY;
  1162. goto chan_unlink_put;
  1163. }
  1164. error = res.iuc_head.error;
  1165. chan_unlink_put:
  1166. saHandleInstancePut (&evt_instance_handle_db, evtHandle);
  1167. chan_unlink_done:
  1168. return error;
  1169. }
  1170. /*
  1171. * The saEvtEventAllocate() function allocates memory for the event, but not
  1172. * for the eventHandle, and initializes all event attributes to default values.
  1173. * The event allocated by saEvtEventAllocate() is freed by invoking
  1174. * saEvtEventFree().
  1175. * The memory associated with the eventHandle is not deallocated by the
  1176. * saEvtEventAllocate() function or the saEvtEventFree() function. It is the
  1177. * responsibility of the invoking process to deallocate the memory for the
  1178. * eventHandle when the process has published the event and has freed the
  1179. * event by invoking saEvtEventFree().
  1180. */
  1181. SaAisErrorT
  1182. saEvtEventAllocate(
  1183. const SaEvtChannelHandleT channelHandle,
  1184. SaEvtEventHandleT *eventHandle)
  1185. {
  1186. SaAisErrorT error;
  1187. struct event_data_instance *edi;
  1188. struct event_instance *evti;
  1189. struct event_channel_instance *eci;
  1190. struct handle_list *hl;
  1191. if (!eventHandle) {
  1192. return SA_AIS_ERR_INVALID_PARAM;
  1193. }
  1194. error = saHandleInstanceGet(&channel_handle_db, channelHandle,
  1195. (void*)&eci);
  1196. if (error != SA_AIS_OK) {
  1197. goto alloc_done;
  1198. }
  1199. error = saHandleInstanceGet(&evt_instance_handle_db,
  1200. eci->eci_instance_handle, (void*)&evti);
  1201. if (error != SA_AIS_OK) {
  1202. goto alloc_put1;
  1203. }
  1204. error = saHandleCreate(&event_handle_db, sizeof(*edi),
  1205. eventHandle);
  1206. if (error != SA_AIS_OK) {
  1207. goto alloc_put2;
  1208. }
  1209. error = saHandleInstanceGet(&event_handle_db, *eventHandle,
  1210. (void*)&edi);
  1211. if (error != SA_AIS_OK) {
  1212. saHandleDestroy(&event_handle_db, *eventHandle);
  1213. goto alloc_put2;
  1214. }
  1215. pthread_mutex_init(&edi->edi_mutex, NULL);
  1216. edi->edi_ro = 0;
  1217. edi->edi_freeing = 0;
  1218. edi->edi_channel_handle = channelHandle;
  1219. edi->edi_pub_node = evti->ei_node_id;
  1220. edi->edi_priority = SA_EVT_LOWEST_PRIORITY;
  1221. edi->edi_event_id = SA_EVT_EVENTID_NONE;
  1222. edi->edi_pub_time = SA_TIME_UNKNOWN;
  1223. edi->edi_retention_time = 0;
  1224. hl = malloc(sizeof(*hl));
  1225. if (!hl) {
  1226. saHandleDestroy(&event_handle_db, *eventHandle);
  1227. error = SA_AIS_ERR_NO_MEMORY;
  1228. goto alloc_put2;
  1229. }
  1230. edi->edi_hl = hl;
  1231. hl->hl_handle = *eventHandle;
  1232. list_init(&hl->hl_entry);
  1233. list_add(&hl->hl_entry, &eci->eci_event_list);
  1234. saHandleInstancePut (&event_handle_db, *eventHandle);
  1235. alloc_put2:
  1236. saHandleInstancePut (&evt_instance_handle_db, eci->eci_instance_handle);
  1237. alloc_put1:
  1238. saHandleInstancePut (&channel_handle_db, channelHandle);
  1239. alloc_done:
  1240. return error;
  1241. }
  1242. /*
  1243. * The saEvtEventFree() function gives the Event Service premission to
  1244. * deallocate the memory that contains the attributes of the event that is
  1245. * associated with eventHandle. The function is used to free events allocated
  1246. * by saEvtEventAllocate() and by saEvtEventDeliverCallback().
  1247. */
  1248. SaAisErrorT
  1249. saEvtEventFree(SaEvtEventHandleT eventHandle)
  1250. {
  1251. SaAisErrorT error;
  1252. struct event_data_instance *edi;
  1253. error = saHandleInstanceGet(&event_handle_db, eventHandle,
  1254. (void*)&edi);
  1255. if (error != SA_AIS_OK) {
  1256. goto evt_free_done;
  1257. }
  1258. /*
  1259. * Make sure that the event isn't being freed elsewhere
  1260. */
  1261. pthread_mutex_lock(&edi->edi_mutex);
  1262. if (edi->edi_freeing) {
  1263. pthread_mutex_unlock(&edi->edi_mutex);
  1264. saHandleInstancePut(&event_handle_db, eventHandle);
  1265. return SA_AIS_ERR_BAD_HANDLE;
  1266. }
  1267. edi->edi_freeing = 1;
  1268. pthread_mutex_unlock(&edi->edi_mutex);
  1269. saHandleDestroy(&event_handle_db, eventHandle);
  1270. saHandleInstancePut(&event_handle_db, eventHandle);
  1271. evt_free_done:
  1272. return error;
  1273. }
  1274. /*
  1275. * This function may be used to assign writeable event attributes. It takes
  1276. * as arguments an event handle eventHandle and the attribute to be set in
  1277. * the event structure of the event with that handle. Note: The only
  1278. * attributes that a process can set are the patternArray, priority,
  1279. * retentionTime and publisherName attributes.
  1280. */
  1281. SaAisErrorT
  1282. saEvtEventAttributesSet(
  1283. const SaEvtEventHandleT eventHandle,
  1284. const SaEvtEventPatternArrayT *patternArray,
  1285. SaEvtEventPriorityT priority,
  1286. SaTimeT retentionTime,
  1287. const SaNameT *publisherName)
  1288. {
  1289. SaEvtEventPatternT *oldpatterns;
  1290. SaSizeT oldnumber;
  1291. SaAisErrorT error;
  1292. struct event_data_instance *edi;
  1293. int i;
  1294. if (priority > SA_EVT_LOWEST_PRIORITY) {
  1295. return SA_AIS_ERR_INVALID_PARAM;
  1296. }
  1297. error = saHandleInstanceGet(&event_handle_db, eventHandle,
  1298. (void*)&edi);
  1299. if (error != SA_AIS_OK) {
  1300. goto attr_set_done;
  1301. }
  1302. pthread_mutex_lock(&edi->edi_mutex);
  1303. /*
  1304. * Cannot modify an event returned via callback.
  1305. */
  1306. if (edi->edi_ro) {
  1307. error = SA_AIS_ERR_ACCESS;
  1308. goto attr_set_unlock;
  1309. }
  1310. edi->edi_priority = priority;
  1311. edi->edi_retention_time = retentionTime;
  1312. if (publisherName) {
  1313. edi->edi_pub_name = *publisherName;
  1314. }
  1315. if (!patternArray) {
  1316. goto attr_set_unlock;
  1317. }
  1318. oldpatterns = edi->edi_patterns.patterns;
  1319. oldnumber = edi->edi_patterns.patternsNumber;
  1320. edi->edi_patterns.patterns = 0;
  1321. edi->edi_patterns.patterns = malloc(sizeof(SaEvtEventPatternT) *
  1322. patternArray->patternsNumber);
  1323. if (!edi->edi_patterns.patterns) {
  1324. error = SA_AIS_ERR_NO_MEMORY;
  1325. goto attr_set_done_reset;
  1326. }
  1327. edi->edi_patterns.patternsNumber = patternArray->patternsNumber;
  1328. edi->edi_patterns.allocatedNumber = patternArray->patternsNumber;
  1329. /*
  1330. * copy the patterns from the caller. allocating memory for
  1331. * of all the strings.
  1332. */
  1333. for (i = 0; i < patternArray->patternsNumber; i++) {
  1334. edi->edi_patterns.patterns[i].pattern =
  1335. malloc(patternArray->patterns[i].patternSize);
  1336. if (!edi->edi_patterns.patterns[i].pattern) {
  1337. int j;
  1338. for (j = 0; j < i; j++) {
  1339. free(edi->edi_patterns.patterns[j].pattern);
  1340. }
  1341. free(edi->edi_patterns.patterns);
  1342. error = SA_AIS_ERR_NO_MEMORY;
  1343. goto attr_set_done_reset;
  1344. }
  1345. memcpy(edi->edi_patterns.patterns[i].pattern,
  1346. patternArray->patterns[i].pattern,
  1347. patternArray->patterns[i].patternSize);
  1348. edi->edi_patterns.patterns[i].patternSize =
  1349. patternArray->patterns[i].patternSize;
  1350. edi->edi_patterns.patterns[i].allocatedSize =
  1351. patternArray->patterns[i].patternSize;
  1352. }
  1353. /*
  1354. * free up the old pattern memory
  1355. */
  1356. if (oldpatterns) {
  1357. for (i = 0; i < oldnumber; i++) {
  1358. if (oldpatterns[i].pattern) {
  1359. free(oldpatterns[i].pattern);
  1360. }
  1361. }
  1362. free (oldpatterns);
  1363. }
  1364. goto attr_set_unlock;
  1365. attr_set_done_reset:
  1366. edi->edi_patterns.patterns = oldpatterns;
  1367. edi->edi_patterns.patternsNumber = oldnumber;
  1368. attr_set_unlock:
  1369. pthread_mutex_unlock(&edi->edi_mutex);
  1370. saHandleInstancePut(&event_handle_db, eventHandle);
  1371. attr_set_done:
  1372. return error;
  1373. }
  1374. /*
  1375. * This function takes as parameters an event handle eventHandle and the
  1376. * attributes of the event with that handle. The function retrieves the
  1377. * value of the attributes for the event and stores them at the address
  1378. * provided for the out parameters.
  1379. * It is the responsibility of the invoking process to allocate memory for
  1380. * the out parameters before it invokes this function. The Event Service
  1381. * assigns the out values into that memory. For each of the out, or in/out,
  1382. * parameters, if the invoking process provides a NULL reference, the
  1383. * Availability Management Framework does not return the out value.
  1384. * Similarly, it is the responsibility of the invoking process to allocate
  1385. * memory for the patternArray.
  1386. */
  1387. SaAisErrorT
  1388. saEvtEventAttributesGet(
  1389. SaEvtEventHandleT eventHandle,
  1390. SaEvtEventPatternArrayT *patternArray,
  1391. SaEvtEventPriorityT *priority,
  1392. SaTimeT *retentionTime,
  1393. SaNameT *publisherName,
  1394. SaTimeT *publishTime,
  1395. SaEvtEventIdT *eventId)
  1396. {
  1397. SaAisErrorT error;
  1398. struct event_data_instance *edi;
  1399. SaSizeT npats;
  1400. int i;
  1401. error = saHandleInstanceGet(&event_handle_db, eventHandle,
  1402. (void*)&edi);
  1403. if (error != SA_AIS_OK) {
  1404. goto attr_get_done;
  1405. }
  1406. pthread_mutex_lock(&edi->edi_mutex);
  1407. /*
  1408. * Go through the args and send back information if the pointer
  1409. * isn't NULL
  1410. */
  1411. if (eventId) {
  1412. *eventId = edi->edi_event_id;
  1413. }
  1414. if (publishTime) {
  1415. *publishTime = edi->edi_pub_time;
  1416. }
  1417. if (publisherName) {
  1418. *publisherName = edi->edi_pub_name;
  1419. }
  1420. if (retentionTime) {
  1421. *retentionTime = edi->edi_retention_time;
  1422. }
  1423. if (priority) {
  1424. *priority = edi->edi_priority;
  1425. }
  1426. if (!patternArray) {
  1427. goto attr_get_unlock;
  1428. }
  1429. /*
  1430. * The spec says that if the called passes in a NULL patterns array,
  1431. * then we allocate the required data and the caller is responsible
  1432. * for dealocating later. Otherwise, we copy to pre-allocated space.
  1433. * If there are more patterns than allcated space, we set the return
  1434. * code to SA_AIS_ERR_NO_SPACE and copy as much as will fit. We will
  1435. * return the total number of patterns available in the patternsNumber
  1436. * regardless of how much was allocated.
  1437. *
  1438. */
  1439. if (patternArray->patterns == NULL) {
  1440. npats = edi->edi_patterns.patternsNumber;
  1441. patternArray->allocatedNumber = edi->edi_patterns.patternsNumber;
  1442. patternArray->patternsNumber = edi->edi_patterns.patternsNumber;
  1443. patternArray->patterns = malloc(sizeof(*patternArray->patterns) *
  1444. edi->edi_patterns.patternsNumber);
  1445. if (!patternArray->patterns) {
  1446. error = SA_AIS_ERR_LIBRARY;
  1447. goto attr_get_unlock;
  1448. }
  1449. for (i = 0; i < edi->edi_patterns.patternsNumber; i++) {
  1450. patternArray->patterns[i].allocatedSize =
  1451. edi->edi_patterns.patterns[i].allocatedSize;
  1452. patternArray->patterns[i].patternSize =
  1453. edi->edi_patterns.patterns[i].patternSize;
  1454. patternArray->patterns[i].pattern =
  1455. malloc(edi->edi_patterns.patterns[i].patternSize);
  1456. if (!patternArray->patterns[i].pattern) {
  1457. int j;
  1458. /*
  1459. * back out previous mallocs
  1460. */
  1461. for (j = 0; j < i; j++) {
  1462. free(patternArray->patterns[j].pattern);
  1463. }
  1464. free(patternArray->patterns);
  1465. /*
  1466. * saEvtEventAttributesGet doesn't return
  1467. * SA_AIS_ERR_NO_MEMORY
  1468. */
  1469. error = SA_AIS_ERR_LIBRARY;
  1470. goto attr_get_unlock;
  1471. }
  1472. }
  1473. } else {
  1474. if (patternArray->allocatedNumber < edi->edi_patterns.allocatedNumber) {
  1475. error = SA_AIS_ERR_NO_SPACE;
  1476. npats = patternArray->allocatedNumber;
  1477. } else {
  1478. npats = edi->edi_patterns.patternsNumber;
  1479. }
  1480. }
  1481. patternArray->patternsNumber = edi->edi_patterns.patternsNumber;
  1482. /*
  1483. * copy the patterns to the callers structure. If we have pre-allocated
  1484. * data, the patterns may not fit in the supplied space. In that case we
  1485. * return NO_SPACE.
  1486. */
  1487. for (i = 0; i < npats; i++) {
  1488. memcpy(patternArray->patterns[i].pattern,
  1489. edi->edi_patterns.patterns[i].pattern,
  1490. min(patternArray->patterns[i].allocatedSize,
  1491. edi->edi_patterns.patterns[i].patternSize));
  1492. if (patternArray->patterns[i].allocatedSize <
  1493. edi->edi_patterns.patterns[i].patternSize) {
  1494. error = SA_AIS_ERR_NO_SPACE;
  1495. }
  1496. patternArray->patterns[i].patternSize =
  1497. edi->edi_patterns.patterns[i].patternSize;
  1498. }
  1499. attr_get_unlock:
  1500. pthread_mutex_unlock(&edi->edi_mutex);
  1501. saHandleInstancePut(&event_handle_db, eventHandle);
  1502. attr_get_done:
  1503. return error;
  1504. }
  1505. /*
  1506. * The saEvtEventDataGet() function allows a process to retrieve the data
  1507. * associated with an event previously delivered by
  1508. * saEvtEventDeliverCallback().
  1509. */
  1510. SaAisErrorT
  1511. saEvtEventDataGet(
  1512. const SaEvtEventHandleT eventHandle,
  1513. void *eventData,
  1514. SaSizeT *eventDataSize)
  1515. {
  1516. SaAisErrorT error = SA_AIS_ERR_INVALID_PARAM;
  1517. struct event_data_instance *edi;
  1518. SaSizeT xfsize;
  1519. if (!eventDataSize) {
  1520. goto data_get_done;
  1521. }
  1522. error = saHandleInstanceGet(&event_handle_db, eventHandle,
  1523. (void*)&edi);
  1524. if (error != SA_AIS_OK) {
  1525. goto data_get_done;
  1526. }
  1527. pthread_mutex_lock(&edi->edi_mutex);
  1528. /*
  1529. * If no buffer was supplied, then just tell the caller
  1530. * how large a buffer is needed.
  1531. */
  1532. if (!eventData) {
  1533. error = SA_AIS_ERR_NO_SPACE;
  1534. *eventDataSize = edi->edi_event_data_size;
  1535. goto unlock_put;
  1536. }
  1537. /*
  1538. * Can't get data from an event that wasn't
  1539. * a delivered event.
  1540. */
  1541. if (!edi->edi_ro) {
  1542. error = SA_AIS_ERR_BAD_HANDLE;
  1543. goto unlock_put;
  1544. }
  1545. if (edi->edi_event_data && edi->edi_event_data_size) {
  1546. xfsize = min(*eventDataSize, edi->edi_event_data_size);
  1547. if (*eventDataSize < edi->edi_event_data_size) {
  1548. error = SA_AIS_ERR_NO_SPACE;
  1549. }
  1550. *eventDataSize = edi->edi_event_data_size;
  1551. memcpy(eventData, edi->edi_event_data, xfsize);
  1552. } else {
  1553. *eventDataSize = 0;
  1554. }
  1555. unlock_put:
  1556. pthread_mutex_unlock(&edi->edi_mutex);
  1557. saHandleInstancePut(&event_handle_db, eventHandle);
  1558. data_get_done:
  1559. return error;
  1560. }
  1561. /*
  1562. * Calculate the size in bytes for patterns
  1563. */
  1564. static size_t patt_size(const SaEvtEventPatternArrayT *patterns)
  1565. {
  1566. int i;
  1567. size_t size = sizeof(mar_evt_event_pattern_array_t);
  1568. for (i = 0; i < patterns->patternsNumber; i++) {
  1569. size += sizeof(mar_evt_event_pattern_t);
  1570. size += patterns->patterns[i].patternSize;
  1571. }
  1572. return size;
  1573. }
  1574. /*
  1575. * copy patterns to a form for sending to the server
  1576. */
  1577. static uint32_t aispatt_to_evt_patt(
  1578. const SaEvtEventPatternArrayT *patterns,
  1579. void *data)
  1580. {
  1581. int i;
  1582. mar_evt_event_pattern_t *pats = data;
  1583. SaUint8T *str = (SaUint8T *)pats +
  1584. (patterns->patternsNumber * sizeof(*pats));
  1585. /*
  1586. * Pointers are replaced with offsets into the data array. These
  1587. * will be later converted back into pointers when received as events.
  1588. */
  1589. for (i = 0; i < patterns->patternsNumber; i++) {
  1590. // TODO marshall?
  1591. memcpy(str, patterns->patterns[i].pattern,
  1592. patterns->patterns[i].patternSize);
  1593. pats->pattern_size = patterns->patterns[i].patternSize;
  1594. pats->pattern = (SaUint8T *)((void *)str - data);
  1595. str += patterns->patterns[i].patternSize;
  1596. pats++;
  1597. }
  1598. return patterns->patternsNumber;
  1599. }
  1600. /*
  1601. * Calculate the size in bytes for filters
  1602. */
  1603. static size_t filt_size(const SaEvtEventFilterArrayT *filters)
  1604. {
  1605. int i;
  1606. size_t size = sizeof(mar_evt_event_filter_array_t);
  1607. for (i = 0; i < filters->filtersNumber; i++) {
  1608. size += sizeof(mar_evt_event_filter_t);
  1609. size += filters->filters[i].filter.patternSize;
  1610. }
  1611. return size;
  1612. }
  1613. /*
  1614. * Convert the Sa filters to a form that can be sent over the network
  1615. * i.e. replace pointers with offsets. The pointers will be reconstituted
  1616. * by the receiver.
  1617. */
  1618. static uint32_t aisfilt_to_evt_filt(
  1619. const SaEvtEventFilterArrayT *filters,
  1620. void *data)
  1621. {
  1622. int i;
  1623. mar_evt_event_filter_array_t *filtd = data;
  1624. mar_evt_event_filter_t *filts = data + sizeof(mar_evt_event_filter_array_t);
  1625. SaUint8T *str = (SaUint8T *)filts +
  1626. (filters->filtersNumber * sizeof(*filts));
  1627. /*
  1628. * Pointers are replaced with offsets into the data array. These
  1629. * will be later converted back into pointers by the evt server.
  1630. */
  1631. filtd->filters = (mar_evt_event_filter_t *)((void *)filts - data);
  1632. filtd->filters_number = filters->filtersNumber;
  1633. for (i = 0; i < filters->filtersNumber; i++) {
  1634. filts->filter_type = filters->filters[i].filterType;
  1635. filts->filter.pattern_size =
  1636. filters->filters[i].filter.patternSize;
  1637. // TODO marshall pattern
  1638. memcpy(str,
  1639. filters->filters[i].filter.pattern,
  1640. filters->filters[i].filter.patternSize);
  1641. filts->filter.pattern = (SaUint8T *)((void *)str - data);
  1642. str += filters->filters[i].filter.patternSize;
  1643. filts++;
  1644. }
  1645. return filters->filtersNumber;
  1646. }
  1647. /*
  1648. * The saEvtEventPublish() function publishes an event on the associated
  1649. * channel. The event to be published consists of a
  1650. * standard set of attributes (the event header) and an optional data part.
  1651. * Before an event can be published, the publisher process must invoke the
  1652. * saEvtEventPatternArraySet() function to set the event patterns. The event
  1653. * is delivered to subscribers whose subscription filter matches the event
  1654. * patterns.
  1655. * When the Event Service publishes an event, it automatically sets
  1656. * the following readonly event attributes:
  1657. * - Event attribute time
  1658. * - Event publisher identifier
  1659. * - Event publisher node identifier
  1660. * - Event identifier
  1661. * In addition to the event attributes, a process can supply values for the
  1662. * eventData and eventDataSize parameters for publication as part of the
  1663. * event. The data portion of the event may be at most SA_EVT_DATA_MAX_LEN
  1664. * bytes in length.
  1665. * The process may assume that the invocation of saEvtEventPublish() copies
  1666. * all pertinent parameters, including the memory associated with the
  1667. * eventHandle and eventData parameters, to its own local memory. However,
  1668. * the invocation does not automatically deallocate memory associated with
  1669. * the eventHandle and eventData parameters. It is the responsibility of the
  1670. * invoking process to deallocate the memory for those parameters after
  1671. * saEvtEventPublish() returns.
  1672. */
  1673. SaAisErrorT
  1674. saEvtEventPublish(
  1675. const SaEvtEventHandleT eventHandle,
  1676. const void *eventData,
  1677. SaSizeT eventDataSize,
  1678. SaEvtEventIdT *eventId)
  1679. {
  1680. SaAisErrorT error;
  1681. struct event_data_instance *edi;
  1682. struct event_instance *evti;
  1683. struct event_channel_instance *eci;
  1684. struct lib_event_data *req;
  1685. struct res_evt_event_publish res;
  1686. size_t pattern_size;
  1687. struct event_pattern *patterns;
  1688. void *data_start;
  1689. struct iovec iov;
  1690. if (!eventId) {
  1691. return SA_AIS_ERR_INVALID_PARAM;
  1692. }
  1693. if (eventDataSize > SA_EVT_DATA_MAX_LEN) {
  1694. error = SA_AIS_ERR_TOO_BIG;
  1695. goto pub_done;
  1696. }
  1697. error = saHandleInstanceGet(&event_handle_db, eventHandle,
  1698. (void*)&edi);
  1699. if (error != SA_AIS_OK) {
  1700. goto pub_done;
  1701. }
  1702. pthread_mutex_lock(&edi->edi_mutex);
  1703. error = saHandleInstanceGet(&channel_handle_db, edi->edi_channel_handle,
  1704. (void*)&eci);
  1705. if (error != SA_AIS_OK) {
  1706. goto pub_put1;
  1707. }
  1708. /*
  1709. * See if we can publish to this channel
  1710. */
  1711. if (!(eci->eci_open_flags & SA_EVT_CHANNEL_PUBLISHER)) {
  1712. error = SA_AIS_ERR_ACCESS;
  1713. goto pub_put2;
  1714. }
  1715. error = saHandleInstanceGet(&evt_instance_handle_db,
  1716. eci->eci_instance_handle, (void*)&evti);
  1717. if (error != SA_AIS_OK) {
  1718. goto pub_put2;
  1719. }
  1720. /*
  1721. * Figure out how much memory we need for the patterns and data
  1722. */
  1723. pattern_size = patt_size(&edi->edi_patterns);
  1724. req = malloc(sizeof(*req) + eventDataSize + pattern_size);
  1725. if (!req) {
  1726. error = SA_AIS_ERR_NO_MEMORY;
  1727. goto pub_put3;
  1728. }
  1729. patterns = (struct event_pattern *)req->led_body;
  1730. data_start = (void *)req->led_body + pattern_size;
  1731. /*
  1732. * copy everything to the request structure
  1733. */
  1734. aispatt_to_evt_patt(&edi->edi_patterns, patterns);
  1735. req->led_patterns_number = edi->edi_patterns.patternsNumber;
  1736. req->led_user_data_offset = pattern_size;
  1737. if (eventData && eventDataSize) {
  1738. memcpy(data_start, eventData, eventDataSize);
  1739. req->led_user_data_size = eventDataSize;
  1740. } else {
  1741. req->led_user_data_size = 0;
  1742. }
  1743. req->led_head.id = MESSAGE_REQ_EVT_PUBLISH;
  1744. req->led_head.size = sizeof(*req) + pattern_size + eventDataSize;
  1745. req->led_svr_channel_handle = eci->eci_svr_channel_handle;
  1746. req->led_retention_time = edi->edi_retention_time;
  1747. req->led_publish_time = clustTimeNow();
  1748. req->led_priority = edi->edi_priority;
  1749. marshall_to_mar_name_t (&req->led_publisher_name, &edi->edi_pub_name);
  1750. iov.iov_base = req;
  1751. iov.iov_len = req->led_head.size;
  1752. pthread_mutex_lock(&evti->ei_response_mutex);
  1753. error = saSendMsgReceiveReply(evti->ei_response_fd, &iov, 1, &res,
  1754. sizeof(res));
  1755. pthread_mutex_unlock (&evti->ei_response_mutex);
  1756. free(req);
  1757. if (error != SA_AIS_OK) {
  1758. pthread_mutex_unlock (&evti->ei_response_mutex);
  1759. goto pub_put3;
  1760. }
  1761. error = res.iep_head.error;
  1762. if (error == SA_AIS_OK) {
  1763. *eventId = res.iep_event_id;
  1764. }
  1765. pub_put3:
  1766. saHandleInstancePut (&evt_instance_handle_db, eci->eci_instance_handle);
  1767. pub_put2:
  1768. saHandleInstancePut (&channel_handle_db, edi->edi_channel_handle);
  1769. pub_put1:
  1770. pthread_mutex_unlock(&edi->edi_mutex);
  1771. saHandleInstancePut(&event_handle_db, eventHandle);
  1772. pub_done:
  1773. return error;
  1774. }
  1775. /*
  1776. * The saEvtEventSubscribe() function enables a process to subscribe for
  1777. * events on an event channel by registering one or more filters on that
  1778. * event channel. The process must have opened the event channel, designated
  1779. * by channelHandle, with the SA_EVT_CHANNEL_SUBSCRIBER flag set for an
  1780. * invocation of this function to be successful.
  1781. * The memory associated with the filters is not deallocated by the
  1782. * saEvtEventSubscribe() function. It is the responsibility of the invoking
  1783. * process to deallocate the memory when the saEvtEventSubscribe() function
  1784. * returns.
  1785. * For a given subscription, the filters parameter cannot be modified. To
  1786. * change the filters parameter without losing events, a process must
  1787. * establish a new subscription with the new filters parameter. After the new
  1788. * subscription is established, the old subscription can be removed by
  1789. * invoking the saEvtEventUnsubscribe() function.
  1790. */
  1791. SaAisErrorT
  1792. saEvtEventSubscribe(
  1793. const SaEvtChannelHandleT channelHandle,
  1794. const SaEvtEventFilterArrayT *filters,
  1795. SaEvtSubscriptionIdT subscriptionId)
  1796. {
  1797. SaAisErrorT error;
  1798. struct event_instance *evti;
  1799. struct event_channel_instance *eci;
  1800. struct req_evt_event_subscribe *req;
  1801. struct res_evt_event_subscribe res;
  1802. int sz;
  1803. struct iovec iov;
  1804. if (!filters) {
  1805. return SA_AIS_ERR_INVALID_PARAM;
  1806. }
  1807. error = saHandleInstanceGet(&channel_handle_db, channelHandle,
  1808. (void*)&eci);
  1809. if (error != SA_AIS_OK) {
  1810. goto subscribe_done;
  1811. }
  1812. /*
  1813. * get the evt handle for the fd
  1814. */
  1815. error = saHandleInstanceGet(&evt_instance_handle_db,
  1816. eci->eci_instance_handle, (void*)&evti);
  1817. if (error != SA_AIS_OK) {
  1818. goto subscribe_put1;
  1819. }
  1820. /*
  1821. * Make sure that a deliver callback has been
  1822. * registered before allowing the subscribe to continue.
  1823. */
  1824. if (!evti->ei_callback.saEvtEventDeliverCallback) {
  1825. error = SA_AIS_ERR_INIT;
  1826. goto subscribe_put2;
  1827. }
  1828. /*
  1829. * See if we can subscribe to this channel
  1830. */
  1831. if (!(eci->eci_open_flags & SA_EVT_CHANNEL_SUBSCRIBER)) {
  1832. error = SA_AIS_ERR_ACCESS;
  1833. goto subscribe_put2;
  1834. }
  1835. /*
  1836. * calculate size needed to store the filters
  1837. */
  1838. sz = filt_size(filters);
  1839. req = malloc(sizeof(*req) + sz);
  1840. if (!req) {
  1841. error = SA_AIS_ERR_NO_MEMORY;
  1842. goto subscribe_put2;
  1843. }
  1844. /*
  1845. * Copy the supplied filters to the request
  1846. */
  1847. req->ics_filter_count = aisfilt_to_evt_filt(filters,
  1848. req->ics_filter_data);
  1849. req->ics_head.id = MESSAGE_REQ_EVT_SUBSCRIBE;
  1850. req->ics_head.size = sizeof(*req) + sz;
  1851. req->ics_channel_handle = eci->eci_svr_channel_handle;
  1852. req->ics_sub_id = subscriptionId;
  1853. req->ics_filter_size = sz;
  1854. iov.iov_base = req;
  1855. iov.iov_len = req->ics_head.size;
  1856. pthread_mutex_lock(&evti->ei_response_mutex);
  1857. error = saSendMsgReceiveReply(evti->ei_response_fd, &iov, 1,
  1858. &res, sizeof(res));
  1859. pthread_mutex_unlock (&evti->ei_response_mutex);
  1860. free(req);
  1861. if (res.ics_head.id != MESSAGE_RES_EVT_SUBSCRIBE) {
  1862. goto subscribe_put2;
  1863. }
  1864. error = res.ics_head.error;
  1865. subscribe_put2:
  1866. saHandleInstancePut(&evt_instance_handle_db,
  1867. eci->eci_instance_handle);
  1868. subscribe_put1:
  1869. saHandleInstancePut(&channel_handle_db, channelHandle);
  1870. subscribe_done:
  1871. return error;
  1872. }
  1873. /*
  1874. * The saEvtEventUnsubscribe() function allows a process to stop receiving
  1875. * events for a particular subscription on an event channel by removing the
  1876. * subscription. The saEvtEventUnsubscribe() operation is successful if the
  1877. * subscriptionId parameter matches a previously registered subscription.
  1878. * Pending events that no longer match any subscription, because the
  1879. * saEvtEventUnsubscribe() operation had been invoked, are purged. a process
  1880. * that wishes to modify a subscription without losing any events must
  1881. * establish the new subscription before removing the existing subscription.
  1882. */
  1883. SaAisErrorT
  1884. saEvtEventUnsubscribe(
  1885. const SaEvtChannelHandleT channelHandle,
  1886. SaEvtSubscriptionIdT subscriptionId)
  1887. {
  1888. SaAisErrorT error;
  1889. struct event_instance *evti;
  1890. struct event_channel_instance *eci;
  1891. struct req_evt_event_unsubscribe req;
  1892. struct res_evt_event_unsubscribe res;
  1893. struct iovec iov;
  1894. error = saHandleInstanceGet(&channel_handle_db, channelHandle,
  1895. (void*)&eci);
  1896. if (error != SA_AIS_OK) {
  1897. goto unsubscribe_done;
  1898. }
  1899. error = saHandleInstanceGet(&evt_instance_handle_db,
  1900. eci->eci_instance_handle, (void*)&evti);
  1901. if (error != SA_AIS_OK) {
  1902. goto unsubscribe_put1;
  1903. }
  1904. req.icu_head.id = MESSAGE_REQ_EVT_UNSUBSCRIBE;
  1905. req.icu_head.size = sizeof(req);
  1906. req.icu_channel_handle = eci->eci_svr_channel_handle;
  1907. req.icu_sub_id = subscriptionId;
  1908. iov.iov_base = &req;
  1909. iov.iov_len = sizeof(req);
  1910. pthread_mutex_lock(&evti->ei_response_mutex);
  1911. error = saSendMsgReceiveReply(evti->ei_response_fd, &iov, 1,
  1912. &res, sizeof(res));
  1913. pthread_mutex_unlock (&evti->ei_response_mutex);
  1914. if (error != SA_AIS_OK) {
  1915. goto unsubscribe_put2;
  1916. }
  1917. if (res.icu_head.id != MESSAGE_RES_EVT_UNSUBSCRIBE) {
  1918. error = SA_AIS_ERR_LIBRARY;
  1919. goto unsubscribe_put2;
  1920. }
  1921. error = res.icu_head.error;
  1922. unsubscribe_put2:
  1923. saHandleInstancePut(&evt_instance_handle_db,
  1924. eci->eci_instance_handle);
  1925. unsubscribe_put1:
  1926. saHandleInstancePut(&channel_handle_db, channelHandle);
  1927. unsubscribe_done:
  1928. return error;
  1929. }
  1930. /*
  1931. * The saEvtEventRetentionTimeClear() function is used to clear the retention
  1932. * time of a published event. It indicates to the Event Service that it does
  1933. * not need to keep the event any longer for potential new subscribers. Once
  1934. * the value of the retention time is reset to 0, the event is no longer
  1935. * available for new subscribers. The event is held until all old subscribers
  1936. * in the system process the event and free the event using saEvtEventFree().
  1937. */
  1938. SaAisErrorT
  1939. saEvtEventRetentionTimeClear(
  1940. const SaEvtChannelHandleT channelHandle,
  1941. const SaEvtEventIdT eventId)
  1942. {
  1943. SaAisErrorT error;
  1944. struct event_instance *evti;
  1945. struct event_channel_instance *eci;
  1946. struct req_evt_event_clear_retentiontime req;
  1947. struct res_evt_event_clear_retentiontime res;
  1948. struct iovec iov;
  1949. if (!is_valid_event_id(eventId)) {
  1950. return SA_AIS_ERR_INVALID_PARAM;
  1951. }
  1952. error = saHandleInstanceGet(&channel_handle_db, channelHandle,
  1953. (void*)&eci);
  1954. if (error != SA_AIS_OK) {
  1955. goto ret_time_done;
  1956. }
  1957. error = saHandleInstanceGet(&evt_instance_handle_db,
  1958. eci->eci_instance_handle, (void*)&evti);
  1959. if (error != SA_AIS_OK) {
  1960. goto ret_time_put1;
  1961. }
  1962. req.iec_head.id = MESSAGE_REQ_EVT_CLEAR_RETENTIONTIME;
  1963. req.iec_head.size = sizeof(req);
  1964. req.iec_channel_handle = eci->eci_svr_channel_handle;
  1965. req.iec_event_id = eventId;
  1966. iov.iov_base = &req;
  1967. iov.iov_len = sizeof(req);
  1968. pthread_mutex_lock(&evti->ei_response_mutex);
  1969. error = saSendMsgReceiveReply(evti->ei_response_fd, &iov, 1,
  1970. &res, sizeof(res));
  1971. pthread_mutex_unlock (&evti->ei_response_mutex);
  1972. if (error != SA_AIS_OK) {
  1973. goto ret_time_put2;
  1974. }
  1975. if (res.iec_head.id != MESSAGE_RES_EVT_CLEAR_RETENTIONTIME) {
  1976. error = SA_AIS_ERR_LIBRARY;
  1977. goto ret_time_put2;
  1978. }
  1979. error = res.iec_head.error;
  1980. ret_time_put2:
  1981. saHandleInstancePut(&evt_instance_handle_db,
  1982. eci->eci_instance_handle);
  1983. ret_time_put1:
  1984. saHandleInstancePut(&channel_handle_db, channelHandle);
  1985. ret_time_done:
  1986. return error;
  1987. }
  1988. /*
  1989. * vi: set autoindent tabstop=4 shiftwidth=4 :
  1990. */