HP 800 HP DLPI Programmer's Guide - Page 90

DL_HP_RESET_STATS_REQ, Fine-grained Privileges, Format - paper

Page 90 highlights

DLPI Primitives Local Management Primitives DL_SYSERR A system error has occurred, because the driver returned an error. The driver error is present in the dl_unix_errno element of the dl_error_ack_t structure. The UNIX error returned may be set to (not limited to) errors listed in Table 2-2 on page 71. The possible errors can be (but not limited to) ENOBUFS and EBUSY. Fine-grained Privileges Starting HP-UX 11i v3, HP DLPI allows network related administrative tasks such as resetting the interface only for users with PRIV_NETADMIN privilege. For more information on the fine-grained privileges, see "Fine-grained Privileges" on page 17. NOTE The HP Auto Port Aggregation (HP APA) product allows grouping of networking links to form a single high bandwidth, highly available and scalable networking link, called an aggregate interface. HP APA also allows formation of a failover group of networking links connected across switches for an highly available link configuration on the server. For information on HP APA performance and scalability, see http://docs.hp.com/en/7662/new-apa-white-paper.pdf. HP APA exposes logical PPAs (Physical Points of Attachment) corresponding to the aggregate or failover group. PPA is a unique integer identifier for each network physical port installed on the server. In HP-UX 11i v3, the APA PPA values are in the range 900 - 949. APA PPA does not support the DL_HP_HW_RESET_REQ primitive. The EOPNOTSUPP Unix error is returned when the DL_HP_HW_RESET_REQ primitive is sent down the APA PPA. DL_HP_RESET_STATS_REQ DL_HP_RESET_STATS_REQ resets the interface (physical or logical). Format The message consists of one M_PROTO message block, which contains the following structure: 90 Chapter 2

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86
  • 87
  • 88
  • 89
  • 90
  • 91
  • 92
  • 93
  • 94
  • 95
  • 96
  • 97
  • 98
  • 99
  • 100
  • 101
  • 102
  • 103
  • 104
  • 105
  • 106
  • 107
  • 108
  • 109
  • 110
  • 111
  • 112
  • 113
  • 114
  • 115
  • 116
  • 117
  • 118
  • 119
  • 120
  • 121
  • 122
  • 123
  • 124
  • 125
  • 126
  • 127
  • 128
  • 129
  • 130
  • 131
  • 132
  • 133
  • 134
  • 135
  • 136
  • 137
  • 138
  • 139
  • 140
  • 141
  • 142
  • 143
  • 144
  • 145
  • 146
  • 147
  • 148
  • 149
  • 150
  • 151
  • 152
  • 153
  • 154
  • 155
  • 156
  • 157
  • 158
  • 159
  • 160
  • 161
  • 162
  • 163
  • 164
  • 165
  • 166
  • 167
  • 168
  • 169
  • 170
  • 171
  • 172
  • 173
  • 174
  • 175
  • 176
  • 177
  • 178
  • 179
  • 180
  • 181
  • 182
  • 183
  • 184
  • 185
  • 186
  • 187
  • 188
  • 189
  • 190
  • 191
  • 192
  • 193
  • 194
  • 195
  • 196
  • 197
  • 198
  • 199
  • 200
  • 201
  • 202
  • 203
  • 204
  • 205
  • 206
  • 207
  • 208
  • 209
  • 210
  • 211
  • 212
  • 213
  • 214
  • 215
  • 216
  • 217
  • 218
  • 219
  • 220
  • 221
  • 222
  • 223
  • 224
  • 225
  • 226

DLPI Primitives
Local Management Primitives
Chapter 2
90
DL_SYSERR
A system error has occurred, because the driver returned an error.
The driver error is present in the dl_unix_errno element of the
dl_error_ack_t structure.
The UNIX error returned may be set to (not limited to) errors listed
in Table 2-2 on page 71. The possible errors can be (but not limited
to) ENOBUFS and EBUSY.
Fine-grained Privileges
Starting HP-UX 11i v3, HP DLPI allows network related administrative
tasks such as resetting the interface only for users with
PRIV_NETADMIN privilege.
For more information on the fine-grained privileges, see
Fine-grained
Privileges
on page 17.
NOTE
The HP Auto
Port
Aggregation
(HP APA)
product
allows
grouping
of
networking
links to form a single high bandwidth,
highly available and
scalable
networking
link, called an aggregate
interface.
HP APA also
allows
formation
of a failover
group of
networking
links
connected
across
switches
for an
highly
available
link
configuration
on the
server. For information on HP APA performance and scalability, see
.
HP APA exposes logical PPAs (Physical Points of Attachment)
corresponding to the aggregate or failover group. PPA is a unique integer
identifier for each network physical port installed on the server. In
HP-UX 11i v3, the APA PPA values are in the range 900 - 949. APA PPA
does not support the DL_HP_HW_RESET_REQ primitive. The
EOPNOTSUPP Unix error is returned when the
DL_HP_HW_RESET_REQ primitive is sent down the APA PPA.
DL_HP_RESET_STATS_REQ
DL_HP_RESET_STATS_REQ resets the interface (physical or logical).
Format
The message consists of one M_PROTO message block, which contains
the following structure: