lib/ofp-errors.h

   1 /*
   2  * Copyright (c) 2008, 2009, 2010, 2011, 2012 Nicira, Inc.
   3  *
   4  * Licensed under the Apache License, Version 2.0 (the "License");
   5  * you may not use this file except in compliance with the License.
   6  * You may obtain a copy of the License at:
   7  *
   8  *     http://www.apache.org/licenses/LICENSE-2.0
   9  *
  10  * Unless required by applicable law or agreed to in writing, software
  11  * distributed under the License is distributed on an "AS IS" BASIS,
  12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13  * See the License for the specific language governing permissions and
  14  * limitations under the License.
  15  */
  16
  17 #ifndef OFP_ERRORS_H
  18 #define OFP_ERRORS_H 1
  19
  20 #include <stdbool.h>
  21 #include <stddef.h>
  22 #include <stdint.h>
  23
  24 struct ds;
  25 struct ofp_header;
  26
  27 /* Error codes.
  28  *
  29  * We embed system errno values and OpenFlow standard and vendor extension
  30  * error codes into the positive range of "int":
  31  *
  32  *   - Errno values are assumed to use the range 1 through 2**30 - 1.
  33  *
  34  *     (C and POSIX say that errno values are positive.  We assume that they
  35  *     are less than 2**29.  They are actually less than 65536 on at least
  36  *     Linux, FreeBSD, OpenBSD, and Windows.)
  37  *
  38  *   - OpenFlow standard and vendor extension error codes use the range
  39  *     starting at 2**30 (OFPERR_OFS).
  40  *
  41  * Zero and negative values are not used.
  42  */
  43
  44 #define OFPERR_OFS (1 << 30)
  45
  46 enum ofperr {
  47 /* Expected duplications. */
  48
  49     /* Expected: 3,5 in OF1.1 means both OFPBIC_BAD_EXPERIMENTER and
  50      * OFPBIC_BAD_EXP_TYPE. */
  51
  52 /* ## ------------------ ## */
  53 /* ## OFPET_HELLO_FAILED ## */
  54 /* ## ------------------ ## */
  55
  56     /* OF1.0+(0).  Hello protocol failed. */
  57     OFPERR_OFPET_HELLO_FAILED = OFPERR_OFS,
  58
  59     /* OF1.0+(0,0).  No compatible version. */
  60     OFPERR_OFPHFC_INCOMPATIBLE,
  61
  62     /* OF1.0+(0,1).  Permissions error. */
  63     OFPERR_OFPHFC_EPERM,
  64
  65 /* ## ----------------- ## */
  66 /* ## OFPET_BAD_REQUEST ## */
  67 /* ## ----------------- ## */
  68
  69     /* OF1.0+(1).  Request was not understood. */
  70     OFPERR_OFPET_BAD_REQUEST,
  71
  72     /* OF1.0+(1,0).  ofp_header.version not supported. */
  73     OFPERR_OFPBRC_BAD_VERSION,
  74
  75     /* OF1.0+(1,1).  ofp_header.type not supported. */
  76     OFPERR_OFPBRC_BAD_TYPE,
  77
  78     /* OF1.0+(1,2).  ofp_stats_msg.type not supported. */
  79     OFPERR_OFPBRC_BAD_STAT,
  80
  81     /* OF1.0+(1,3).  Vendor not supported (in ofp_vendor_header or
  82      * ofp_stats_msg). */
  83     OFPERR_OFPBRC_BAD_VENDOR,
  84
  85     /* OF1.0+(1,4).  Vendor subtype not supported. */
  86     OFPERR_OFPBRC_BAD_SUBTYPE,
  87
  88     /* OF1.0+(1,5).  Permissions error. */
  89     OFPERR_OFPBRC_EPERM,
  90
  91     /* OF1.0+(1,6).  Wrong request length for type. */
  92     OFPERR_OFPBRC_BAD_LEN,
  93
  94     /* OF1.0+(1,7).  Specified buffer has already been used. */
  95     OFPERR_OFPBRC_BUFFER_EMPTY,
  96
  97     /* OF1.0+(1,8).  Specified buffer does not exist. */
  98     OFPERR_OFPBRC_BUFFER_UNKNOWN,
  99
 100     /* OF1.1+(1,9).  Specified table-id invalid or does not exist. */
 101     OFPERR_OFPBRC_BAD_TABLE_ID,
 102
 103     /* OF1.2+(1,10).  Denied because controller is slave. */
 104     OFPERR_OFPBRC_IS_SLAVE,
 105
 106     /* OF1.2+(1,11).  Invalid port. */
 107     OFPERR_OFPBRC_BAD_PORT,
 108
 109     /* OF1.2+(1,12).  Invalid packet in packet-out. */
 110     OFPERR_OFPBRC_BAD_PACKET,
 111
 112     /* NX1.0+(1,256).  Invalid NXM flow match. */
 113     OFPERR_NXBRC_NXM_INVALID,
 114
 115     /* NX1.0+(1,257).  The nxm_type, or nxm_type taken in combination with
 116      * nxm_hasmask or nxm_length or both, is invalid or not implemented. */
 117     OFPERR_NXBRC_NXM_BAD_TYPE,
 118
 119     /* NX1.0+(1,512).  A request specified a nonexistent table ID. */
 120     OFPERR_NXBRC_BAD_TABLE_ID,
 121
 122     /* NX1.0+(1,514).  The in_port in an ofp_packet_out request is invalid. */
 123     OFPERR_NXBRC_BAD_IN_PORT,
 124
 125     /* NX1.0+(1,515).  Must-be-zero field had nonzero value. */
 126     OFPERR_NXBRC_MUST_BE_ZERO,
 127
 128     /* NX1.0+(1,516).  The reason in an ofp_port_status message is not
 129      * valid. */
 130     OFPERR_NXBRC_BAD_REASON,
 131
 132 /* ## ---------------- ## */
 133 /* ## OFPET_BAD_ACTION ## */
 134 /* ## ---------------- ## */
 135
 136     /* OF1.0+(2).  Error in action description. */
 137     OFPERR_OFPET_BAD_ACTION,
 138
 139     /* OF1.0+(2,0).  Unknown action type. */
 140     OFPERR_OFPBAC_BAD_TYPE,
 141
 142     /* OF1.0+(2,1).  Length problem in actions. */
 143     OFPERR_OFPBAC_BAD_LEN,
 144
 145     /* OF1.0+(2,2).  Unknown experimenter id specified. */
 146     OFPERR_OFPBAC_BAD_VENDOR,
 147
 148     /* OF1.0+(2,3).  Unknown action type for experimenter id. */
 149     OFPERR_OFPBAC_BAD_VENDOR_TYPE,
 150
 151     /* OF1.0+(2,4).  Problem validating output port. */
 152     OFPERR_OFPBAC_BAD_OUT_PORT,
 153
 154     /* OF1.0+(2,5).  Bad action argument. */
 155     OFPERR_OFPBAC_BAD_ARGUMENT,
 156
 157     /* OF1.0+(2,6).  Permissions error. */
 158     OFPERR_OFPBAC_EPERM,
 159
 160     /* OF1.0+(2,7).  Can't handle this many actions. */
 161     OFPERR_OFPBAC_TOO_MANY,
 162
 163     /* OF1.0+(2,8).  Problem validating output queue. */
 164     OFPERR_OFPBAC_BAD_QUEUE,
 165
 166     /* OF1.1+(2,9).  Invalid group id in forward action. */
 167     OFPERR_OFPBAC_BAD_OUT_GROUP,
 168
 169     /* OF1.1+(2,10).  Action can't apply for this match. */
 170     OFPERR_OFPBAC_MATCH_INCONSISTENT,
 171
 172     /* OF1.1+(2,11).  Action order is unsupported for the action list in an
 173      * Apply-Actions instruction */
 174     OFPERR_OFPBAC_UNSUPPORTED_ORDER,
 175
 176     /* OF1.1+(2,12).  Actions uses an unsupported tag/encap. */
 177     OFPERR_OFPBAC_BAD_TAG,
 178
 179     /* OF1.2+(2,13).  Unsupported type in SET_FIELD action. */
 180     OFPERR_OFPBAC_SET_TYPE,
 181
 182     /* OF1.2+(2,14).  Length problem in SET_FIELD action. */
 183     OFPERR_OFPBAC_SET_LEN,
 184
 185     /* OF1.2+(2,15).  Bad argument in SET_FIELD action. */
 186     OFPERR_OFPBAC_ARGUMENT,
 187
 188     /* NX1.0+(2,256).  Must-be-zero action argument had nonzero value. */
 189     OFPERR_NXBAC_MUST_BE_ZERO,
 190
 191 /* ## --------------------- ## */
 192 /* ## OFPET_BAD_INSTRUCTION ## */
 193 /* ## --------------------- ## */
 194
 195     /* OF1.1+(3).  Error in instruction list. */
 196     OFPERR_OFPET_BAD_INSTRUCTION,
 197
 198     /* OF1.1+(3,0).  Unknown instruction. */
 199     OFPERR_OFPBIC_UNKNOWN_INST,
 200
 201     /* OF1.1+(3,1).  Switch or table does not support the instruction. */
 202     OFPERR_OFPBIC_UNSUP_INST,
 203
 204     /* OF1.1+(3,2).  Invalid Table-ID specified. */
 205     OFPERR_OFPBIC_BAD_TABLE_ID,
 206
 207     /* OF1.1+(3,3).  Metadata value unsupported by datapath. */
 208     OFPERR_OFPBIC_UNSUP_METADATA,
 209
 210     /* OF1.1+(3,4).  Metadata mask value unsupported by datapath. */
 211     OFPERR_OFPBIC_UNSUP_METADATA_MASK,
 212
 213     /* OF1.1+(3,5).  Unknown experimenter id specified. */
 214     OFPERR_OFPBIC_BAD_EXPERIMENTER,
 215
 216     /* OF1.1(3,5), OF1.2+(3,6).  Unknown instruction for experimenter id. */
 217     OFPERR_OFPBIC_BAD_EXP_TYPE,
 218
 219     /* OF1.2+(3,7).  Length problem in instructions. */
 220     OFPERR_OFPBIC_BAD_LEN,
 221
 222     /* OF1.2+(3,8).  Permissions error. */
 223     OFPERR_OFPBIC_EPERM,
 224
 225 /* ## --------------- ## */
 226 /* ## OFPET_BAD_MATCH ## */
 227 /* ## --------------- ## */
 228
 229     /* OF1.1+(4).  Error in match. */
 230     OFPERR_OFPET_BAD_MATCH,
 231
 232     /* OF1.1+(4,0).  Unsupported match type specified by the match */
 233     OFPERR_OFPBMC_BAD_TYPE,
 234
 235     /* OF1.1+(4,1).  Length problem in match. */
 236     OFPERR_OFPBMC_BAD_LEN,
 237
 238     /* OF1.1+(4,2).  Match uses an unsupported tag/encap. */
 239     OFPERR_OFPBMC_BAD_TAG,
 240
 241     /* OF1.1+(4,3).  Unsupported datalink addr mask - switch does not support
 242      * arbitrary datalink address mask. */
 243     OFPERR_OFPBMC_BAD_DL_ADDR_MASK,
 244
 245     /* OF1.1+(4,4).  Unsupported network addr mask - switch does not support
 246      * arbitrary network address mask. */
 247     OFPERR_OFPBMC_BAD_NW_ADDR_MASK,
 248
 249     /* OF1.1+(4,5).  Unsupported wildcard specified in the match. */
 250     OFPERR_OFPBMC_BAD_WILDCARDS,
 251
 252     /* OF1.1+(4,6).  Unsupported field in the match. */
 253     OFPERR_OFPBMC_BAD_FIELD,
 254
 255     /* NX1.0(1,258), NX1.1(1,258), OF1.2+(4,7).  Unsupported value in a match
 256      * field. */
 257     OFPERR_OFPBMC_BAD_VALUE,
 258
 259     /* NX1.0(1,259), NX1.1(1,259), OF1.2+(4,8).  Unsupported mask specified in
 260      * the match, field is not dl-address or nw-address. */
 261     OFPERR_OFPBMC_BAD_MASK,
 262
 263     /* NX1.0(1,260), NX1.1(1,260), OF1.2+(4,9).  A prerequisite was not met. */
 264     OFPERR_OFPBMC_BAD_PREREQ,
 265
 266     /* NX1.0(1,261), NX1.1(1,261), OF1.2+(4,10).  A field type was
 267      * duplicated. */
 268     OFPERR_OFPBMC_DUP_FIELD,
 269
 270     /* OF1.2+(4,11).  Permissions error. */
 271     OFPERR_OFPBMC_EPERM,
 272
 273 /* ## --------------------- ## */
 274 /* ## OFPET_FLOW_MOD_FAILED ## */
 275 /* ## --------------------- ## */
 276
 277     /* OF1.0(3), OF1.1+(5).  Problem modifying flow entry. */
 278     OFPERR_OFPET_FLOW_MOD_FAILED,
 279
 280     /* OF1.1+(5,0).  Unspecified error. */
 281     OFPERR_OFPFMFC_UNKNOWN,
 282
 283     /* OF1.0(3,0).  Flow not added because of full tables. */
 284     OFPERR_OFPFMFC_ALL_TABLES_FULL,
 285
 286     /* OF1.1+(5,1).  Flow not added because table was full. */
 287     OFPERR_OFPFMFC_TABLE_FULL,
 288
 289     /* OF1.1+(5,2).  Table does not exist */
 290     OFPERR_OFPFMFC_BAD_TABLE_ID,
 291
 292     /* OF1.0(3,1), OF1.1+(5,3).  Attempted to add overlapping flow with
 293      * CHECK_OVERLAP flag set. */
 294     OFPERR_OFPFMFC_OVERLAP,
 295
 296     /* OF1.0(3,2), OF1.1+(5,4).  Permissions error. */
 297     OFPERR_OFPFMFC_EPERM,
 298
 299     /* OF1.1+(5,5).  Flow not added because of unsupported idle/hard
 300      * timeout. */
 301     OFPERR_OFPFMFC_BAD_TIMEOUT,
 302
 303     /* OF1.0(3,3).  Flow not added because of non-zero idle/hard timeout. */
 304     OFPERR_OFPFMFC_BAD_EMERG_TIMEOUT,
 305
 306     /* OF1.0(3,4), OF1.1+(5,6).  Unsupported or unknown command. */
 307     OFPERR_OFPFMFC_BAD_COMMAND,
 308
 309     /* OF1.2+(5,7).  Unsupported or unknown flags. */
 310     OFPERR_OFPFMFC_BAD_FLAGS,
 311
 312     /* OF1.0(3,5).  Unsupported action list - cannot process in the order
 313      * specified. */
 314     OFPERR_OFPFMFC_UNSUPPORTED,
 315
 316     /* NX1.0(3,256), NX1.1(5,256).  Generic hardware error. */
 317     OFPERR_NXFMFC_HARDWARE,
 318
 319     /* NX1.0(3,257), NX1.1(5,257).  A nonexistent table ID was specified in the
 320      * "command" field of struct ofp_flow_mod, when the nxt_flow_mod_table_id
 321      * extension is enabled. */
 322     OFPERR_NXFMFC_BAD_TABLE_ID,
 323
 324 /* ## ---------------------- ## */
 325 /* ## OFPET_GROUP_MOD_FAILED ## */
 326 /* ## ---------------------- ## */
 327
 328     /* OF1.1+(6).  Problem modifying group entry. */
 329     OFPERR_OFPET_GROUP_MOD_FAILED,
 330
 331     /* OF1.1+(6,0).  Group not added because a group ADD attempted to replace
 332      * an already-present group. */
 333     OFPERR_OFPGMFC_GROUP_EXISTS,
 334
 335     /* OF1.1+(6,1).  Group not added because Group specified is invalid. */
 336     OFPERR_OFPGMFC_INVALID_GROUP,
 337
 338     /* OF1.1+(6,2).  Switch does not support unequal load sharing with select
 339      * groups. */
 340     OFPERR_OFPGMFC_WEIGHT_UNSUPPORTED,
 341
 342     /* OF1.1+(6,3).  The group table is full. */
 343     OFPERR_OFPGMFC_OUT_OF_GROUPS,
 344
 345     /* OF1.1+(6,4).  The maximum number of action buckets for a group has been
 346      * exceeded. */
 347     OFPERR_OFPGMFC_OUT_OF_BUCKETS,
 348
 349     /* OF1.1+(6,5).  Switch does not support groups that forward to groups. */
 350     OFPERR_OFPGMFC_CHAINING_UNSUPPORTED,
 351
 352     /* OF1.1+(6,6).  This group cannot watch the watch_port or watch_group
 353      * specified. */
 354     OFPERR_OFPGMFC_WATCH_UNSUPPORTED,
 355
 356     /* OF1.1+(6,7).  Group entry would cause a loop. */
 357     OFPERR_OFPGMFC_LOOP,
 358
 359     /* OF1.1+(6,8).  Group not modified because a group MODIFY attempted to
 360      * modify a non-existent group. */
 361     OFPERR_OFPGMFC_UNKNOWN_GROUP,
 362
 363     /* OF1.2+(6,9).  Group not deleted because another
 364                     group is forwarding to it. */
 365     OFPERR_OFPGMFC_CHAINED_GROUP,
 366
 367     /* OF1.2+(6,10).  Unsupported or unknown group type. */
 368     OFPERR_OFPGMFC_BAD_TYPE,
 369
 370     /* OF1.2+(6,11).  Unsupported or unknown command. */
 371     OFPERR_OFPGMFC_BAD_COMMAND,
 372
 373     /* OF1.2+(6,12).  Error in bucket. */
 374     OFPERR_OFPGMFC_OFPGMFC_BAD_BUCKET,
 375
 376     /* OF1.2+(6,13).  Error in watch port/group. */
 377     OFPERR_OFPGMFC_OFPGMFC_BAD_WATCH,
 378
 379     /* OF1.2+(6,14).  Permissions error. */
 380     OFPERR_OFPGMFC_OFPGMFC_EPERM,
 381
 382 /* ## --------------------- ## */
 383 /* ## OFPET_PORT_MOD_FAILED ## */
 384 /* ## --------------------- ## */
 385
 386     /* OF1.0(4), OF1.1+(7).  OFPT_PORT_MOD failed. */
 387     OFPERR_OFPET_PORT_MOD_FAILED,
 388
 389     /* OF1.0(4,0), OF1.1+(7,0).  Specified port does not exist. */
 390     OFPERR_OFPPMFC_BAD_PORT,
 391
 392     /* OF1.0(4,1), OF1.1+(7,1).  Specified hardware address does not match the
 393      * port number. */
 394     OFPERR_OFPPMFC_BAD_HW_ADDR,
 395
 396     /* OF1.1+(7,2).  Specified config is invalid. */
 397     OFPERR_OFPPMFC_BAD_CONFIG,
 398
 399     /* OF1.1+(7,3).  Specified advertise is invalid. */
 400     OFPERR_OFPPMFC_BAD_ADVERTISE,
 401
 402     /* OF1.2+(7,4).  Permissions error. */
 403     OFPERR_OFPPMFC_EPERM,
 404
 405 /* ## ---------------------- ## */
 406 /* ## OFPET_TABLE_MOD_FAILED ## */
 407 /* ## ---------------------- ## */
 408
 409     /* OF1.1+(8).  Table mod request failed. */
 410     OFPERR_OFPET_TABLE_MOD_FAILED,
 411
 412     /* OF1.1+(8,0).  Specified table does not exist. */
 413     OFPERR_OFPTMFC_BAD_TABLE,
 414
 415     /* OF1.1+(8,1).  Specified config is invalid. */
 416     OFPERR_OFPTMFC_BAD_CONFIG,
 417
 418     /* OF1.2+(8,2).  Permissions error. */
 419     OFPERR_OFPTMFC_EPERM,
 420
 421 /* ## --------------------- ## */
 422 /* ## OFPET_QUEUE_OP_FAILED ## */
 423 /* ## --------------------- ## */
 424
 425     /* OF1.0(5), OF1.1+(9).  Queue operation failed. */
 426     OFPERR_OFPET_QUEUE_OP_FAILED,
 427
 428     /* OF1.0(5,0), OF1.1+(9,0).  Invalid port (or port does not exist). */
 429     OFPERR_OFPQOFC_BAD_PORT,
 430
 431     /* OF1.0(5,1), OF1.1+(9,1).  Queue does not exist. */
 432     OFPERR_OFPQOFC_BAD_QUEUE,
 433
 434     /* OF1.0(5,2), OF1.1+(9,2).  Permissions error. */
 435     OFPERR_OFPQOFC_EPERM,
 436
 437 /* ## -------------------------- ## */
 438 /* ## OFPET_SWITCH_CONFIG_FAILED ## */
 439 /* ## -------------------------- ## */
 440
 441     /* OF1.1+(10).  Switch config request failed. */
 442     OFPERR_OFPET_SWITCH_CONFIG_FAILED,
 443
 444     /* OF1.1+(10,0).  Specified flags is invalid. */
 445     OFPERR_OFPSCFC_BAD_FLAGS,
 446
 447     /* OF1.1+(10,1).  Specified len is invalid. */
 448     OFPERR_OFPSCFC_BAD_LEN,
 449
 450     /* OF1.2+(10,2).  Permissions error. */
 451     OFPERR_OFPSCFC_EPERM,
 452
 453 /* ## ------------------------- ## */
 454 /* ## OFPET_ROLE_REQUEST_FAILED ## */
 455 /* ## ------------------------- ## */
 456
 457     /* OF1.2+(11).  Controller Role request failed. */
 458     OFPERR_OFPET_ROLE_REQUEST_FAILED,
 459
 460     /* OF1.2+(11,0).  Stale Message: old generation_id. */
 461     OFPERR_OFPRRFC_STALE,
 462
 463     /* OF1.2+(11,1).  Controller role change unsupported. */
 464     OFPERR_OFPRRFC_UNSUP,
 465
 466     /* NX1.0(1,513), NX1.1(1,513), OF1.2+(11,2).  Invalid role. */
 467     OFPERR_OFPRRFC_BAD_ROLE,
 468
 469
 470 /* ## ------------------ ## */
 471 /* ## OFPET_EXPERIMENTER ## */
 472 /* ## ------------------ ## */
 473
 474     /* OF1.2+(0xffff).  Experimenter error messages. */
 475     OFPERR_OFPET_EXPERIMENTER,
 476 };
 477
 478 extern const struct ofperr_domain ofperr_of10;
 479 extern const struct ofperr_domain ofperr_of11;
 480 extern const struct ofperr_domain ofperr_of12;
 481
 482 const struct ofperr_domain *ofperr_domain_from_version(uint8_t version);
 483 const char *ofperr_domain_get_name(const struct ofperr_domain *);
 484
 485 bool ofperr_is_valid(enum ofperr);
 486 bool ofperr_is_category(enum ofperr);
 487 bool ofperr_is_nx_extension(enum ofperr);
 488 bool ofperr_is_encodable(enum ofperr, const struct ofperr_domain *);
 489
 490 enum ofperr ofperr_decode(const struct ofperr_domain *,
 491                           uint16_t type, uint16_t code);
 492 enum ofperr ofperr_decode_type(const struct ofperr_domain *, uint16_t type);
 493 enum ofperr ofperr_from_name(const char *);
 494
 495 enum ofperr ofperr_decode_msg(const struct ofp_header *, size_t *payload_ofs);
 496 struct ofpbuf *ofperr_encode_reply(enum ofperr, const struct ofp_header *);
 497 struct ofpbuf *ofperr_encode_hello(enum ofperr, const struct ofperr_domain *,
 498                                    const char *);
 499 int ofperr_get_type(enum ofperr, const struct ofperr_domain *);
 500 int ofperr_get_code(enum ofperr, const struct ofperr_domain *);
 501
 502 const char *ofperr_get_name(enum ofperr);
 503 const char *ofperr_get_description(enum ofperr);
 504
 505 void ofperr_format(struct ds *, enum ofperr);
 506 const char *ofperr_to_string(enum ofperr);
 507
 508 #endif /* ofp-errors.h */