2 * Written by Dr Stephen N Henson (steve@openssl.org) for the OpenSSL project
5 /* ====================================================================
6 * Copyright (c) 2006 The OpenSSL Project. All rights reserved.
8 * Redistribution and use in source and binary forms, with or without
9 * modification, are permitted provided that the following conditions
12 * 1. Redistributions of source code must retain the above copyright
13 * notice, this list of conditions and the following disclaimer.
15 * 2. Redistributions in binary form must reproduce the above copyright
16 * notice, this list of conditions and the following disclaimer in
17 * the documentation and/or other materials provided with the
20 * 3. All advertising materials mentioning features or use of this
21 * software must display the following acknowledgment:
22 * "This product includes software developed by the OpenSSL Project
23 * for use in the OpenSSL Toolkit. (http://www.OpenSSL.org/)"
25 * 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
26 * endorse or promote products derived from this software without
27 * prior written permission. For written permission, please contact
28 * licensing@OpenSSL.org.
30 * 5. Products derived from this software may not be called "OpenSSL"
31 * nor may "OpenSSL" appear in their names without prior written
32 * permission of the OpenSSL Project.
34 * 6. Redistributions of any form whatsoever must retain the following
36 * "This product includes software developed by the OpenSSL Project
37 * for use in the OpenSSL Toolkit (http://www.OpenSSL.org/)"
39 * THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY
40 * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
41 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
42 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR
43 * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
44 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
45 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
46 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
47 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
48 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
49 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
50 * OF THE POSSIBILITY OF SUCH DAMAGE.
51 * ====================================================================
53 * This product includes cryptographic software written by Eric Young
54 * (eay@cryptsoft.com). This product includes software written by Tim
55 * Hudson (tjh@cryptsoft.com).
61 #include "internal/cryptlib.h"
62 #ifndef OPENSSL_NO_ENGINE
63 # include <openssl/engine.h>
65 #include <openssl/evp.h>
66 #include <openssl/x509v3.h>
67 #include "internal/asn1_int.h"
68 #include "internal/evp_int.h"
69 #include "internal/numbers.h"
71 typedef int sk_cmp_fn_type(const char *const *a
, const char *const *b
);
73 static STACK_OF(EVP_PKEY_METHOD
) *app_pkey_methods
= NULL
;
75 static const EVP_PKEY_METHOD
*standard_methods
[] = {
76 #ifndef OPENSSL_NO_RSA
82 #ifndef OPENSSL_NO_DSA
89 #ifndef OPENSSL_NO_CMAC
99 DECLARE_OBJ_BSEARCH_CMP_FN(const EVP_PKEY_METHOD
*, const EVP_PKEY_METHOD
*,
102 static int pmeth_cmp(const EVP_PKEY_METHOD
*const *a
,
103 const EVP_PKEY_METHOD
*const *b
)
105 return ((*a
)->pkey_id
- (*b
)->pkey_id
);
108 IMPLEMENT_OBJ_BSEARCH_CMP_FN(const EVP_PKEY_METHOD
*, const EVP_PKEY_METHOD
*,
111 const EVP_PKEY_METHOD
*EVP_PKEY_meth_find(int type
)
114 const EVP_PKEY_METHOD
*t
= &tmp
, **ret
;
116 if (app_pkey_methods
) {
118 idx
= sk_EVP_PKEY_METHOD_find(app_pkey_methods
, &tmp
);
120 return sk_EVP_PKEY_METHOD_value(app_pkey_methods
, idx
);
122 ret
= OBJ_bsearch_pmeth(&t
, standard_methods
,
123 sizeof(standard_methods
) /
124 sizeof(EVP_PKEY_METHOD
*));
130 static EVP_PKEY_CTX
*int_ctx_new(EVP_PKEY
*pkey
, ENGINE
*e
, int id
)
133 const EVP_PKEY_METHOD
*pmeth
;
135 if (!pkey
|| !pkey
->ameth
)
137 id
= pkey
->ameth
->pkey_id
;
139 #ifndef OPENSSL_NO_ENGINE
140 if (pkey
&& pkey
->engine
)
142 /* Try to find an ENGINE which implements this method */
144 if (!ENGINE_init(e
)) {
145 EVPerr(EVP_F_INT_CTX_NEW
, ERR_R_ENGINE_LIB
);
149 e
= ENGINE_get_pkey_meth_engine(id
);
152 * If an ENGINE handled this method look it up. Otherwise use internal
157 pmeth
= ENGINE_get_pkey_meth(e
, id
);
160 pmeth
= EVP_PKEY_meth_find(id
);
163 EVPerr(EVP_F_INT_CTX_NEW
, EVP_R_UNSUPPORTED_ALGORITHM
);
167 ret
= OPENSSL_zalloc(sizeof(*ret
));
169 #ifndef OPENSSL_NO_ENGINE
172 EVPerr(EVP_F_INT_CTX_NEW
, ERR_R_MALLOC_FAILURE
);
177 ret
->operation
= EVP_PKEY_OP_UNDEFINED
;
180 EVP_PKEY_up_ref(pkey
);
183 if (pmeth
->init(ret
) <= 0) {
184 EVP_PKEY_CTX_free(ret
);
192 EVP_PKEY_METHOD
*EVP_PKEY_meth_new(int id
, int flags
)
194 EVP_PKEY_METHOD
*pmeth
;
196 pmeth
= OPENSSL_zalloc(sizeof(*pmeth
));
201 pmeth
->flags
= flags
| EVP_PKEY_FLAG_DYNAMIC
;
205 void EVP_PKEY_meth_get0_info(int *ppkey_id
, int *pflags
,
206 const EVP_PKEY_METHOD
*meth
)
209 *ppkey_id
= meth
->pkey_id
;
211 *pflags
= meth
->flags
;
214 void EVP_PKEY_meth_copy(EVP_PKEY_METHOD
*dst
, const EVP_PKEY_METHOD
*src
)
217 dst
->init
= src
->init
;
218 dst
->copy
= src
->copy
;
219 dst
->cleanup
= src
->cleanup
;
221 dst
->paramgen_init
= src
->paramgen_init
;
222 dst
->paramgen
= src
->paramgen
;
224 dst
->keygen_init
= src
->keygen_init
;
225 dst
->keygen
= src
->keygen
;
227 dst
->sign_init
= src
->sign_init
;
228 dst
->sign
= src
->sign
;
230 dst
->verify_init
= src
->verify_init
;
231 dst
->verify
= src
->verify
;
233 dst
->verify_recover_init
= src
->verify_recover_init
;
234 dst
->verify_recover
= src
->verify_recover
;
236 dst
->signctx_init
= src
->signctx_init
;
237 dst
->signctx
= src
->signctx
;
239 dst
->verifyctx_init
= src
->verifyctx_init
;
240 dst
->verifyctx
= src
->verifyctx
;
242 dst
->encrypt_init
= src
->encrypt_init
;
243 dst
->encrypt
= src
->encrypt
;
245 dst
->decrypt_init
= src
->decrypt_init
;
246 dst
->decrypt
= src
->decrypt
;
248 dst
->derive_init
= src
->derive_init
;
249 dst
->derive
= src
->derive
;
251 dst
->ctrl
= src
->ctrl
;
252 dst
->ctrl_str
= src
->ctrl_str
;
255 void EVP_PKEY_meth_free(EVP_PKEY_METHOD
*pmeth
)
257 if (pmeth
&& (pmeth
->flags
& EVP_PKEY_FLAG_DYNAMIC
))
261 EVP_PKEY_CTX
*EVP_PKEY_CTX_new(EVP_PKEY
*pkey
, ENGINE
*e
)
263 return int_ctx_new(pkey
, e
, -1);
266 EVP_PKEY_CTX
*EVP_PKEY_CTX_new_id(int id
, ENGINE
*e
)
268 return int_ctx_new(NULL
, e
, id
);
271 EVP_PKEY_CTX
*EVP_PKEY_CTX_dup(EVP_PKEY_CTX
*pctx
)
274 if (!pctx
->pmeth
|| !pctx
->pmeth
->copy
)
276 #ifndef OPENSSL_NO_ENGINE
277 /* Make sure it's safe to copy a pkey context using an ENGINE */
278 if (pctx
->engine
&& !ENGINE_init(pctx
->engine
)) {
279 EVPerr(EVP_F_EVP_PKEY_CTX_DUP
, ERR_R_ENGINE_LIB
);
283 rctx
= OPENSSL_malloc(sizeof(*rctx
));
287 rctx
->pmeth
= pctx
->pmeth
;
288 #ifndef OPENSSL_NO_ENGINE
289 rctx
->engine
= pctx
->engine
;
293 EVP_PKEY_up_ref(pctx
->pkey
);
295 rctx
->pkey
= pctx
->pkey
;
298 EVP_PKEY_up_ref(pctx
->peerkey
);
300 rctx
->peerkey
= pctx
->peerkey
;
303 rctx
->app_data
= NULL
;
304 rctx
->operation
= pctx
->operation
;
306 if (pctx
->pmeth
->copy(rctx
, pctx
) > 0)
309 EVP_PKEY_CTX_free(rctx
);
314 int EVP_PKEY_meth_add0(const EVP_PKEY_METHOD
*pmeth
)
316 if (app_pkey_methods
== NULL
) {
317 app_pkey_methods
= sk_EVP_PKEY_METHOD_new(pmeth_cmp
);
318 if (app_pkey_methods
== NULL
)
321 if (!sk_EVP_PKEY_METHOD_push(app_pkey_methods
, pmeth
))
323 sk_EVP_PKEY_METHOD_sort(app_pkey_methods
);
327 void EVP_PKEY_CTX_free(EVP_PKEY_CTX
*ctx
)
331 if (ctx
->pmeth
&& ctx
->pmeth
->cleanup
)
332 ctx
->pmeth
->cleanup(ctx
);
333 EVP_PKEY_free(ctx
->pkey
);
334 EVP_PKEY_free(ctx
->peerkey
);
335 #ifndef OPENSSL_NO_ENGINE
336 ENGINE_finish(ctx
->engine
);
341 int EVP_PKEY_CTX_ctrl(EVP_PKEY_CTX
*ctx
, int keytype
, int optype
,
342 int cmd
, int p1
, void *p2
)
345 if (!ctx
|| !ctx
->pmeth
|| !ctx
->pmeth
->ctrl
) {
346 EVPerr(EVP_F_EVP_PKEY_CTX_CTRL
, EVP_R_COMMAND_NOT_SUPPORTED
);
349 if ((keytype
!= -1) && (ctx
->pmeth
->pkey_id
!= keytype
))
352 if (ctx
->operation
== EVP_PKEY_OP_UNDEFINED
) {
353 EVPerr(EVP_F_EVP_PKEY_CTX_CTRL
, EVP_R_NO_OPERATION_SET
);
357 if ((optype
!= -1) && !(ctx
->operation
& optype
)) {
358 EVPerr(EVP_F_EVP_PKEY_CTX_CTRL
, EVP_R_INVALID_OPERATION
);
362 ret
= ctx
->pmeth
->ctrl(ctx
, cmd
, p1
, p2
);
365 EVPerr(EVP_F_EVP_PKEY_CTX_CTRL
, EVP_R_COMMAND_NOT_SUPPORTED
);
371 int EVP_PKEY_CTX_ctrl_str(EVP_PKEY_CTX
*ctx
,
372 const char *name
, const char *value
)
374 if (!ctx
|| !ctx
->pmeth
|| !ctx
->pmeth
->ctrl_str
) {
375 EVPerr(EVP_F_EVP_PKEY_CTX_CTRL_STR
, EVP_R_COMMAND_NOT_SUPPORTED
);
378 if (strcmp(name
, "digest") == 0) {
380 if (value
== NULL
|| (md
= EVP_get_digestbyname(value
)) == NULL
) {
381 EVPerr(EVP_F_EVP_PKEY_CTX_CTRL_STR
, EVP_R_INVALID_DIGEST
);
384 return EVP_PKEY_CTX_set_signature_md(ctx
, md
);
386 return ctx
->pmeth
->ctrl_str(ctx
, name
, value
);
389 /* Utility functions to send a string of hex string to a ctrl */
391 int EVP_PKEY_CTX_str2ctrl(EVP_PKEY_CTX
*ctx
, int cmd
, const char *str
)
398 return ctx
->pmeth
->ctrl(ctx
, cmd
, len
, (void *)str
);
401 int EVP_PKEY_CTX_hex2ctrl(EVP_PKEY_CTX
*ctx
, int cmd
, const char *hex
)
407 bin
= string_to_hex(hex
, &binlen
);
410 if (binlen
<= INT_MAX
)
411 rv
= ctx
->pmeth
->ctrl(ctx
, cmd
, binlen
, bin
);
416 int EVP_PKEY_CTX_get_operation(EVP_PKEY_CTX
*ctx
)
418 return ctx
->operation
;
421 void EVP_PKEY_CTX_set0_keygen_info(EVP_PKEY_CTX
*ctx
, int *dat
, int datlen
)
423 ctx
->keygen_info
= dat
;
424 ctx
->keygen_info_count
= datlen
;
427 void EVP_PKEY_CTX_set_data(EVP_PKEY_CTX
*ctx
, void *data
)
432 void *EVP_PKEY_CTX_get_data(EVP_PKEY_CTX
*ctx
)
437 EVP_PKEY
*EVP_PKEY_CTX_get0_pkey(EVP_PKEY_CTX
*ctx
)
442 EVP_PKEY
*EVP_PKEY_CTX_get0_peerkey(EVP_PKEY_CTX
*ctx
)
447 void EVP_PKEY_CTX_set_app_data(EVP_PKEY_CTX
*ctx
, void *data
)
449 ctx
->app_data
= data
;
452 void *EVP_PKEY_CTX_get_app_data(EVP_PKEY_CTX
*ctx
)
454 return ctx
->app_data
;
457 void EVP_PKEY_meth_set_init(EVP_PKEY_METHOD
*pmeth
,
458 int (*init
) (EVP_PKEY_CTX
*ctx
))
463 void EVP_PKEY_meth_set_copy(EVP_PKEY_METHOD
*pmeth
,
464 int (*copy
) (EVP_PKEY_CTX
*dst
,
470 void EVP_PKEY_meth_set_cleanup(EVP_PKEY_METHOD
*pmeth
,
471 void (*cleanup
) (EVP_PKEY_CTX
*ctx
))
473 pmeth
->cleanup
= cleanup
;
476 void EVP_PKEY_meth_set_paramgen(EVP_PKEY_METHOD
*pmeth
,
477 int (*paramgen_init
) (EVP_PKEY_CTX
*ctx
),
478 int (*paramgen
) (EVP_PKEY_CTX
*ctx
,
481 pmeth
->paramgen_init
= paramgen_init
;
482 pmeth
->paramgen
= paramgen
;
485 void EVP_PKEY_meth_set_keygen(EVP_PKEY_METHOD
*pmeth
,
486 int (*keygen_init
) (EVP_PKEY_CTX
*ctx
),
487 int (*keygen
) (EVP_PKEY_CTX
*ctx
,
490 pmeth
->keygen_init
= keygen_init
;
491 pmeth
->keygen
= keygen
;
494 void EVP_PKEY_meth_set_sign(EVP_PKEY_METHOD
*pmeth
,
495 int (*sign_init
) (EVP_PKEY_CTX
*ctx
),
496 int (*sign
) (EVP_PKEY_CTX
*ctx
,
497 unsigned char *sig
, size_t *siglen
,
498 const unsigned char *tbs
,
501 pmeth
->sign_init
= sign_init
;
505 void EVP_PKEY_meth_set_verify(EVP_PKEY_METHOD
*pmeth
,
506 int (*verify_init
) (EVP_PKEY_CTX
*ctx
),
507 int (*verify
) (EVP_PKEY_CTX
*ctx
,
508 const unsigned char *sig
,
510 const unsigned char *tbs
,
513 pmeth
->verify_init
= verify_init
;
514 pmeth
->verify
= verify
;
517 void EVP_PKEY_meth_set_verify_recover(EVP_PKEY_METHOD
*pmeth
,
518 int (*verify_recover_init
) (EVP_PKEY_CTX
520 int (*verify_recover
) (EVP_PKEY_CTX
529 pmeth
->verify_recover_init
= verify_recover_init
;
530 pmeth
->verify_recover
= verify_recover
;
533 void EVP_PKEY_meth_set_signctx(EVP_PKEY_METHOD
*pmeth
,
534 int (*signctx_init
) (EVP_PKEY_CTX
*ctx
,
536 int (*signctx
) (EVP_PKEY_CTX
*ctx
,
541 pmeth
->signctx_init
= signctx_init
;
542 pmeth
->signctx
= signctx
;
545 void EVP_PKEY_meth_set_verifyctx(EVP_PKEY_METHOD
*pmeth
,
546 int (*verifyctx_init
) (EVP_PKEY_CTX
*ctx
,
548 int (*verifyctx
) (EVP_PKEY_CTX
*ctx
,
549 const unsigned char *sig
,
553 pmeth
->verifyctx_init
= verifyctx_init
;
554 pmeth
->verifyctx
= verifyctx
;
557 void EVP_PKEY_meth_set_encrypt(EVP_PKEY_METHOD
*pmeth
,
558 int (*encrypt_init
) (EVP_PKEY_CTX
*ctx
),
559 int (*encryptfn
) (EVP_PKEY_CTX
*ctx
,
562 const unsigned char *in
,
565 pmeth
->encrypt_init
= encrypt_init
;
566 pmeth
->encrypt
= encryptfn
;
569 void EVP_PKEY_meth_set_decrypt(EVP_PKEY_METHOD
*pmeth
,
570 int (*decrypt_init
) (EVP_PKEY_CTX
*ctx
),
571 int (*decrypt
) (EVP_PKEY_CTX
*ctx
,
574 const unsigned char *in
,
577 pmeth
->decrypt_init
= decrypt_init
;
578 pmeth
->decrypt
= decrypt
;
581 void EVP_PKEY_meth_set_derive(EVP_PKEY_METHOD
*pmeth
,
582 int (*derive_init
) (EVP_PKEY_CTX
*ctx
),
583 int (*derive
) (EVP_PKEY_CTX
*ctx
,
587 pmeth
->derive_init
= derive_init
;
588 pmeth
->derive
= derive
;
591 void EVP_PKEY_meth_set_ctrl(EVP_PKEY_METHOD
*pmeth
,
592 int (*ctrl
) (EVP_PKEY_CTX
*ctx
, int type
, int p1
,
594 int (*ctrl_str
) (EVP_PKEY_CTX
*ctx
,
599 pmeth
->ctrl_str
= ctrl_str
;
602 void EVP_PKEY_meth_get_init(EVP_PKEY_METHOD
*pmeth
,
603 int (**pinit
) (EVP_PKEY_CTX
*ctx
))
605 *pinit
= pmeth
->init
;
608 void EVP_PKEY_meth_get_copy(EVP_PKEY_METHOD
*pmeth
,
609 int (**pcopy
) (EVP_PKEY_CTX
*dst
,
612 *pcopy
= pmeth
->copy
;
615 void EVP_PKEY_meth_get_cleanup(EVP_PKEY_METHOD
*pmeth
,
616 void (**pcleanup
) (EVP_PKEY_CTX
*ctx
))
618 *pcleanup
= pmeth
->cleanup
;
621 void EVP_PKEY_meth_get_paramgen(EVP_PKEY_METHOD
*pmeth
,
622 int (**pparamgen_init
) (EVP_PKEY_CTX
*ctx
),
623 int (**pparamgen
) (EVP_PKEY_CTX
*ctx
,
627 *pparamgen_init
= pmeth
->paramgen_init
;
629 *pparamgen
= pmeth
->paramgen
;
632 void EVP_PKEY_meth_get_keygen(EVP_PKEY_METHOD
*pmeth
,
633 int (**pkeygen_init
) (EVP_PKEY_CTX
*ctx
),
634 int (**pkeygen
) (EVP_PKEY_CTX
*ctx
,
638 *pkeygen_init
= pmeth
->keygen_init
;
640 *pkeygen
= pmeth
->keygen
;
643 void EVP_PKEY_meth_get_sign(EVP_PKEY_METHOD
*pmeth
,
644 int (**psign_init
) (EVP_PKEY_CTX
*ctx
),
645 int (**psign
) (EVP_PKEY_CTX
*ctx
,
646 unsigned char *sig
, size_t *siglen
,
647 const unsigned char *tbs
,
651 *psign_init
= pmeth
->sign_init
;
653 *psign
= pmeth
->sign
;
656 void EVP_PKEY_meth_get_verify(EVP_PKEY_METHOD
*pmeth
,
657 int (**pverify_init
) (EVP_PKEY_CTX
*ctx
),
658 int (**pverify
) (EVP_PKEY_CTX
*ctx
,
659 const unsigned char *sig
,
661 const unsigned char *tbs
,
665 *pverify_init
= pmeth
->verify_init
;
667 *pverify
= pmeth
->verify
;
670 void EVP_PKEY_meth_get_verify_recover(EVP_PKEY_METHOD
*pmeth
,
671 int (**pverify_recover_init
) (EVP_PKEY_CTX
673 int (**pverify_recover
) (EVP_PKEY_CTX
682 if (pverify_recover_init
)
683 *pverify_recover_init
= pmeth
->verify_recover_init
;
685 *pverify_recover
= pmeth
->verify_recover
;
688 void EVP_PKEY_meth_get_signctx(EVP_PKEY_METHOD
*pmeth
,
689 int (**psignctx_init
) (EVP_PKEY_CTX
*ctx
,
691 int (**psignctx
) (EVP_PKEY_CTX
*ctx
,
697 *psignctx_init
= pmeth
->signctx_init
;
699 *psignctx
= pmeth
->signctx
;
702 void EVP_PKEY_meth_get_verifyctx(EVP_PKEY_METHOD
*pmeth
,
703 int (**pverifyctx_init
) (EVP_PKEY_CTX
*ctx
,
705 int (**pverifyctx
) (EVP_PKEY_CTX
*ctx
,
706 const unsigned char *sig
,
711 *pverifyctx_init
= pmeth
->verifyctx_init
;
713 *pverifyctx
= pmeth
->verifyctx
;
716 void EVP_PKEY_meth_get_encrypt(EVP_PKEY_METHOD
*pmeth
,
717 int (**pencrypt_init
) (EVP_PKEY_CTX
*ctx
),
718 int (**pencryptfn
) (EVP_PKEY_CTX
*ctx
,
721 const unsigned char *in
,
725 *pencrypt_init
= pmeth
->encrypt_init
;
727 *pencryptfn
= pmeth
->encrypt
;
730 void EVP_PKEY_meth_get_decrypt(EVP_PKEY_METHOD
*pmeth
,
731 int (**pdecrypt_init
) (EVP_PKEY_CTX
*ctx
),
732 int (**pdecrypt
) (EVP_PKEY_CTX
*ctx
,
735 const unsigned char *in
,
739 *pdecrypt_init
= pmeth
->decrypt_init
;
741 *pdecrypt
= pmeth
->decrypt
;
744 void EVP_PKEY_meth_get_derive(EVP_PKEY_METHOD
*pmeth
,
745 int (**pderive_init
) (EVP_PKEY_CTX
*ctx
),
746 int (**pderive
) (EVP_PKEY_CTX
*ctx
,
751 *pderive_init
= pmeth
->derive_init
;
753 *pderive
= pmeth
->derive
;
756 void EVP_PKEY_meth_get_ctrl(EVP_PKEY_METHOD
*pmeth
,
757 int (**pctrl
) (EVP_PKEY_CTX
*ctx
, int type
, int p1
,
759 int (**pctrl_str
) (EVP_PKEY_CTX
*ctx
,
764 *pctrl
= pmeth
->ctrl
;
766 *pctrl_str
= pmeth
->ctrl_str
;