diff --git a/bash-completion/p11-kit b/bash-completion/p11-kit index 00dd694c..94ebd0fa 100644 --- a/bash-completion/p11-kit +++ b/bash-completion/p11-kit @@ -10,7 +10,7 @@ _p11-kit() COMPREPLY=( $(compgen -W "$opts" -- "$cur") ) return elif [[ $cword -eq 1 ]]; then - local commands='generate-keypair export-object delete-object list-objects add-profile delete-profile list-profiles list-modules print-config extract server remote' + local commands='list-mechanisms generate-keypair export-object delete-object list-objects add-profile delete-profile list-profiles list-modules print-config extract server remote' COMPREPLY=( $(compgen -W "$commands" -- "$cur") ) fi } && diff --git a/doc/manual/p11-kit.xml b/doc/manual/p11-kit.xml index b323d1c3..bb27640f 100644 --- a/doc/manual/p11-kit.xml +++ b/doc/manual/p11-kit.xml @@ -53,6 +53,9 @@ p11-kit delete-profile ... + + p11-kit list-mechanisms ... + p11-kit print-config @@ -222,6 +225,19 @@ $ p11-kit delete-profile --profile profile pkcs11:token + + List Mechanisms + + List PKCS#11 mechanisms supported by the token. + + +$ p11-kit list-mechanisms pkcs11:token + + + This lists all available mechanimsms for a PKCS#11 token + + + Print Config diff --git a/p11-kit/Makefile.am b/p11-kit/Makefile.am index b5195bee..083b867e 100644 --- a/p11-kit/Makefile.am +++ b/p11-kit/Makefile.am @@ -270,6 +270,7 @@ p11_kit_p11_kit_SOURCES = \ p11-kit/generate-keypair.c \ p11-kit/list-objects.c \ p11-kit/list-profiles.c \ + p11-kit/list-mechanisms.c \ p11-kit/lists.c \ p11-kit/p11-kit.c \ p11-kit/print-config.c \ diff --git a/p11-kit/list-mechanisms.c b/p11-kit/list-mechanisms.c new file mode 100644 index 00000000..3f1475b0 --- /dev/null +++ b/p11-kit/list-mechanisms.c @@ -0,0 +1,303 @@ +/* + * Copyright (c) 2023, Red Hat Inc. + * + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * * Redistributions of source code must retain the above + * copyright notice, this list of conditions and the + * following disclaimer. + * * Redistributions in binary form must reproduce the + * above copyright notice, this list of conditions and + * the following disclaimer in the documentation and/or + * other materials provided with the distribution. + * * The names of contributors to this software may not be + * used to endorse or promote products derived from this + * software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT + * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS + * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE + * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, + * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, + * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS + * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED + * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, + * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF + * THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH + * DAMAGE. + * + * Author: Alexander Sosedkin + */ + +#include "config.h" + +#include "constants.h" +#include "debug.h" +#include "iter.h" +#include "message.h" +#include "pkcs11.h" +#include "print.h" +#include "tool.h" +#include "uri.h" + +#include +#include +#include + +#ifdef ENABLE_NLS +#include +#define _(x) dgettext(PACKAGE_NAME, x) +#else +#define _(x) (x) +#endif + +int +p11_kit_list_mechanisms (int argc, + char *argv[]); + +static void +print_mechanism_with_info(CK_MECHANISM_TYPE mechanism, + CK_MECHANISM_INFO info) +{ + const char *mechanism_nick = NULL; + + mechanism_nick = p11_constant_nick (p11_constant_mechanisms, mechanism); + if (mechanism_nick == NULL) + printf ("0x%lX (unknown):", mechanism); + else + printf ("%s:", mechanism_nick); + + if (info.flags & CKF_HW) + printf (" hw"); + if (info.flags & CKF_MESSAGE_ENCRYPT) + printf (" message-encrypt"); + if (info.flags & CKF_MESSAGE_DECRYPT) + printf (" message-decrypt"); + if (info.flags & CKF_MESSAGE_SIGN) + printf (" message-sign"); + if (info.flags & CKF_MESSAGE_VERIFY) + printf (" message-verify"); + if (info.flags & CKF_MULTI_MESSAGE) + printf (" multi-message"); + if (info.flags & CKF_FIND_OBJECTS) + printf (" find-objects"); + if (info.flags & CKF_ENCRYPT) + printf (" encrypt"); + if (info.flags & CKF_DECRYPT) + printf (" decrypt"); + if (info.flags & CKF_DIGEST) + printf (" digest"); + if (info.flags & CKF_SIGN) + printf (" sign"); + if (info.flags & CKF_SIGN_RECOVER) + printf (" sign-recover"); + if (info.flags & CKF_VERIFY) + printf (" verify"); + if (info.flags & CKF_SIGN_RECOVER) + printf (" verify-recover"); + if (info.flags & CKF_GENERATE) + printf (" generate"); + if (info.flags & CKF_GENERATE_KEY_PAIR) + printf (" generate-key-pair"); + if (info.flags & CKF_WRAP) + printf (" wrap"); + if (info.flags & CKF_UNWRAP) + printf (" unwrap"); + if (info.flags & CKF_DERIVE) + printf (" derive"); + if (info.flags & CKF_EXTENSION) + printf (" extension"); + + if (info.ulMaxKeySize) + printf (" key-size=%ld-%ld", info.ulMinKeySize, info.ulMaxKeySize); + printf ("\n"); +} + +static int +list_mechanisms (const char *token_str) +{ + int ret = 1; + CK_FUNCTION_LIST **modules = NULL; + CK_FUNCTION_LIST *module = NULL; + P11KitUri *uri = NULL; + P11KitIter *iter = NULL; + CK_SESSION_HANDLE session = 0; + CK_SLOT_ID slot = 0; + CK_MECHANISM_INFO mechanism_info; + CK_MECHANISM_TYPE_PTR mechanisms = NULL; + CK_MECHANISM_TYPE mechanism = CKP_INVALID_ID; + unsigned long mechanisms_count = 0; + unsigned long i; + p11_list_printer printer; + CK_RV rv; + + uri = p11_kit_uri_new (); + if (uri == NULL) { + p11_message (_("failed to allocate memory")); + goto cleanup; + } + + if (p11_kit_uri_parse (token_str, P11_KIT_URI_FOR_OBJECT_ON_TOKEN, uri) != P11_KIT_URI_OK) { + p11_message (_("failed to parse URI")); + goto cleanup; + } + + modules = p11_kit_modules_load_and_initialize (0); + if (modules == NULL) { + p11_message (_("failed to load and initialize modules")); + goto cleanup; + } + + iter = p11_kit_iter_new (uri, P11_KIT_ITER_WITH_LOGIN); + if (iter == NULL) { + p11_message (_("failed to initialize iterator")); + goto cleanup; + } + + p11_list_printer_init (&printer, stdout, 0); + + uri = p11_kit_uri_new (); + if (uri == NULL) { + p11_message (_("failed to allocate memory")); + goto cleanup; + } + + if (p11_kit_uri_parse (token_str, P11_KIT_URI_FOR_TOKEN, uri) != P11_KIT_URI_OK) { + p11_message (_("failed to parse URI")); + goto cleanup; + } + + modules = p11_kit_modules_load_and_initialize (0); + if (modules == NULL) { + p11_message (_("failed to load and initialize modules")); + goto cleanup; + } + + iter = p11_kit_iter_new (uri, P11_KIT_ITER_WITH_LOGIN | P11_KIT_ITER_WITH_TOKENS | P11_KIT_ITER_WITHOUT_OBJECTS); + if (iter == NULL) { + p11_message (_("failed to initialize iterator")); + goto cleanup; + } + + p11_list_printer_init (&printer, stdout, 0); + p11_kit_iter_begin (iter, modules); + while ((rv = p11_kit_iter_next (iter)) == CKR_OK) { + module = p11_kit_iter_get_module (iter); + if (module == NULL) { + p11_message (_("failed to obtain module")); + goto cleanup; + } + + slot = p11_kit_iter_get_slot (iter); + if (slot == 0) { + p11_message (_("failed to obtain slot")); + goto cleanup; + } + p11_list_printer_start_section (&printer, "Token", "#%lu", slot); + + rv = module->C_GetMechanismList (slot, NULL, &mechanisms_count); + if (rv != CKR_OK) { + p11_message (_("querying amount of mechanisms failed: %s"), p11_kit_strerror (rv)); + goto cleanup; + } + + mechanisms = malloc(sizeof(CK_MECHANISM_TYPE) * mechanisms_count); + if (mechanisms == NULL) { + p11_message (_("failed to allocate memory")); + goto cleanup; + } + + rv = module->C_GetMechanismList (slot, mechanisms, &mechanisms_count); + if (rv != CKR_OK) { + p11_message (_("querying mechanisms failed: %s"), p11_kit_strerror (rv)); + goto cleanup; + } + + for (i = 0; i < mechanisms_count; i++) { + mechanism = mechanisms[i]; + + rv = module->C_GetMechanismInfo (slot, mechanism, &mechanism_info); + if (rv != CKR_OK) { + p11_message (_("querying mechanism info failed: %s"), p11_kit_strerror (rv)); + goto cleanup; + } + + print_mechanism_with_info(mechanism, mechanism_info); + } + p11_list_printer_end_section (&printer); + } + assert (rv == CKR_CANCEL); + + ret = 0; + +cleanup: + if (session) + module->C_CloseSession (session); + if (mechanisms) + free(mechanisms); + p11_kit_iter_free (iter); + p11_kit_uri_free (uri); + if (modules != NULL) + p11_kit_modules_finalize_and_release (modules); + + return ret; +} + +int +p11_kit_list_mechanisms (int argc, + char *argv[]) +{ + int opt; + + enum { + opt_verbose = 'v', + opt_quiet = 'q', + opt_help = 'h', + }; + + struct option options[] = { + { "verbose", no_argument, NULL, opt_verbose }, + { "quiet", no_argument, NULL, opt_quiet }, + { "help", no_argument, NULL, opt_help }, + { 0 }, + }; + + p11_tool_desc usages[] = { + { 0, "usage: p11-kit list-mechanisms pkcs11:token" }, + { 0 }, + }; + + while ((opt = p11_tool_getopt (argc, argv, options)) != -1) { + switch (opt) { + case opt_verbose: + p11_kit_be_loud (); + break; + case opt_quiet: + p11_kit_be_quiet (); + break; + case opt_help: + p11_tool_usage (usages, options); + return 0; + case '?': + return 2; + default: + assert_not_reached (); + break; + } + } + + argc -= optind; + argv += optind; + + if (argc != 1) { + p11_tool_usage (usages, options); + return 2; + } + + return list_mechanisms (*argv); +} diff --git a/p11-kit/meson.build b/p11-kit/meson.build index 79190cc9..afc7a657 100644 --- a/p11-kit/meson.build +++ b/p11-kit/meson.build @@ -217,6 +217,7 @@ p11_kit_sources = [ 'generate-keypair.c', 'list-objects.c', 'list-profiles.c', + 'list-mechanisms.c', 'lists.c', 'p11-kit.c', 'print-config.c' diff --git a/p11-kit/p11-kit.c b/p11-kit/p11-kit.c index 359a8c0b..04a55f1e 100644 --- a/p11-kit/p11-kit.c +++ b/p11-kit/p11-kit.c @@ -83,6 +83,9 @@ int p11_kit_add_profile (int argc, int p11_kit_delete_profile (int argc, char *argv[]); +int p11_kit_list_mechanisms (int argc, + char *argv[]); + int p11_kit_print_config (int argc, char *argv[]); @@ -102,6 +105,7 @@ static const p11_tool_command commands[] = { { "add-profile", p11_kit_add_profile, N_("Add PKCS#11 profile to the token") }, { "delete-profile", p11_kit_delete_profile, N_("Delete PKCS#11 profile from the token") }, { "print-config", p11_kit_print_config, N_("Print merged configuration") }, + { "list-mechanisms", p11_kit_list_mechanisms, N_("List supported mechanisms") }, { "remote", p11_kit_external, N_("Run a specific PKCS#11 module remotely") }, { "server", p11_kit_external, N_("Run a server process that exposes PKCS#11 module remotely") }, { P11_TOOL_FALLBACK, p11_kit_external, NULL }, diff --git a/po/POTFILES.in b/po/POTFILES.in index c902f33a..11333ac6 100644 --- a/po/POTFILES.in +++ b/po/POTFILES.in @@ -9,6 +9,7 @@ p11-kit/filter.c p11-kit/generate-keypair.c p11-kit/list-objects.c p11-kit/list-profiles.c +p11-kit/list-mechanisms.c p11-kit/lists.c p11-kit/messages.c p11-kit/modules.c