diff options
Diffstat (limited to 'net/netlabel/netlabel_mgmt.h')
| -rw-r--r-- | net/netlabel/netlabel_mgmt.h | 211 |
1 files changed, 68 insertions, 143 deletions
diff --git a/net/netlabel/netlabel_mgmt.h b/net/netlabel/netlabel_mgmt.h index fd6c6acbfa08..3642d3bfc8eb 100644 --- a/net/netlabel/netlabel_mgmt.h +++ b/net/netlabel/netlabel_mgmt.h | |||
| @@ -34,212 +34,137 @@ | |||
| 34 | #include <net/netlabel.h> | 34 | #include <net/netlabel.h> |
| 35 | 35 | ||
| 36 | /* | 36 | /* |
| 37 | * The following NetLabel payloads are supported by the management interface, | 37 | * The following NetLabel payloads are supported by the management interface. |
| 38 | * all of which are preceeded by the nlmsghdr struct. | ||
| 39 | * | ||
| 40 | * o ACK: | ||
| 41 | * Sent by the kernel in response to an applications message, applications | ||
| 42 | * should never send this message. | ||
| 43 | * | ||
| 44 | * +----------------------+-----------------------+ | ||
| 45 | * | seq number (32 bits) | return code (32 bits) | | ||
| 46 | * +----------------------+-----------------------+ | ||
| 47 | * | ||
| 48 | * seq number: the sequence number of the original message, taken from the | ||
| 49 | * nlmsghdr structure | ||
| 50 | * return code: return value, based on errno values | ||
| 51 | * | 38 | * |
| 52 | * o ADD: | 39 | * o ADD: |
| 53 | * Sent by an application to add a domain mapping to the NetLabel system. | 40 | * Sent by an application to add a domain mapping to the NetLabel system. |
| 54 | * The kernel should respond with an ACK. | ||
| 55 | * | ||
| 56 | * +-------------------+ | ||
| 57 | * | domains (32 bits) | ... | ||
| 58 | * +-------------------+ | ||
| 59 | * | ||
| 60 | * domains: the number of domains in the message | ||
| 61 | * | ||
| 62 | * +--------------------------+-------------------------+ | ||
| 63 | * | domain string (variable) | protocol type (32 bits) | ... | ||
| 64 | * +--------------------------+-------------------------+ | ||
| 65 | * | 41 | * |
| 66 | * +-------------- ---- --- -- - | 42 | * Required attributes: |
| 67 | * | mapping data ... repeated | ||
| 68 | * +-------------- ---- --- -- - | ||
| 69 | * | 43 | * |
| 70 | * domain string: the domain string, NULL terminated | 44 | * NLBL_MGMT_A_DOMAIN |
| 71 | * protocol type: the protocol type (defined by NETLBL_NLTYPE_*) | 45 | * NLBL_MGMT_A_PROTOCOL |
| 72 | * mapping data: specific to the map type (see below) | ||
| 73 | * | 46 | * |
| 74 | * NETLBL_NLTYPE_UNLABELED | 47 | * If using NETLBL_NLTYPE_CIPSOV4 the following attributes are required: |
| 75 | * | 48 | * |
| 76 | * No mapping data for this protocol type. | 49 | * NLBL_MGMT_A_CV4DOI |
| 77 | * | 50 | * |
| 78 | * NETLBL_NLTYPE_CIPSOV4 | 51 | * If using NETLBL_NLTYPE_UNLABELED no other attributes are required. |
| 79 | * | ||
| 80 | * +---------------+ | ||
| 81 | * | doi (32 bits) | | ||
| 82 | * +---------------+ | ||
| 83 | * | ||
| 84 | * doi: the CIPSO DOI value | ||
| 85 | * | 52 | * |
| 86 | * o REMOVE: | 53 | * o REMOVE: |
| 87 | * Sent by an application to remove a domain mapping from the NetLabel | 54 | * Sent by an application to remove a domain mapping from the NetLabel |
| 88 | * system. The kernel should ACK this message. | 55 | * system. |
| 89 | * | ||
| 90 | * +-------------------+ | ||
| 91 | * | domains (32 bits) | ... | ||
| 92 | * +-------------------+ | ||
| 93 | * | 56 | * |
| 94 | * domains: the number of domains in the message | 57 | * Required attributes: |
| 95 | * | 58 | * |
| 96 | * +--------------------------+ | 59 | * NLBL_MGMT_A_DOMAIN |
| 97 | * | domain string (variable) | ... | ||
| 98 | * +--------------------------+ | ||
| 99 | * | 60 | * |
| 100 | * domain string: the domain string, NULL terminated | 61 | * o LISTALL: |
| 101 | * | ||
| 102 | * o LIST: | ||
| 103 | * This message can be sent either from an application or by the kernel in | 62 | * This message can be sent either from an application or by the kernel in |
| 104 | * response to an application generated LIST message. When sent by an | 63 | * response to an application generated LISTALL message. When sent by an |
| 105 | * application there is no payload. The kernel should respond to a LIST | 64 | * application there is no payload and the NLM_F_DUMP flag should be set. |
| 106 | * message either with a LIST message on success or an ACK message on | 65 | * The kernel should respond with a series of the following messages. |
| 107 | * failure. | ||
| 108 | * | ||
| 109 | * +-------------------+ | ||
| 110 | * | domains (32 bits) | ... | ||
| 111 | * +-------------------+ | ||
| 112 | * | ||
| 113 | * domains: the number of domains in the message | ||
| 114 | * | 66 | * |
| 115 | * +--------------------------+ | 67 | * Required attributes: |
| 116 | * | domain string (variable) | ... | ||
| 117 | * +--------------------------+ | ||
| 118 | * | 68 | * |
| 119 | * +-------------------------+-------------- ---- --- -- - | 69 | * NLBL_MGMT_A_DOMAIN |
| 120 | * | protocol type (32 bits) | mapping data ... repeated | 70 | * NLBL_MGMT_A_PROTOCOL |
| 121 | * +-------------------------+-------------- ---- --- -- - | ||
| 122 | * | 71 | * |
| 123 | * domain string: the domain string, NULL terminated | 72 | * If using NETLBL_NLTYPE_CIPSOV4 the following attributes are required: |
| 124 | * protocol type: the protocol type (defined by NETLBL_NLTYPE_*) | ||
| 125 | * mapping data: specific to the map type (see below) | ||
| 126 | * | 73 | * |
| 127 | * NETLBL_NLTYPE_UNLABELED | 74 | * NLBL_MGMT_A_CV4DOI |
| 128 | * | 75 | * |
| 129 | * No mapping data for this protocol type. | 76 | * If using NETLBL_NLTYPE_UNLABELED no other attributes are required. |
| 130 | * | ||
| 131 | * NETLBL_NLTYPE_CIPSOV4 | ||
| 132 | * | ||
| 133 | * +----------------+---------------+ | ||
| 134 | * | type (32 bits) | doi (32 bits) | | ||
| 135 | * +----------------+---------------+ | ||
| 136 | * | ||
| 137 | * type: the CIPSO mapping table type (defined in the cipso_ipv4.h header | ||
| 138 | * as CIPSO_V4_MAP_*) | ||
| 139 | * doi: the CIPSO DOI value | ||
| 140 | * | 77 | * |
| 141 | * o ADDDEF: | 78 | * o ADDDEF: |
| 142 | * Sent by an application to set the default domain mapping for the NetLabel | 79 | * Sent by an application to set the default domain mapping for the NetLabel |
| 143 | * system. The kernel should respond with an ACK. | 80 | * system. |
| 144 | * | 81 | * |
| 145 | * +-------------------------+-------------- ---- --- -- - | 82 | * Required attributes: |
| 146 | * | protocol type (32 bits) | mapping data ... repeated | ||
| 147 | * +-------------------------+-------------- ---- --- -- - | ||
| 148 | * | 83 | * |
| 149 | * protocol type: the protocol type (defined by NETLBL_NLTYPE_*) | 84 | * NLBL_MGMT_A_PROTOCOL |
| 150 | * mapping data: specific to the map type (see below) | ||
| 151 | * | 85 | * |
| 152 | * NETLBL_NLTYPE_UNLABELED | 86 | * If using NETLBL_NLTYPE_CIPSOV4 the following attributes are required: |
| 153 | * | 87 | * |
| 154 | * No mapping data for this protocol type. | 88 | * NLBL_MGMT_A_CV4DOI |
| 155 | * | 89 | * |
| 156 | * NETLBL_NLTYPE_CIPSOV4 | 90 | * If using NETLBL_NLTYPE_UNLABELED no other attributes are required. |
| 157 | * | ||
| 158 | * +---------------+ | ||
| 159 | * | doi (32 bits) | | ||
| 160 | * +---------------+ | ||
| 161 | * | ||
| 162 | * doi: the CIPSO DOI value | ||
| 163 | * | 91 | * |
| 164 | * o REMOVEDEF: | 92 | * o REMOVEDEF: |
| 165 | * Sent by an application to remove the default domain mapping from the | 93 | * Sent by an application to remove the default domain mapping from the |
| 166 | * NetLabel system, there is no payload. The kernel should ACK this message. | 94 | * NetLabel system, there is no payload. |
| 167 | * | 95 | * |
| 168 | * o LISTDEF: | 96 | * o LISTDEF: |
| 169 | * This message can be sent either from an application or by the kernel in | 97 | * This message can be sent either from an application or by the kernel in |
| 170 | * response to an application generated LISTDEF message. When sent by an | 98 | * response to an application generated LISTDEF message. When sent by an |
| 171 | * application there is no payload. The kernel should respond to a | 99 | * application there is no payload. On success the kernel should send a |
| 172 | * LISTDEF message either with a LISTDEF message on success or an ACK message | 100 | * response using the following format. |
| 173 | * on failure. | ||
| 174 | * | ||
| 175 | * +-------------------------+-------------- ---- --- -- - | ||
| 176 | * | protocol type (32 bits) | mapping data ... repeated | ||
| 177 | * +-------------------------+-------------- ---- --- -- - | ||
| 178 | * | 101 | * |
| 179 | * protocol type: the protocol type (defined by NETLBL_NLTYPE_*) | 102 | * Required attributes: |
| 180 | * mapping data: specific to the map type (see below) | ||
| 181 | * | 103 | * |
| 182 | * NETLBL_NLTYPE_UNLABELED | 104 | * NLBL_MGMT_A_PROTOCOL |
| 183 | * | 105 | * |
| 184 | * No mapping data for this protocol type. | 106 | * If using NETLBL_NLTYPE_CIPSOV4 the following attributes are required: |
| 185 | * | 107 | * |
| 186 | * NETLBL_NLTYPE_CIPSOV4 | 108 | * NLBL_MGMT_A_CV4DOI |
| 187 | * | 109 | * |
| 188 | * +----------------+---------------+ | 110 | * If using NETLBL_NLTYPE_UNLABELED no other attributes are required. |
| 189 | * | type (32 bits) | doi (32 bits) | | ||
| 190 | * +----------------+---------------+ | ||
| 191 | * | 111 | * |
| 192 | * type: the CIPSO mapping table type (defined in the cipso_ipv4.h header | 112 | * o PROTOCOLS: |
| 193 | * as CIPSO_V4_MAP_*) | 113 | * Sent by an application to request a list of configured NetLabel protocols |
| 194 | * doi: the CIPSO DOI value | 114 | * in the kernel. When sent by an application there is no payload and the |
| 115 | * NLM_F_DUMP flag should be set. The kernel should respond with a series of | ||
| 116 | * the following messages. | ||
| 195 | * | 117 | * |
| 196 | * o MODULES: | 118 | * Required attributes: |
| 197 | * Sent by an application to request a list of configured NetLabel modules | ||
| 198 | * in the kernel. When sent by an application there is no payload. | ||
| 199 | * | 119 | * |
| 200 | * +-------------------+ | 120 | * NLBL_MGMT_A_PROTOCOL |
| 201 | * | modules (32 bits) | ... | ||
| 202 | * +-------------------+ | ||
| 203 | * | ||
| 204 | * modules: the number of modules in the message, if this is an application | ||
| 205 | * generated message and the value is zero then return a list of | ||
| 206 | * the configured modules | ||
| 207 | * | ||
| 208 | * +------------------+ | ||
| 209 | * | module (32 bits) | ... repeated | ||
| 210 | * +------------------+ | ||
| 211 | * | ||
| 212 | * module: the module number as defined by NETLBL_NLTYPE_* | ||
| 213 | * | 121 | * |
| 214 | * o VERSION: | 122 | * o VERSION: |
| 215 | * Sent by an application to request the NetLabel version string. When sent | 123 | * Sent by an application to request the NetLabel version. When sent by an |
| 216 | * by an application there is no payload. This message type is also used by | 124 | * application there is no payload. This message type is also used by the |
| 217 | * the kernel to respond to an VERSION request. | 125 | * kernel to respond to an VERSION request. |
| 218 | * | 126 | * |
| 219 | * +-------------------+ | 127 | * Required attributes: |
| 220 | * | version (32 bits) | | ||
| 221 | * +-------------------+ | ||
| 222 | * | 128 | * |
| 223 | * version: the protocol version number | 129 | * NLBL_MGMT_A_VERSION |
| 224 | * | 130 | * |
| 225 | */ | 131 | */ |
| 226 | 132 | ||
| 227 | /* NetLabel Management commands */ | 133 | /* NetLabel Management commands */ |
| 228 | enum { | 134 | enum { |
| 229 | NLBL_MGMT_C_UNSPEC, | 135 | NLBL_MGMT_C_UNSPEC, |
| 230 | NLBL_MGMT_C_ACK, | ||
| 231 | NLBL_MGMT_C_ADD, | 136 | NLBL_MGMT_C_ADD, |
| 232 | NLBL_MGMT_C_REMOVE, | 137 | NLBL_MGMT_C_REMOVE, |
| 233 | NLBL_MGMT_C_LIST, | 138 | NLBL_MGMT_C_LISTALL, |
| 234 | NLBL_MGMT_C_ADDDEF, | 139 | NLBL_MGMT_C_ADDDEF, |
| 235 | NLBL_MGMT_C_REMOVEDEF, | 140 | NLBL_MGMT_C_REMOVEDEF, |
| 236 | NLBL_MGMT_C_LISTDEF, | 141 | NLBL_MGMT_C_LISTDEF, |
| 237 | NLBL_MGMT_C_MODULES, | 142 | NLBL_MGMT_C_PROTOCOLS, |
| 238 | NLBL_MGMT_C_VERSION, | 143 | NLBL_MGMT_C_VERSION, |
| 239 | __NLBL_MGMT_C_MAX, | 144 | __NLBL_MGMT_C_MAX, |
| 240 | }; | 145 | }; |
| 241 | #define NLBL_MGMT_C_MAX (__NLBL_MGMT_C_MAX - 1) | 146 | #define NLBL_MGMT_C_MAX (__NLBL_MGMT_C_MAX - 1) |
| 242 | 147 | ||
| 148 | /* NetLabel Management attributes */ | ||
| 149 | enum { | ||
| 150 | NLBL_MGMT_A_UNSPEC, | ||
| 151 | NLBL_MGMT_A_DOMAIN, | ||
| 152 | /* (NLA_NUL_STRING) | ||
| 153 | * the NULL terminated LSM domain string */ | ||
| 154 | NLBL_MGMT_A_PROTOCOL, | ||
| 155 | /* (NLA_U32) | ||
| 156 | * the NetLabel protocol type (defined by NETLBL_NLTYPE_*) */ | ||
| 157 | NLBL_MGMT_A_VERSION, | ||
| 158 | /* (NLA_U32) | ||
| 159 | * the NetLabel protocol version number (defined by | ||
| 160 | * NETLBL_PROTO_VERSION) */ | ||
| 161 | NLBL_MGMT_A_CV4DOI, | ||
| 162 | /* (NLA_U32) | ||
| 163 | * the CIPSOv4 DOI value */ | ||
| 164 | __NLBL_MGMT_A_MAX, | ||
| 165 | }; | ||
| 166 | #define NLBL_MGMT_A_MAX (__NLBL_MGMT_A_MAX - 1) | ||
| 167 | |||
| 243 | /* NetLabel protocol functions */ | 168 | /* NetLabel protocol functions */ |
| 244 | int netlbl_mgmt_genl_init(void); | 169 | int netlbl_mgmt_genl_init(void); |
| 245 | 170 | ||
