X-Git-Url: http://git.cascardo.eti.br/?a=blobdiff_plain;f=lib%2Fofp-errors.h;h=d40ca381bb3976b4dbf607990614e8891e368e04;hb=HEAD;hp=563c75af083a6ca38aa902e68b670abcce0bd410;hpb=04f9f28622b4d4abb59304da0ef4286405757776;p=cascardo%2Fovs.git diff --git a/lib/ofp-errors.h b/lib/ofp-errors.h index 563c75af0..d40ca381b 100644 --- a/lib/ofp-errors.h +++ b/lib/ofp-errors.h @@ -1,5 +1,5 @@ /* - * Copyright (c) 2008, 2009, 2010, 2011, 2012, 2013, 2014 Nicira, Inc. + * Copyright (c) 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Nicira, Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -45,7 +45,8 @@ struct ofpbuf; #define OFPERR_OFS (1 << 30) -/* OpenFlow error codes. +/* OpenFlow error codes + * -------------------- * * The comments below are parsed by the extract-ofp-errors program at build * time and used to determine the mapping between "enum ofperr" constants and @@ -71,13 +72,46 @@ struct ofpbuf; * - Additional text is a human-readable description of the meaning of each * error, used to explain the error to the user. Any text enclosed in * square brackets is omitted; this can be used to explain rationale for - * choice of error codes in the case where this is desirable. */ + * choice of error codes in the case where this is desirable. + * + * + * Expected duplications + * --------------------- + * + * Occasionally, in one version of OpenFlow a single named error can indicate + * two or more distinct errors, then a later version of OpenFlow splits those + * meanings into different error codes. When that happens, both errors are + * assigned the same value in the earlier version. That is ordinarily a + * mistake, so the build system reports an error. When that happens, add the + * error message to the list of "Expected duplications" below to suppress the + * error. In such a case, the named error defined earlier is how OVS + * interprets the earlier, merged form of the error. + * + * For example, OpenFlow 1.1 defined (3,5) as OFPBIC_UNSUP_EXP_INST, then + * OpenFlow 1.2 broke this error into OFPBIC_BAD_EXPERIMENTER as (3,5) and + * OFPBIC_BAD_EXT_TYPE as (3,6). To allow the OVS code to report just a single + * error code, instead of protocol version dependent errors, this list of + * errors only lists the latter two errors, giving both of them the same code + * (3,5) for OpenFlow 1.1. Then, when OVS serializes either error into + * OpenFlow 1.1, it uses the same code (3,5). In the other direction, when OVS + * deserializes (3,5) from OpenFlow 1.1, it translates it into + * OFPBIC_BAD_EXPERIMENTER (because its definition precedes that of + * OFPBIC_BAD_EXT_TYPE below). See the "encoding OFPBIC_* experimenter errors" + * and "decoding OFPBIC_* experimenter errors" tests in tests/ofp-errors.at for + * full details. + */ enum ofperr { /* Expected duplications. */ /* Expected: 0x0,3,5 in OF1.1 means both OFPBIC_BAD_EXPERIMENTER and * OFPBIC_BAD_EXP_TYPE. */ + /* Expected: 0x0,1,5 in OF1.0 means both OFPBRC_EPERM and + * OFPBRC_IS_SLAVE. */ + + /* Expected: 0x0,1,5 in OF1.1 means both OFPBRC_EPERM and + * OFPBRC_IS_SLAVE. */ + /* ## ------------------ ## */ /* ## OFPET_HELLO_FAILED ## */ /* ## ------------------ ## */ @@ -126,7 +160,7 @@ enum ofperr { * code defined the specification. ] */ OFPERR_OFPBRC_BAD_TABLE_ID, - /* OF1.2+(1,10). Denied because controller is slave. */ + /* OF1.0-1.1(1,5), OF1.2+(1,10). Denied because controller is slave. */ OFPERR_OFPBRC_IS_SLAVE, /* NX1.0-1.1(1,514), OF1.2+(1,11). Invalid port. [ A non-standard error @@ -222,10 +256,19 @@ enum ofperr { * unsupported value, or modifies a read-only field. */ OFPERR_OFPBAC_BAD_SET_ARGUMENT, + /* ONF1.3-1.4(4250), OF1.5+(2,16). Field in Set-Field action has Has-Mask + * bit set to 1. */ + OFPERR_OFPBAC_BAD_SET_MASK, + /* NX1.0-1.1(2,256), NX1.2+(11). Must-be-zero action argument had nonzero * value. */ OFPERR_NXBAC_MUST_BE_ZERO, + /* NX1.0-1.1(2,526), NX1.2+(15). Conjunction action must be only action + * present. conjunction(id, k/n) must satisfy 1 <= k <= n and 2 <= n <= + * 64. */ + OFPERR_NXBAC_BAD_CONJUNCTION, + /* ## --------------------- ## */ /* ## OFPET_BAD_INSTRUCTION ## */ /* ## --------------------- ## */ @@ -233,7 +276,8 @@ enum ofperr { /* OF1.1+(3,0). Unknown instruction. */ OFPERR_OFPBIC_UNKNOWN_INST, - /* OF1.1+(3,1). Switch or table does not support the instruction. */ + /* NX1.0(2,257), OF1.1+(3,1). Switch or table does not support the + * instruction. */ OFPERR_OFPBIC_UNSUP_INST, /* OF1.1+(3,2). Invalid Table-ID specified. */ @@ -257,7 +301,7 @@ enum ofperr { /* OF1.2+(3,8). Permissions error. */ OFPERR_OFPBIC_EPERM, - /* ONF1.1-1.3(2600), OF1.4+(3,9). Duplicate instruction. */ + /* NX1.1(3,256), ONF1.2-1.3(2600), OF1.4+(3,9). Duplicate instruction. */ OFPERR_OFPBIC_DUP_INST, /* ## --------------- ## */ @@ -281,10 +325,11 @@ enum ofperr { * arbitrary network address mask. */ OFPERR_OFPBMC_BAD_NW_ADDR_MASK, - /* OF1.1+(4,5). Unsupported wildcard specified in the match. */ + /* NX1.0(1,262), OF1.1+(4,5). Unsupported wildcard specified in the + * match. */ OFPERR_OFPBMC_BAD_WILDCARDS, - /* OF1.1+(4,6). Unsupported field in the match. */ + /* NX1.0(0,263), OF1.1+(4,6). Unsupported field in the match. */ OFPERR_OFPBMC_BAD_FIELD, /* NX1.0(1,258), OF1.1+(4,7). Unsupported value in a match @@ -405,6 +450,14 @@ enum ofperr { /* OF1.2+(6,14). Permissions error. */ OFPERR_OFPGMFC_EPERM, + /* OF1.5+(6,15). Invalid bucket identifier used in + * INSERT BUCKET or REMOVE BUCKET command. */ + OFPERR_OFPGMFC_UNKNOWN_BUCKET, + + /* OF1.5+(6,16). Can't insert bucket because a bucket + * already exist with that bucket-id. */ + OFPERR_OFPGMFC_BUCKET_EXISTS, + /* ## --------------------- ## */ /* ## OFPET_PORT_MOD_FAILED ## */ /* ## --------------------- ## */ @@ -451,6 +504,9 @@ enum ofperr { /* OF1.0(5,2), OF1.1+(9,2). Permissions error. */ OFPERR_OFPQOFC_EPERM, + /* NX1.4+(23). System error retrieving queue details. */ + OFPERR_NXQOFC_QUEUE_ERROR, + /* ## -------------------------- ## */ /* ## OFPET_SWITCH_CONFIG_FAILED ## */ /* ## -------------------------- ## */ @@ -537,91 +593,121 @@ enum ofperr { /* ## OFPET_BAD_PROPERTY ## */ /* ## ------------------ ## */ - /* OF1.3(13,2), OF1.4+(14,0). Unknown property type. + /* NX1.0-1.1(13,2), NX1.2(25), OF1.3(13,2), OF1.4+(14,0). Unknown property + * type. * * [Known as OFPTFFC_BAD_TYPE in OF1.3.] */ OFPERR_OFPBPC_BAD_TYPE, - /* OF1.3(13,3), OF1.4+(14,1). Length problem in property. + /* NX1.0-1.1(13,3), NX1.2(26), OF1.3(13,3), OF1.4+(14,1). Length problem + * in property. * * [Known as OFPTFFC_BAD_LEN in OF1.3.] */ OFPERR_OFPBPC_BAD_LEN, - /* OF1.3(13,4), OF1.4+(14,2). Unsupported property value. + /* NX1.0-1.1(13,4), NX1.2(27), OF1.3(13,4), OF1.4+(14,2). Unsupported + * property value. * * [Known as OFPTFFC_BAD_ARGUMENT in OF1.3.] */ OFPERR_OFPBPC_BAD_VALUE, - /* OF1.4+(14,3). Can't handle this many properties. */ + /* NX1.0-1.1(14,3), NX1.2(28), ONF1.3(4443), OF1.4+(14,3). Can't handle + * this many properties. */ OFPERR_OFPBPC_TOO_MANY, - /* OF1.4+(14,4). A property type was duplicated. */ + /* NX1.0-1.1(14,4), NX1.2(29), ONF1.3(4444), OF1.4+(14,4). A property type + * was duplicated. */ OFPERR_OFPBPC_DUP_TYPE, - /* OF1.4+(14,5). Unknown experimenter id specified. */ + /* NX1.0-1.1(14,5), NX1.2(30), ONF1.3(4445), OF1.4+(14,5). Unknown + * experimenter id specified. */ OFPERR_OFPBPC_BAD_EXPERIMENTER, - /* OF1.4+(14,6). Unknown exp_type for experimenter id. */ + /* NX1.0-1.1(14,6), NX1.2(31), ONF1.3(4446), OF1.4+(14,6). Unknown + * exp_type for experimenter id. */ OFPERR_OFPBPC_BAD_EXP_TYPE, - /* OF1.4+(14,7). Unknown value for experimenter id. */ + /* NX1.0-1.1(14,7), NX1.2(32), ONF1.3(4447), OF1.4+(14,7). Unknown value + * for experimenter id. */ OFPERR_OFPBPC_BAD_EXP_VALUE, - /* OF1.4+(14,8). Permissions error. */ + /* NX1.0-1.1(14,8), NX1.2(33), ONF1.3(4448), OF1.4+(14,8). Permissions + * error. */ OFPERR_OFPBPC_EPERM, +/* ## -------------------------- ## */ +/* ## OFPET_ASYNC_CONFIG_FAILED ## */ +/* ## -------------------------- ## */ + + /* OF1.4+(15,0). One mask is invalid. */ + OFPERR_OFPACFC_INVALID, + + /* OF1.4+(15,1). Requested configuration not supported. */ + OFPERR_OFPACFC_UNSUPPORTED, + + /* OF1.4+(15,2). Permissions error. */ + OFPERR_OFPACFC_EPERM, + /* ## -------------------- ## */ /* ## OFPET_BUNDLE_FAILED ## */ /* ## -------------------- ## */ - /* OF1.4+(17,0). Unspecified error. */ + /* ONF1.3(2300), OF1.4+(17,0). Unspecified error. */ OFPERR_OFPBFC_UNKNOWN, - /* OF1.4+(17,1). Permissions error. */ + /* ONF1.3(2301), OF1.4+(17,1). Permissions error. */ OFPERR_OFPBFC_EPERM, - /* OF1.4+(17,2). Bundle ID doesn't exist. */ + /* ONF1.3(2302), OF1.4+(17,2). Bundle ID doesn't exist. */ OFPERR_OFPBFC_BAD_ID, - /* OF1.4+(17,3). Bundle ID already exists. */ + /* ONF1.3(2303), OF1.4+(17,3). Bundle ID already exists. */ OFPERR_OFPBFC_BUNDLE_EXIST, - /* OF1.4+(17,4). Bundle ID is closed. */ + /* ONF1.3(2304), OF1.4+(17,4). Bundle ID is closed. */ OFPERR_OFPBFC_BUNDLE_CLOSED, - /* OF1.4+(17,5). Too many bundle IDs. */ + /* ONF1.3(2305), OF1.4+(17,5). Too many bundle IDs. */ OFPERR_OFPBFC_OUT_OF_BUNDLES, - /* OF1.4+(17,6). Unsupported of unknown message control type. */ + /* ONF1.3(2306), OF1.4+(17,6). Unsupported of unknown message control + * type. */ OFPERR_OFPBFC_BAD_TYPE, - /* OF1.4+(17,7). Unsupported, unknown, or inconsistent flags. */ + /* ONF1.3(2307), OF1.4+(17,7). Unsupported, unknown, or inconsistent + * flags. */ OFPERR_OFPBFC_BAD_FLAGS, - /* OF1.4+(17,8). Length problem in included message. */ + /* ONF1.3(2308), OF1.4+(17,8). Length problem in included message. */ OFPERR_OFPBFC_MSG_BAD_LEN, - /* OF1.4+(17,9). Inconsistent or duplicate XID. */ + /* ONF1.3(2309), OF1.4+(17,9). Inconsistent or duplicate XID. */ OFPERR_OFPBFC_MSG_BAD_XID, - /* OF1.4+(17,10). Unsupported message in this bundle. */ + /* ONF1.3(2310), OF1.4+(17,10). Unsupported message in this bundle. */ OFPERR_OFPBFC_MSG_UNSUP, - /* OF1.4+(17,11). Unsupported message combination in this bundle. */ + /* ONF1.3(2311), OF1.4+(17,11). Unsupported message combination in this + * bundle. */ OFPERR_OFPBFC_MSG_CONFLICT, - /* OF1.4+(17,12). Cant handle this many messages in bundle. */ + /* ONF1.3(2312), OF1.4+(17,12). Cant handle this many messages in + * bundle. */ OFPERR_OFPBFC_MSG_TOO_MANY, - /* OF1.4+(17,13). One message in bundle failed. */ + /* ONF1.3(2313), OF1.4+(17,13). One message in bundle failed. */ OFPERR_OFPBFC_MSG_FAILED, - /* OF1.4+(17,14). Bundle is taking too long. */ + /* ONF1.3(2314), OF1.4+(17,14). Bundle is taking too long. */ OFPERR_OFPBFC_TIMEOUT, - /* OF1.4+(17,15). Bundle is locking the resource. */ + /* ONF1.3(2315), OF1.4+(17,15). Bundle is locking the resource. */ OFPERR_OFPBFC_BUNDLE_IN_PROGRESS, + /* NX1.3+(22). In an OFPT_BUNDLE_ADD_MESSAGE, the OpenFlow version in the + * inner and outer messages differ. */ + OFPERR_NXBFC_BAD_VERSION, + /* ## ------------------------- ## */ /* ## OFPET_FLOW_MONITOR_FAILED ## */ /* ## ------------------------- ## */ @@ -654,9 +740,47 @@ enum ofperr { /* OF1.4+(16,7). Error in output port/group. */ OFPERR_OFPMOFC_BAD_OUT, -/* ## ------------------ ## */ -/* ## OFPET_EXPERIMENTER ## */ -/* ## ------------------ ## */ +/* ## ----------------------------- ## */ +/* ## OFPET_TLV_TABLE_MOD_FAILED ## */ +/* ## ----------------------------- ## */ + + /* NX1.0-1.1(1,527), NX1.2+(16). The TLV table mod command is not + * recognized as a valid operation. */ + OFPERR_NXTTMFC_BAD_COMMAND, + + /* NX1.0-1.1(1,528), NX1.2+(17). The option length is not a valid + * option size for TLVs. */ + OFPERR_NXTTMFC_BAD_OPT_LEN, + + /* NX1.0-1.1(1,529), NX1.2+(18). The field index is out of range for + * the supported NX_TUN_METADATA match. */ + OFPERR_NXTTMFC_BAD_FIELD_IDX, + + /* NX1.0-1.1(1,530), NX1.2+(19). The total set of configured options + * exceeds the maximum supported by the switch. */ + OFPERR_NXTTMFC_TABLE_FULL, + + /* NX1.0-1.1(1,531), NX1.2+(20). The controller issued an NXTTMC_ADD + * command for a field index that is already mapped. */ + OFPERR_NXTTMFC_ALREADY_MAPPED, + + /* NX1.0-1.1(1,532), NX1.2+(21). The option TLV that is attempting + * to be mapped is the same as one assigned to a different field. */ + OFPERR_NXTTMFC_DUP_ENTRY, + +/* ## ---------- ## */ +/* ## NXT_RESUME ## */ +/* ## ---------- ## */ + + /* NX1.0-1.1(1,533), NX1.2+(34). This datapath doesn't support + * NXT_RESUME. */ + OFPERR_NXR_NOT_SUPPORTED, + + /* NX1.0-1.1(1,534), NX1.2+(35). Continuation is stale: Open vSwitch + * process has been restarted or bridge has been destroyed since + * continuation was generated, or continuation was not generated by this + * Open vSwitch instance. */ + OFPERR_NXR_STALE, }; const char *ofperr_domain_get_name(enum ofp_version);