1CMAP_INITIALIZE_MAPC(o3r)osync Cluster Engine Programmer's MaCnMuAaPl_INITIALIZE_MAP(3)
2
3
4
6 cmap_initialize_map - Initialize CMAP API with a specific map
7
8
10 #include <corosync/cmap.h>
11
12
13 cs_error_t cmap_initialize_map (cmap_handle_t *handle, cmap_map_t map);
14
15
17 The cmap_initialize_map function is used to initialize a connection to
18 the Configuration Map API and specify a particular map to use. Each
19 application may have several connections to the CMAP API and to differ‐
20 ent maps. Each application uses the handle argument to uniquely iden‐
21 tify the connection. The handle argument is then used in other func‐
22 tion calls to identify the connection to be used for communication with
23 the CMAP service.
24
25 The map argument specifies which map to connect to. CMAP_MAP_ICMAP is
26 the configuration map that contains the current corosyn cconfiguraton
27 and some runtime variables that maybe useful to external agents.
28 CMAP_MAP_STATS is the statistics map that contains detailed information
29 about network and inter-process communications.
30
31
32
34 This call returns the CS_OK value if successful, otherwise an error is
35 returned.
36
37
39 cmap_initialize(3), cmap_finalize(3), cmap_overview(8)
40
41 CS_ERR_TRY_AGAIN Resource temporarily unavailable
42
43 CS_ERR_INVALID_PARAM Invalid argument
44
45 CS_ERR_ACCESS Permission denied
46
47 CS_ERR_LIBRARY The connection failed
48
49 CS_ERR_INTERRUPT System call interrupted by a signal
50
51 CS_ERR_NOT_SUPPORTED The requested protocol/functionality not supported
52
53 CS_ERR_MESSAGE_ERROR Incorrect auth message received
54
55 CS_ERR_NO_MEMORY Not enough memory to complete the requested task
56
57
58
59corosync Man Page 20/07/2017 CMAP_INITIALIZE_MAP(3)