HP 800 HP DLPI Programmer's Guide - Page 97

New State, Response, Reasons for Failure, Security Containment

Page 97 highlights

DLPI Primitives Local Management Primitives The message is valid in any attached state in which a local acknowledgement is not pending. For a style 2 provider, this would be after a PPA is attached using the DL_ATTACH_REQ. For a style 1 provider, the PPA is implicitly attached after the stream is opened. New State The resulting state is unchanged. Response The provider responds to the request with a DL_OK_ACK on successful completion. Otherwise, a DL_ERROR_ACK is returned. Reasons for Failure DL_BADADDR The address information was invalid or was in an incorrect format. DL_NOTSUPPORTED The primitive is known, but not supported by the DLS provider. DL_SYSERR A system error has occurred. The UNIX error returned may be set to (not limited to) errors listed in Table 2-2 on page 71. DL_OUTSTATE The primitive was issued from an invalid state. DL_BUSY One or more streams for that particular PPA are in the DL_BOUND state. Security Containment With the Security Containment product version B.11.23.01 or later, HP DLPI will allow network related administrative tasks such as setting the physical address of an interface only for users with PRIV_NETADMIN privilege. See "Fine-grained Privileges with Security Containment Release" on page 17 for more details. Chapter 2 97

  • 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

DLPI Primitives
Local Management Primitives
Chapter 2
97
The message is valid in any attached state in which a local
acknowledgement is not pending. For a style 2 provider, this would be
after a PPA is attached using the DL_ATTACH_REQ. For a style 1
provider, the PPA is implicitly attached after the stream is opened.
New State
The resulting state is unchanged.
Response
The provider responds to the request with a DL_OK_ACK on successful
completion. Otherwise, a DL_ERROR_ACK is returned.
Reasons for Failure
DL_BADADDR
The address information was invalid or was in an incorrect format.
DL_NOTSUPPORTED
The primitive is known, but not supported by the DLS provider.
DL_SYSERR
A system error has occurred.
The UNIX error returned may be set to (not limited to) errors listed
in Table 2-2 on page 71.
DL_OUTSTATE
The primitive was issued from an invalid state.
DL_BUSY
One or more streams for that particular PPA are in the DL_BOUND
state.
Security Containment
With the Security Containment product version B.11.23.01 or later, HP
DLPI will allow network related administrative tasks such as setting the
physical address of an interface only for users with PRIV_NETADMIN
privilege.
See “Fine-grained Privileges with Security Containment Release” on
page 17 for more details.