1 /* 2 * Copyright 2020-2025 The OpenSSL Project Authors. All Rights Reserved. 3 * 4 * Licensed under the Apache License 2.0 (the "License"). You may not use 5 * this file except in compliance with the License. You can obtain a copy 6 * in the file LICENSE in the source distribution or at 7 * https://www.openssl.org/source/license.html 8 */ 9 10 /* We need to use some engine deprecated APIs */ 11 #define OPENSSL_SUPPRESS_DEPRECATED 12 13 #include <string.h> 14 #include <openssl/core_dispatch.h> 15 #include <openssl/core_names.h> 16 #include <openssl/params.h> 17 #include <openssl/err.h> 18 #include <openssl/evp.h> 19 #include <openssl/proverr.h> 20 #include <openssl/param_build.h> 21 #ifndef FIPS_MODULE 22 # include <openssl/engine.h> 23 #endif 24 #include "internal/param_build_set.h" 25 #include "prov/implementations.h" 26 #include "prov/providercommon.h" 27 #include "prov/provider_ctx.h" 28 #include "prov/macsignature.h" 29 30 static OSSL_FUNC_keymgmt_new_fn mac_new; 31 static OSSL_FUNC_keymgmt_free_fn mac_free; 32 static OSSL_FUNC_keymgmt_gen_init_fn mac_gen_init; 33 static OSSL_FUNC_keymgmt_gen_fn mac_gen; 34 static OSSL_FUNC_keymgmt_gen_cleanup_fn mac_gen_cleanup; 35 static OSSL_FUNC_keymgmt_gen_set_params_fn mac_gen_set_params; 36 static OSSL_FUNC_keymgmt_gen_settable_params_fn mac_gen_settable_params; 37 static OSSL_FUNC_keymgmt_get_params_fn mac_get_params; 38 static OSSL_FUNC_keymgmt_gettable_params_fn mac_gettable_params; 39 static OSSL_FUNC_keymgmt_set_params_fn mac_set_params; 40 static OSSL_FUNC_keymgmt_settable_params_fn mac_settable_params; 41 static OSSL_FUNC_keymgmt_has_fn mac_has; 42 static OSSL_FUNC_keymgmt_match_fn mac_match; 43 static OSSL_FUNC_keymgmt_import_fn mac_import; 44 static OSSL_FUNC_keymgmt_import_types_fn mac_imexport_types; 45 static OSSL_FUNC_keymgmt_export_fn mac_export; 46 static OSSL_FUNC_keymgmt_export_types_fn mac_imexport_types; 47 48 static OSSL_FUNC_keymgmt_new_fn mac_new_cmac; 49 static OSSL_FUNC_keymgmt_gettable_params_fn cmac_gettable_params; 50 static OSSL_FUNC_keymgmt_import_types_fn cmac_imexport_types; 51 static OSSL_FUNC_keymgmt_export_types_fn cmac_imexport_types; 52 static OSSL_FUNC_keymgmt_gen_init_fn cmac_gen_init; 53 static OSSL_FUNC_keymgmt_gen_set_params_fn cmac_gen_set_params; 54 static OSSL_FUNC_keymgmt_gen_settable_params_fn cmac_gen_settable_params; 55 56 struct mac_gen_ctx { 57 OSSL_LIB_CTX *libctx; 58 int selection; 59 unsigned char *priv_key; 60 size_t priv_key_len; 61 PROV_CIPHER cipher; 62 }; 63 64 MAC_KEY *ossl_mac_key_new(OSSL_LIB_CTX *libctx, int cmac) 65 { 66 MAC_KEY *mackey; 67 68 if (!ossl_prov_is_running()) 69 return NULL; 70 71 mackey = OPENSSL_zalloc(sizeof(*mackey)); 72 if (mackey == NULL) 73 return NULL; 74 75 if (!CRYPTO_NEW_REF(&mackey->refcnt, 1)) { 76 OPENSSL_free(mackey); 77 return NULL; 78 } 79 mackey->libctx = libctx; 80 mackey->cmac = cmac; 81 82 return mackey; 83 } 84 85 void ossl_mac_key_free(MAC_KEY *mackey) 86 { 87 int ref = 0; 88 89 if (mackey == NULL) 90 return; 91 92 CRYPTO_DOWN_REF(&mackey->refcnt, &ref); 93 if (ref > 0) 94 return; 95 96 OPENSSL_secure_clear_free(mackey->priv_key, mackey->priv_key_len); 97 OPENSSL_free(mackey->properties); 98 ossl_prov_cipher_reset(&mackey->cipher); 99 CRYPTO_FREE_REF(&mackey->refcnt); 100 OPENSSL_free(mackey); 101 } 102 103 int ossl_mac_key_up_ref(MAC_KEY *mackey) 104 { 105 int ref = 0; 106 107 /* This is effectively doing a new operation on the MAC_KEY and should be 108 * adequately guarded again modules' error states. However, both current 109 * calls here are guarded properly in signature/mac_legacy.c. Thus, it 110 * could be removed here. The concern is that something in the future 111 * might call this function without adequate guards. It's a cheap call, 112 * it seems best to leave it even though it is currently redundant. 113 */ 114 if (!ossl_prov_is_running()) 115 return 0; 116 117 CRYPTO_UP_REF(&mackey->refcnt, &ref); 118 return 1; 119 } 120 121 static void *mac_new(void *provctx) 122 { 123 return ossl_mac_key_new(PROV_LIBCTX_OF(provctx), 0); 124 } 125 126 static void *mac_new_cmac(void *provctx) 127 { 128 return ossl_mac_key_new(PROV_LIBCTX_OF(provctx), 1); 129 } 130 131 static void mac_free(void *mackey) 132 { 133 ossl_mac_key_free(mackey); 134 } 135 136 static int mac_has(const void *keydata, int selection) 137 { 138 const MAC_KEY *key = keydata; 139 int ok = 0; 140 141 if (ossl_prov_is_running() && key != NULL) { 142 /* 143 * MAC keys always have all the parameters they need (i.e. none). 144 * Therefore we always return with 1, if asked about parameters. 145 * Similarly for public keys. 146 */ 147 ok = 1; 148 149 if ((selection & OSSL_KEYMGMT_SELECT_PRIVATE_KEY) != 0) 150 ok = key->priv_key != NULL; 151 } 152 return ok; 153 } 154 155 static int mac_match(const void *keydata1, const void *keydata2, int selection) 156 { 157 const MAC_KEY *key1 = keydata1; 158 const MAC_KEY *key2 = keydata2; 159 int ok = 1; 160 161 if (!ossl_prov_is_running()) 162 return 0; 163 164 if ((selection & OSSL_KEYMGMT_SELECT_PRIVATE_KEY) != 0) { 165 if ((key1->priv_key == NULL && key2->priv_key != NULL) 166 || (key1->priv_key != NULL && key2->priv_key == NULL) 167 || key1->priv_key_len != key2->priv_key_len 168 || (key1->cipher.cipher == NULL && key2->cipher.cipher != NULL) 169 || (key1->cipher.cipher != NULL && key2->cipher.cipher == NULL)) 170 ok = 0; 171 else 172 ok = ok && (key1->priv_key == NULL /* implies key2->privkey == NULL */ 173 || CRYPTO_memcmp(key1->priv_key, key2->priv_key, 174 key1->priv_key_len) == 0); 175 if (key1->cipher.cipher != NULL) 176 ok = ok && EVP_CIPHER_is_a(key1->cipher.cipher, 177 EVP_CIPHER_get0_name(key2->cipher.cipher)); 178 } 179 return ok; 180 } 181 182 static int mac_key_fromdata(MAC_KEY *key, const OSSL_PARAM params[]) 183 { 184 const OSSL_PARAM *p; 185 186 p = OSSL_PARAM_locate_const(params, OSSL_PKEY_PARAM_PRIV_KEY); 187 if (p != NULL) { 188 if (p->data_type != OSSL_PARAM_OCTET_STRING) { 189 ERR_raise(ERR_LIB_PROV, ERR_R_PASSED_INVALID_ARGUMENT); 190 return 0; 191 } 192 OPENSSL_secure_clear_free(key->priv_key, key->priv_key_len); 193 /* allocate at least one byte to distinguish empty key from no key set */ 194 key->priv_key = OPENSSL_secure_malloc(p->data_size > 0 ? p->data_size : 1); 195 if (key->priv_key == NULL) 196 return 0; 197 memcpy(key->priv_key, p->data, p->data_size); 198 key->priv_key_len = p->data_size; 199 } 200 201 p = OSSL_PARAM_locate_const(params, OSSL_PKEY_PARAM_PROPERTIES); 202 if (p != NULL) { 203 if (p->data_type != OSSL_PARAM_UTF8_STRING) { 204 ERR_raise(ERR_LIB_PROV, ERR_R_PASSED_INVALID_ARGUMENT); 205 return 0; 206 } 207 OPENSSL_free(key->properties); 208 key->properties = OPENSSL_strdup(p->data); 209 if (key->properties == NULL) 210 return 0; 211 } 212 213 if (key->cmac && !ossl_prov_cipher_load_from_params(&key->cipher, params, 214 key->libctx)) { 215 ERR_raise(ERR_LIB_PROV, ERR_R_PASSED_INVALID_ARGUMENT); 216 return 0; 217 } 218 219 if (key->priv_key != NULL) 220 return 1; 221 222 return 0; 223 } 224 225 static int mac_import(void *keydata, int selection, const OSSL_PARAM params[]) 226 { 227 MAC_KEY *key = keydata; 228 229 if (!ossl_prov_is_running() || key == NULL) 230 return 0; 231 232 if ((selection & OSSL_KEYMGMT_SELECT_PRIVATE_KEY) == 0) 233 return 0; 234 235 return mac_key_fromdata(key, params); 236 } 237 238 static int key_to_params(MAC_KEY *key, OSSL_PARAM_BLD *tmpl, 239 OSSL_PARAM params[]) 240 { 241 if (key == NULL) 242 return 0; 243 244 if (key->priv_key != NULL 245 && !ossl_param_build_set_octet_string(tmpl, params, 246 OSSL_PKEY_PARAM_PRIV_KEY, 247 key->priv_key, key->priv_key_len)) 248 return 0; 249 250 if (key->cipher.cipher != NULL 251 && !ossl_param_build_set_utf8_string(tmpl, params, 252 OSSL_PKEY_PARAM_CIPHER, 253 EVP_CIPHER_get0_name(key->cipher.cipher))) 254 return 0; 255 256 #if !defined(OPENSSL_NO_ENGINE) && !defined(FIPS_MODULE) 257 if (key->cipher.engine != NULL 258 && !ossl_param_build_set_utf8_string(tmpl, params, 259 OSSL_PKEY_PARAM_ENGINE, 260 ENGINE_get_id(key->cipher.engine))) 261 return 0; 262 #endif 263 264 return 1; 265 } 266 267 static int mac_export(void *keydata, int selection, OSSL_CALLBACK *param_cb, 268 void *cbarg) 269 { 270 MAC_KEY *key = keydata; 271 OSSL_PARAM_BLD *tmpl; 272 OSSL_PARAM *params = NULL; 273 int ret = 0; 274 275 if (!ossl_prov_is_running() || key == NULL) 276 return 0; 277 278 if ((selection & OSSL_KEYMGMT_SELECT_PRIVATE_KEY) == 0) 279 return 0; 280 281 tmpl = OSSL_PARAM_BLD_new(); 282 if (tmpl == NULL) 283 return 0; 284 285 if ((selection & OSSL_KEYMGMT_SELECT_PRIVATE_KEY) != 0 286 && !key_to_params(key, tmpl, NULL)) 287 goto err; 288 289 params = OSSL_PARAM_BLD_to_param(tmpl); 290 if (params == NULL) 291 goto err; 292 293 ret = param_cb(params, cbarg); 294 OSSL_PARAM_free(params); 295 err: 296 OSSL_PARAM_BLD_free(tmpl); 297 return ret; 298 } 299 300 static const OSSL_PARAM mac_key_types[] = { 301 OSSL_PARAM_octet_string(OSSL_PKEY_PARAM_PRIV_KEY, NULL, 0), 302 OSSL_PARAM_utf8_string(OSSL_PKEY_PARAM_PROPERTIES, NULL, 0), 303 OSSL_PARAM_END 304 }; 305 static const OSSL_PARAM *mac_imexport_types(int selection) 306 { 307 if ((selection & OSSL_KEYMGMT_SELECT_PRIVATE_KEY) != 0) 308 return mac_key_types; 309 return NULL; 310 } 311 312 static const OSSL_PARAM cmac_key_types[] = { 313 OSSL_PARAM_octet_string(OSSL_PKEY_PARAM_PRIV_KEY, NULL, 0), 314 OSSL_PARAM_utf8_string(OSSL_PKEY_PARAM_CIPHER, NULL, 0), 315 OSSL_PARAM_utf8_string(OSSL_PKEY_PARAM_ENGINE, NULL, 0), 316 OSSL_PARAM_utf8_string(OSSL_PKEY_PARAM_PROPERTIES, NULL, 0), 317 OSSL_PARAM_END 318 }; 319 static const OSSL_PARAM *cmac_imexport_types(int selection) 320 { 321 if ((selection & OSSL_KEYMGMT_SELECT_PRIVATE_KEY) != 0) 322 return cmac_key_types; 323 return NULL; 324 } 325 326 static int mac_get_params(void *key, OSSL_PARAM params[]) 327 { 328 return key_to_params(key, NULL, params); 329 } 330 331 static const OSSL_PARAM *mac_gettable_params(void *provctx) 332 { 333 static const OSSL_PARAM gettable_params[] = { 334 OSSL_PARAM_octet_string(OSSL_PKEY_PARAM_PRIV_KEY, NULL, 0), 335 OSSL_PARAM_END 336 }; 337 return gettable_params; 338 } 339 340 static const OSSL_PARAM *cmac_gettable_params(void *provctx) 341 { 342 static const OSSL_PARAM gettable_params[] = { 343 OSSL_PARAM_octet_string(OSSL_PKEY_PARAM_PRIV_KEY, NULL, 0), 344 OSSL_PARAM_utf8_string(OSSL_PKEY_PARAM_CIPHER, NULL, 0), 345 OSSL_PARAM_utf8_string(OSSL_PKEY_PARAM_ENGINE, NULL, 0), 346 OSSL_PARAM_END 347 }; 348 return gettable_params; 349 } 350 351 static int mac_set_params(void *keydata, const OSSL_PARAM params[]) 352 { 353 MAC_KEY *key = keydata; 354 const OSSL_PARAM *p; 355 356 if (key == NULL) 357 return 0; 358 359 p = OSSL_PARAM_locate_const(params, OSSL_PKEY_PARAM_PRIV_KEY); 360 if (p != NULL) 361 return mac_key_fromdata(key, params); 362 363 return 1; 364 } 365 366 static const OSSL_PARAM *mac_settable_params(void *provctx) 367 { 368 static const OSSL_PARAM settable_params[] = { 369 OSSL_PARAM_octet_string(OSSL_PKEY_PARAM_PRIV_KEY, NULL, 0), 370 OSSL_PARAM_END 371 }; 372 return settable_params; 373 } 374 375 static void *mac_gen_init_common(void *provctx, int selection) 376 { 377 OSSL_LIB_CTX *libctx = PROV_LIBCTX_OF(provctx); 378 struct mac_gen_ctx *gctx = NULL; 379 380 if (!ossl_prov_is_running()) 381 return NULL; 382 383 if ((gctx = OPENSSL_zalloc(sizeof(*gctx))) != NULL) { 384 gctx->libctx = libctx; 385 gctx->selection = selection; 386 } 387 return gctx; 388 } 389 390 static void *mac_gen_init(void *provctx, int selection, 391 const OSSL_PARAM params[]) 392 { 393 struct mac_gen_ctx *gctx = mac_gen_init_common(provctx, selection); 394 395 if (gctx != NULL && !mac_gen_set_params(gctx, params)) { 396 mac_gen_cleanup(gctx); 397 gctx = NULL; 398 } 399 return gctx; 400 } 401 402 static void *cmac_gen_init(void *provctx, int selection, 403 const OSSL_PARAM params[]) 404 { 405 struct mac_gen_ctx *gctx = mac_gen_init_common(provctx, selection); 406 407 if (gctx != NULL && !cmac_gen_set_params(gctx, params)) { 408 mac_gen_cleanup(gctx); 409 gctx = NULL; 410 } 411 return gctx; 412 } 413 414 static int mac_gen_set_params(void *genctx, const OSSL_PARAM params[]) 415 { 416 struct mac_gen_ctx *gctx = genctx; 417 const OSSL_PARAM *p; 418 419 if (gctx == NULL) 420 return 0; 421 422 p = OSSL_PARAM_locate_const(params, OSSL_PKEY_PARAM_PRIV_KEY); 423 if (p != NULL) { 424 if (p->data_type != OSSL_PARAM_OCTET_STRING) { 425 ERR_raise(ERR_LIB_PROV, ERR_R_PASSED_INVALID_ARGUMENT); 426 return 0; 427 } 428 gctx->priv_key = OPENSSL_secure_malloc(p->data_size); 429 if (gctx->priv_key == NULL) 430 return 0; 431 memcpy(gctx->priv_key, p->data, p->data_size); 432 gctx->priv_key_len = p->data_size; 433 } 434 435 return 1; 436 } 437 438 static int cmac_gen_set_params(void *genctx, const OSSL_PARAM params[]) 439 { 440 struct mac_gen_ctx *gctx = genctx; 441 442 if (!mac_gen_set_params(genctx, params)) 443 return 0; 444 445 if (!ossl_prov_cipher_load_from_params(&gctx->cipher, params, 446 gctx->libctx)) { 447 ERR_raise(ERR_LIB_PROV, ERR_R_PASSED_INVALID_ARGUMENT); 448 return 0; 449 } 450 451 return 1; 452 } 453 454 static const OSSL_PARAM *mac_gen_settable_params(ossl_unused void *genctx, 455 ossl_unused void *provctx) 456 { 457 static OSSL_PARAM settable[] = { 458 OSSL_PARAM_octet_string(OSSL_PKEY_PARAM_PRIV_KEY, NULL, 0), 459 OSSL_PARAM_END 460 }; 461 return settable; 462 } 463 464 static const OSSL_PARAM *cmac_gen_settable_params(ossl_unused void *genctx, 465 ossl_unused void *provctx) 466 { 467 static OSSL_PARAM settable[] = { 468 OSSL_PARAM_octet_string(OSSL_PKEY_PARAM_PRIV_KEY, NULL, 0), 469 OSSL_PARAM_utf8_string(OSSL_PKEY_PARAM_CIPHER, NULL, 0), 470 OSSL_PARAM_END 471 }; 472 return settable; 473 } 474 475 static void *mac_gen(void *genctx, OSSL_CALLBACK *cb, void *cbarg) 476 { 477 struct mac_gen_ctx *gctx = genctx; 478 MAC_KEY *key; 479 480 if (!ossl_prov_is_running() || gctx == NULL) 481 return NULL; 482 483 if ((key = ossl_mac_key_new(gctx->libctx, 0)) == NULL) { 484 ERR_raise(ERR_LIB_PROV, ERR_R_PROV_LIB); 485 return NULL; 486 } 487 488 /* If we're doing parameter generation then we just return a blank key */ 489 if ((gctx->selection & OSSL_KEYMGMT_SELECT_KEYPAIR) == 0) 490 return key; 491 492 if (gctx->priv_key == NULL) { 493 ERR_raise(ERR_LIB_PROV, PROV_R_INVALID_KEY); 494 ossl_mac_key_free(key); 495 return NULL; 496 } 497 498 /* 499 * This is horrible but required for backwards compatibility. We don't 500 * actually do real key generation at all. We simply copy the key that was 501 * previously set in the gctx. Hopefully at some point in the future all 502 * of this can be removed and we will only support the EVP_KDF APIs. 503 */ 504 if (!ossl_prov_cipher_copy(&key->cipher, &gctx->cipher)) { 505 ossl_mac_key_free(key); 506 ERR_raise(ERR_LIB_PROV, ERR_R_INTERNAL_ERROR); 507 return NULL; 508 } 509 ossl_prov_cipher_reset(&gctx->cipher); 510 key->priv_key = gctx->priv_key; 511 key->priv_key_len = gctx->priv_key_len; 512 gctx->priv_key_len = 0; 513 gctx->priv_key = NULL; 514 515 return key; 516 } 517 518 static void mac_gen_cleanup(void *genctx) 519 { 520 struct mac_gen_ctx *gctx = genctx; 521 522 if (gctx == NULL) 523 return; 524 525 OPENSSL_secure_clear_free(gctx->priv_key, gctx->priv_key_len); 526 ossl_prov_cipher_reset(&gctx->cipher); 527 OPENSSL_free(gctx); 528 } 529 530 const OSSL_DISPATCH ossl_mac_legacy_keymgmt_functions[] = { 531 { OSSL_FUNC_KEYMGMT_NEW, (void (*)(void))mac_new }, 532 { OSSL_FUNC_KEYMGMT_FREE, (void (*)(void))mac_free }, 533 { OSSL_FUNC_KEYMGMT_GET_PARAMS, (void (*) (void))mac_get_params }, 534 { OSSL_FUNC_KEYMGMT_GETTABLE_PARAMS, (void (*) (void))mac_gettable_params }, 535 { OSSL_FUNC_KEYMGMT_SET_PARAMS, (void (*) (void))mac_set_params }, 536 { OSSL_FUNC_KEYMGMT_SETTABLE_PARAMS, (void (*) (void))mac_settable_params }, 537 { OSSL_FUNC_KEYMGMT_HAS, (void (*)(void))mac_has }, 538 { OSSL_FUNC_KEYMGMT_MATCH, (void (*)(void))mac_match }, 539 { OSSL_FUNC_KEYMGMT_IMPORT, (void (*)(void))mac_import }, 540 { OSSL_FUNC_KEYMGMT_IMPORT_TYPES, (void (*)(void))mac_imexport_types }, 541 { OSSL_FUNC_KEYMGMT_EXPORT, (void (*)(void))mac_export }, 542 { OSSL_FUNC_KEYMGMT_EXPORT_TYPES, (void (*)(void))mac_imexport_types }, 543 { OSSL_FUNC_KEYMGMT_GEN_INIT, (void (*)(void))mac_gen_init }, 544 { OSSL_FUNC_KEYMGMT_GEN_SET_PARAMS, (void (*)(void))mac_gen_set_params }, 545 { OSSL_FUNC_KEYMGMT_GEN_SETTABLE_PARAMS, 546 (void (*)(void))mac_gen_settable_params }, 547 { OSSL_FUNC_KEYMGMT_GEN, (void (*)(void))mac_gen }, 548 { OSSL_FUNC_KEYMGMT_GEN_CLEANUP, (void (*)(void))mac_gen_cleanup }, 549 OSSL_DISPATCH_END 550 }; 551 552 const OSSL_DISPATCH ossl_cmac_legacy_keymgmt_functions[] = { 553 { OSSL_FUNC_KEYMGMT_NEW, (void (*)(void))mac_new_cmac }, 554 { OSSL_FUNC_KEYMGMT_FREE, (void (*)(void))mac_free }, 555 { OSSL_FUNC_KEYMGMT_GET_PARAMS, (void (*) (void))mac_get_params }, 556 { OSSL_FUNC_KEYMGMT_GETTABLE_PARAMS, (void (*) (void))cmac_gettable_params }, 557 { OSSL_FUNC_KEYMGMT_SET_PARAMS, (void (*) (void))mac_set_params }, 558 { OSSL_FUNC_KEYMGMT_SETTABLE_PARAMS, (void (*) (void))mac_settable_params }, 559 { OSSL_FUNC_KEYMGMT_HAS, (void (*)(void))mac_has }, 560 { OSSL_FUNC_KEYMGMT_MATCH, (void (*)(void))mac_match }, 561 { OSSL_FUNC_KEYMGMT_IMPORT, (void (*)(void))mac_import }, 562 { OSSL_FUNC_KEYMGMT_IMPORT_TYPES, (void (*)(void))cmac_imexport_types }, 563 { OSSL_FUNC_KEYMGMT_EXPORT, (void (*)(void))mac_export }, 564 { OSSL_FUNC_KEYMGMT_EXPORT_TYPES, (void (*)(void))cmac_imexport_types }, 565 { OSSL_FUNC_KEYMGMT_GEN_INIT, (void (*)(void))cmac_gen_init }, 566 { OSSL_FUNC_KEYMGMT_GEN_SET_PARAMS, (void (*)(void))cmac_gen_set_params }, 567 { OSSL_FUNC_KEYMGMT_GEN_SETTABLE_PARAMS, 568 (void (*)(void))cmac_gen_settable_params }, 569 { OSSL_FUNC_KEYMGMT_GEN, (void (*)(void))mac_gen }, 570 { OSSL_FUNC_KEYMGMT_GEN_CLEANUP, (void (*)(void))mac_gen_cleanup }, 571 OSSL_DISPATCH_END 572 }; 573 574