1UMAD_REGISTER2(3)         OpenIB Programmer´s Manual         UMAD_REGISTER2(3)
2
3
4

NAME

6       umad_register2  -  register  the specified management class and version
7       for port
8

SYNOPSIS

10       #include <infiniband/umad.h>
11
12       int umad_register2(int port_fd, struct umad_reg_attr *attr, uint32_t *agent_id);
13

DESCRIPTION

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

REGISTRATION ATTRIBUTE STRUCTURE

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

RETURN VALUE

73       umad_register2() returns 0 on success and +ERRNO on failure.
74
75

SEE ALSO

77       umad_unregister(3)
78

AUTHOR

80       Ira Weiny <ira.weiny@intel.com>
81
82
83
84OpenIB                          March 25, 2014               UMAD_REGISTER2(3)
Impressum