{"id":3150,"date":"2022-12-20T16:43:37","date_gmt":"2022-12-20T19:43:37","guid":{"rendered":"http:\/\/lode.uno\/linux-man\/index.php\/2022\/12\/20\/systemdcryptsetup-service-man8\/"},"modified":"2022-12-20T16:43:37","modified_gmt":"2022-12-20T19:43:37","slug":"systemdcryptsetup-service-man8","status":"publish","type":"post","link":"https:\/\/lode.uno\/linux-man\/2022\/12\/20\/systemdcryptsetup-service-man8\/","title":{"rendered":"SYSTEMD&minus;CRYPTSETUP@.SERVICE (man8)"},"content":{"rendered":"<h1 align=\"center\">SYSTEMD\u2212CRYPTSETUP@.SERVICE<\/h1>\n<p> <a href=\"#NAME\">NAME<\/a><br \/> <a href=\"#SYNOPSIS\">SYNOPSIS<\/a><br \/> <a href=\"#DESCRIPTION\">DESCRIPTION<\/a><br \/> <a href=\"#SEE ALSO\">SEE ALSO<\/a><br \/> <a href=\"#NOTES\">NOTES<\/a> <\/p>\n<hr>\n<h2>NAME <a name=\"NAME\"><\/a> <\/h2>\n<p style=\"margin-left:11%; margin-top: 1em\">systemd-cryptsetup@.service, systemd-cryptsetup \u2212 Full disk decryption logic<\/p>\n<h2>SYNOPSIS <a name=\"SYNOPSIS\"><\/a> <\/h2>\n<p style=\"margin-left:11%; margin-top: 1em\">systemd\u2212cryptsetup@.service<\/p>\n<p style=\"margin-left:11%; margin-top: 1em\">\/usr\/lib\/systemd\/systemd\u2212cryptsetup<\/p>\n<h2>DESCRIPTION <a name=\"DESCRIPTION\"><\/a> <\/h2>\n<p style=\"margin-left:11%; margin-top: 1em\">systemd\u2212cryptsetup@.service is a service responsible for setting up encrypted block devices. It is instantiated for each device that requires decryption for access.<\/p>\n<p style=\"margin-left:11%; margin-top: 1em\">systemd\u2212cryptsetup@.service will ask for hard disk passwords via the <b><font color=\"#0000FF\">password agent logic<\/font><\/b> <small><font color=\"#000000\">[1]<\/font><\/small> <font color=\"#000000\">, in order to query the user for the password using the right mechanism at boot and during runtime.<\/font><\/p>\n<p style=\"margin-left:11%; margin-top: 1em\"><font color=\"#000000\">At early boot and when the system manager configuration is reloaded, \/etc\/crypttab is translated into systemd\u2212cryptsetup@.service units by <b>systemd-cryptsetup-generator<\/b>(8).<\/font><\/p>\n<p style=\"margin-left:11%; margin-top: 1em\"><font color=\"#000000\">In order to unlock a volume a password or binary key is required. systemd\u2212cryptsetup@.service tries to acquire a suitable password or binary key via the following mechanisms, tried in order:<\/font><\/p>\n<p style=\"margin-left:17%; margin-top: 1em\"><font color=\"#000000\">1. If a key file is explicitly configured (via the third column in \/etc\/crypttab), a key read from it is used. If a PKCS#11 token is configured (using the <i>pkcs11\u2212uri=<\/i> option) the key is decrypted before use.<\/font><\/p>\n<p style=\"margin-left:17%; margin-top: 1em\"><font color=\"#000000\">2. If no key file is configured explicitly this way, a key file is automatically loaded from \/etc\/cryptsetup\u2212keys.d\/<i>volume<\/i>.key and \/run\/cryptsetup\u2212keys.d\/<i>volume<\/i>.key, if present. Here too, if a PKCS#11 token is configured, any key found this way is decrypted before use.<\/font><\/p>\n<p style=\"margin-left:17%; margin-top: 1em\"><font color=\"#000000\">3. If the <i>try\u2212empty\u2212password<\/i> option is specified it is then attempted to unlock the volume with an empty password.<\/font><\/p>\n<p style=\"margin-left:17%; margin-top: 1em\"><font color=\"#000000\">4. The kernel keyring is then checked for a suitable cached password from previous attempts.<\/font><\/p>\n<p style=\"margin-left:17%; margin-top: 1em\"><font color=\"#000000\">5. Finally, the user is queried for a password, possibly multiple times.<\/font><\/p>\n<p style=\"margin-left:11%; margin-top: 1em\"><font color=\"#000000\">If no suitable key may be acquired via any of the mechanisms describes above, volume activation fails.<\/font><\/p>\n<h2>SEE ALSO <a name=\"SEE ALSO\"><\/a> <\/h2>\n<p style=\"margin-left:11%; margin-top: 1em\"><font color=\"#000000\"><b>systemd<\/b>(1), <b>systemd-cryptsetup-generator<\/b>(8), <b>crypttab<\/b>(5), <b>cryptsetup<\/b>(8)<\/font><\/p>\n<h2>NOTES <a name=\"NOTES\"><\/a> <\/h2>\n<table width=\"100%\" border=\"0\" rules=\"none\" frame=\"void\" cellspacing=\"0\" cellpadding=\"0\">\n<tr valign=\"top\" align=\"left\">\n<td width=\"12%\"><\/td>\n<td width=\"3%\">\n<p style=\"margin-top: 1em\"><font color=\"#000000\">1.<\/font><\/p>\n<\/td>\n<td width=\"2%\"><\/td>\n<td width=\"31%\">\n<p style=\"margin-top: 1em\"><font color=\"#000000\">password agent logic<\/font><\/p>\n<\/td>\n<td width=\"52%\"> <\/td>\n<\/tr>\n<\/table>\n<p style=\"margin-left:17%;\"><font color=\"#000000\">https:\/\/systemd.io\/PASSWORD_AGENTS\/<\/font><\/p>\n<hr>\n","protected":false},"excerpt":{"rendered":"<p>  systemd-cryptsetup@.service, systemd-cryptsetup \u2212 Full disk decryption logic <\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2],"tags":[5,52,4,294],"class_list":["post-3150","post","type-post","status-publish","format-standard","hentry","category-8-administracion-del-sistema","tag-5","tag-administracion","tag-man8","tag-systemd-cryptsetup"],"gutentor_comment":0,"_links":{"self":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/3150","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/comments?post=3150"}],"version-history":[{"count":0,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/3150\/revisions"}],"wp:attachment":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/media?parent=3150"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/categories?post=3150"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/tags?post=3150"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}