HP 800 HP DLPI Programmer's Guide - Page 112

DL_HP_RAWDATA_IND, Reasons for Failure, Fine-grained Privileges, Format

Page 112 highlights

DLPI Primitives Raw Mode Service Primitives If the DLS provider accepts the data for transmission, there is no response. This does not, however, guarantee that the data will be delivered to the destination DLS user, since the connectionless data transfer is not a confirmed service. If the request is erroneous, a DL_ERROR_ACK is returned, and the resulting state is unchanged. Reasons for Failure DL_BADPRIM Request was issued from a state in which the DL_HP_RAWDATA_REQ was not recognized. DL_SYSERR A system error has occurred and the UNIX system error is indicated in the DL_ERROR_ACK. The UNIX error returned may be set to (not limited to) errors listed in Table 2-2 on page 71. Fine-grained Privileges Starting HP-UX 11i v3, HP DLPI will allow transmission of IP/ARP frame only for users with PRIV_NETRAWACCESS privilege. For more information on the fine-grained privileges, see "Fine-grained Privileges" on page 17. DL_HP_RAWDATA_IND Conveys one completely formatted DLSDU from the DLS provider to the DLS user. The DLSDU contains the complete Link and MAC Level headers. Format The message consists of one M_PROTO message block containing the structure shown below, followed by one or more M_DATA message blocks containing at least one byte of data. The amount of user data that may be transferred in a single DLSDU is limited. This limit is conveyed by the parameter dl_max_sdu in the DL_INFO_ACK primitive. typedef struct { ulong dl_primitive; } dl_hp_rawdata_ind_t; 112 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
Raw Mode Service Primitives
Chapter 2
112
If the DLS provider accepts the data for transmission, there is no
response. This does not, however, guarantee that the data will be
delivered to the destination DLS user, since the connectionless data
transfer is not a confirmed service.
If the request is erroneous, a DL_ERROR_ACK is returned, and the
resulting state is unchanged.
Reasons for Failure
DL_BADPRIM
Request was issued from a state in which the
DL_HP_RAWDATA_REQ was not recognized.
DL_SYSERR
A system error has occurred and the UNIX system error is indicated
in the DL_ERROR_ACK.
The UNIX error returned may be set to (not limited to) errors listed
in Table 2-2 on page 71.
Fine-grained Privileges
Starting HP-UX 11i v3, HP DLPI will allow transmission of IP/ARP
frame only for users with PRIV_NETRAWACCESS privilege.
For more information on the fine-grained privileges, see
Fine-grained
Privileges
on page 17.
DL_HP_RAWDATA_IND
Conveys one completely formatted DLSDU from the DLS provider to the
DLS user. The DLSDU contains the complete Link and MAC Level
headers.
Format
The message consists of one M_PROTO message block containing the
structure shown below, followed by one or more M_DATA message blocks
containing at least one byte of data. The amount of user data that may be
transferred in a single DLSDU is limited. This limit is conveyed by the
parameter dl_max_sdu in the DL_INFO_ACK primitive.
typedef
struct
{
ulong
dl_primitive;
} dl_hp_rawdata_ind_t;