1UMAD_REGISTER2(3) OpenIB Programmer´s Manual UMAD_REGISTER2(3)
2
3
4
6 umad_register2 - register the specified management class and version
7 for port
8
10 #include <infiniband/umad.h>
11
12 int umad_register2(int port_fd, struct umad_reg_attr *attr, uint32_t *agent_id);
13
15 umad_register2() registers for a MAD agent using the provided registra‐
16 tion attributes
17
18 port_fd the port on which to register the agent
19
20 attr The registration attributes as defined by the structure passed.
21 See below for details of this structure.
22
23 agent_id returned on success. agent_id identifies the kernel MAD agent
24 a MAD is received by or to be sent by. agent_id is returned in the
25 umad header "struct ib_user_mad" on recv and specified in umad_send
26 when sending.
27
28
29
31 struct umad_reg_attr {
32 uint8_t mgmt_class;
33 uint8_t mgmt_class_version;
34 uint32_t flags;
35 uint64_t method_mask[2];
36 uint32_t oui;
37 uint8_t rmpp_version;
38 };
39
40 mgmt_class
41 Management class to register for.
42
43 mgmt_class_version
44 Management class version to register for.
45
46 flags
47 Registration flags. If a flag specified is not supported by the kernel,
48 an error is returned, and the supported flags are returned in this field.
49
50
51 Current flags are:
52 UMAD_USER_RMPP -- flag to indicate the kernel should not process
53 RMPP packets. All RMPP packets will be treated like individual
54 MADs. The user is responsible for implementing the RMPP
55 protocol.
56
57 method_mask
58 A bit mask which indicates which unsolicited methods this agent should
59 receive. Setting this array to 0 will result in the agent only
60 receiving response MADs for which a request was sent.
61
62 oui
63 The oui (in host order) to use for vendor classes 0x30 - 0x4f.
64 Otherwise ignored.
65
66 rmpp_version
67 If the class supports RMPP and kernel RMPP is enabled (the default)
68 indicate which rmpp_version to use.
69
70
71
73 umad_register2() returns 0 on success and +ERRNO on failure.
74
75
77 umad_unregister(3)
78
80 Ira Weiny <ira.weiny@intel.com>
81
82
83
84OpenIB March 25, 2014 UMAD_REGISTER2(3)