CINXE.COM
Home 路 Wiki 路 cryptsetup / cryptsetup 路 GitLab
<!DOCTYPE html> <html class="gl-light ui-neutral with-top-bar with-header " lang="en"> <head prefix="og: http://ogp.me/ns#"> <meta charset="utf-8"> <meta content="IE=edge" http-equiv="X-UA-Compatible"> <meta content="width=device-width, initial-scale=1" name="viewport"> <title>Home 路 Wiki 路 cryptsetup / cryptsetup 路 GitLab</title> <script nonce="ym/ryTtRs2HtduQdY1nknw=="> //<![CDATA[ window.gon={};gon.math_rendering_limits_enabled=true;gon.features={"asyncSidebarCounts":true,"preserveMarkdown":false,"glqlIntegration":false}; //]]> </script> <link rel="stylesheet" href="/assets/application-4c6e49fab5a53e99aee38905211cc7400e0d9ec93c8c8aee1eca2f300abf5e5f.css" /> <link rel="stylesheet" href="/assets/page_bundles/wiki-ce68fb8e9e40620ace3bfcc9f4e65e90ca21bd6527f42095824292fa1635f117.css" /><link rel="stylesheet" href="/assets/page_bundles/commit_description-1e2cba4dda3c7b30dd84924809020c569f1308dea51520fe1dd5d4ce31403195.css" /><link rel="stylesheet" href="/assets/page_bundles/work_items-cbc6a2e1633c4e847a617e35cc4833b85b80816db688d3d6dd3cd31d4251bc53.css" /><link rel="stylesheet" href="/assets/page_bundles/notes_shared-7e727ab1e91b421915feadeb04a1b9d57213cb1b2f8f56f4d894b34d6b42e9b3.css" /> <link rel="stylesheet" href="/assets/application_utilities-73b9a1c83703ccfccd0e1e418c7d8dc606fcac533fa38b9fa86792f098db0f9a.css" /> <link rel="stylesheet" href="/assets/tailwind-62f05085be4df1a52a349ca7e0eb7cb4d2ada0a7018db2b265da6b1e3821d88b.css" /> <link rel="stylesheet" href="/assets/fonts-fae5d3f79948bd85f18b6513a025f863b19636e85b09a1492907eb4b1bb0557b.css" /> <link rel="stylesheet" href="/assets/highlight/themes/white-5ffbb706faebead681b01c8b52e92c6c0d35ad5b1c11d39012c90bcaf7892ca8.css" /> <script src="/assets/webpack/runtime.da2c30a3.bundle.js" defer="defer" nonce="ym/ryTtRs2HtduQdY1nknw=="></script> <script src="/assets/webpack/main.bb0f6b51.chunk.js" defer="defer" nonce="ym/ryTtRs2HtduQdY1nknw=="></script> <script src="/assets/webpack/tracker.49b3b0a2.chunk.js" defer="defer" nonce="ym/ryTtRs2HtduQdY1nknw=="></script> <script src="/assets/webpack/analytics.4ed221db.chunk.js" defer="defer" nonce="ym/ryTtRs2HtduQdY1nknw=="></script> <script nonce="ym/ryTtRs2HtduQdY1nknw=="> //<![CDATA[ window.snowplowOptions = {"namespace":"gl","hostname":"snowplow.trx.gitlab.net","cookieDomain":".gitlab.com","appId":"gitlab","formTracking":true,"linkClickTracking":true} gl = window.gl || {}; gl.snowplowStandardContext = {"schema":"iglu:com.gitlab/gitlab_standard/jsonschema/1-1-1","data":{"environment":"production","source":"gitlab-rails","correlation_id":"01JDCYKY37VZVE215251FC96FZ","plan":"opensource","extra":{},"user_id":null,"global_user_id":null,"is_gitlab_team_member":null,"namespace_id":132001,"project_id":195655,"feature_enabled_by_namespace_ids":null,"realm":"saas","instance_id":"ea8bf810-1d6f-4a6a-b4fd-93e8cbd8b57f","host_name":"gitlab-webservice-web-6586dccb65-hlxl2","instance_version":"17.7.0","context_generated_at":"2024-11-23T16:45:26.186Z"}} gl.snowplowPseudonymizedPageUrl = "https://gitlab.com/namespace132001/project195655/-/wikis/home"; gl.maskedDefaultReferrerUrl = null; gl.ga4MeasurementId = 'G-ENFH3X7M5Y'; //]]> </script> <link rel="preload" href="/assets/application_utilities-73b9a1c83703ccfccd0e1e418c7d8dc606fcac533fa38b9fa86792f098db0f9a.css" as="style" type="text/css" nonce="eiGMSTkuzPfMHB6H8BsGlw=="> <link rel="preload" href="/assets/application-4c6e49fab5a53e99aee38905211cc7400e0d9ec93c8c8aee1eca2f300abf5e5f.css" as="style" type="text/css" nonce="eiGMSTkuzPfMHB6H8BsGlw=="> <link rel="preload" href="/assets/highlight/themes/white-5ffbb706faebead681b01c8b52e92c6c0d35ad5b1c11d39012c90bcaf7892ca8.css" as="style" type="text/css" nonce="eiGMSTkuzPfMHB6H8BsGlw=="> <link crossorigin="" href="https://snowplow.trx.gitlab.net" rel="preconnect"> <link as="font" crossorigin="" href="/assets/gitlab-sans/GitLabSans-1e0a5107ea3bbd4be93e8ad2c503467e43166cd37e4293570b490e0812ede98b.woff2" rel="preload"> <link as="font" crossorigin="" href="/assets/gitlab-sans/GitLabSans-Italic-38eaf1a569a54ab28c58b92a4a8de3afb96b6ebc250cf372003a7b38151848cc.woff2" rel="preload"> <link as="font" crossorigin="" href="/assets/gitlab-mono/GitLabMono-08d2c5e8ff8fd3d2d6ec55bc7713380f8981c35f9d2df14e12b835464d6e8f23.woff2" rel="preload"> <link as="font" crossorigin="" href="/assets/gitlab-mono/GitLabMono-Italic-38e58d8df29485a20c550da1d0111e2c2169f6dcbcf894f2cd3afbdd97bcc588.woff2" rel="preload"> <link rel="preload" href="/assets/fonts-fae5d3f79948bd85f18b6513a025f863b19636e85b09a1492907eb4b1bb0557b.css" as="style" type="text/css" nonce="eiGMSTkuzPfMHB6H8BsGlw=="> <script src="/assets/webpack/sentry.d29e47f8.chunk.js" defer="defer" nonce="ym/ryTtRs2HtduQdY1nknw=="></script> <script src="/assets/webpack/10.c71e1490.chunk.js" defer="defer" nonce="ym/ryTtRs2HtduQdY1nknw=="></script> <script src="/assets/webpack/12.b315250f.chunk.js" defer="defer" nonce="ym/ryTtRs2HtduQdY1nknw=="></script> <script src="/assets/webpack/14.d13e2c22.chunk.js" defer="defer" nonce="ym/ryTtRs2HtduQdY1nknw=="></script> <script src="/assets/webpack/commons-pages.groups.analytics.dashboards-pages.groups.harbor.repositories-pages.groups.iteration_ca-b07ae190.c914cf7a.chunk.js" defer="defer" nonce="ym/ryTtRs2HtduQdY1nknw=="></script> <script src="/assets/webpack/commons-pages.groups.new-pages.import.gitlab_projects.new-pages.import.manifest.new-pages.projects.n-44c6c18e.9e8d82af.chunk.js" defer="defer" nonce="ym/ryTtRs2HtduQdY1nknw=="></script> <script src="/assets/webpack/commons-pages.search.show-super_sidebar.a049287a.chunk.js" defer="defer" nonce="ym/ryTtRs2HtduQdY1nknw=="></script> <script src="/assets/webpack/super_sidebar.63fd1826.chunk.js" defer="defer" nonce="ym/ryTtRs2HtduQdY1nknw=="></script> <script src="/assets/webpack/commons-pages.projects-pages.projects.activity-pages.projects.alert_management.details-pages.project-bce54798.ba5aa449.chunk.js" defer="defer" nonce="ym/ryTtRs2HtduQdY1nknw=="></script> <script src="/assets/webpack/4.d8c151e7.chunk.js" defer="defer" nonce="ym/ryTtRs2HtduQdY1nknw=="></script> <script src="/assets/webpack/5.565510f5.chunk.js" defer="defer" nonce="ym/ryTtRs2HtduQdY1nknw=="></script> <script src="/assets/webpack/6.ab38f9cc.chunk.js" defer="defer" nonce="ym/ryTtRs2HtduQdY1nknw=="></script> <script src="/assets/webpack/commons-pages.admin.abuse_reports.show-pages.admin.topics.edit-pages.admin.topics.new-pages.groups.c-1a3fb436.1c21aa9f.chunk.js" defer="defer" nonce="ym/ryTtRs2HtduQdY1nknw=="></script> <script src="/assets/webpack/commons-pages.admin.abuse_reports.show-pages.admin.topics.edit-pages.admin.topics.new-pages.groups.c-d9674679.b0e1bbb8.chunk.js" defer="defer" nonce="ym/ryTtRs2HtduQdY1nknw=="></script> <script src="/assets/webpack/commons-pages.groups.wikis-pages.groups.wikis.diff-pages.groups.wikis.git_access-pages.groups.wikis.-0c2b43e7.c1fc0fa8.chunk.js" defer="defer" nonce="ym/ryTtRs2HtduQdY1nknw=="></script> <script src="/assets/webpack/pages.projects.wikis.show.7705f9de.chunk.js" defer="defer" nonce="ym/ryTtRs2HtduQdY1nknw=="></script> <meta content="object" property="og:type"> <meta content="GitLab" property="og:site_name"> <meta content="Home 路 Wiki 路 cryptsetup / cryptsetup 路 GitLab" property="og:title"> <meta content="Cryptsetup and LUKS - open-source disk encryption" property="og:description"> <meta content="https://gitlab.com/assets/twitter_card-570ddb06edf56a2312253c5872489847a0f385112ddbcd71ccfa1570febab5d2.jpg" property="og:image"> <meta content="64" property="og:image:width"> <meta content="64" property="og:image:height"> <meta content="https://gitlab.com/cryptsetup/cryptsetup/-/wikis/home" property="og:url"> <meta content="summary" property="twitter:card"> <meta content="Home 路 Wiki 路 cryptsetup / cryptsetup 路 GitLab" property="twitter:title"> <meta content="Cryptsetup and LUKS - open-source disk encryption" property="twitter:description"> <meta content="https://gitlab.com/assets/twitter_card-570ddb06edf56a2312253c5872489847a0f385112ddbcd71ccfa1570febab5d2.jpg" property="twitter:image"> <meta name="csrf-param" content="authenticity_token" /> <meta name="csrf-token" content="FJ9aO1NCi5VcI5kSk39EXiMtLw_sr3ZVY4oxtfZuZacixKEwd56X4M8cQFmnH8LW46avXvFHExtE4HcqfKZJYg" /> <meta name="csp-nonce" content="ym/ryTtRs2HtduQdY1nknw==" /> <meta name="action-cable-url" content="/-/cable" /> <link href="/-/manifest.json" rel="manifest"> <link rel="icon" type="image/png" href="/assets/favicon-72a2cad5025aa931d6ea56c3201d1f18e68a8cd39788c7c80d5b2b82aa5143ef.png" id="favicon" data-original-href="/assets/favicon-72a2cad5025aa931d6ea56c3201d1f18e68a8cd39788c7c80d5b2b82aa5143ef.png" /> <link rel="apple-touch-icon" type="image/x-icon" href="/assets/apple-touch-icon-b049d4bc0dd9626f31db825d61880737befc7835982586d015bded10b4435460.png" /> <link href="/search/opensearch.xml" rel="search" title="Search GitLab" type="application/opensearchdescription+xml"> <meta content="Cryptsetup and LUKS - open-source disk encryption" name="description"> <meta content="#ececef" name="theme-color"> </head> <body class="tab-width-8 gl-browser-ie gl-platform-windows" data-find-file="/cryptsetup/cryptsetup/-/find_file/main" data-group="cryptsetup" data-group-full-path="cryptsetup" data-namespace-id="132001" data-page="projects:wikis:show" data-page-type-id="home" data-project="cryptsetup" data-project-full-path="cryptsetup/cryptsetup" data-project-id="195655"> <script nonce="ym/ryTtRs2HtduQdY1nknw=="> //<![CDATA[ gl = window.gl || {}; gl.GfmAutoComplete = gl.GfmAutoComplete || {}; gl.GfmAutoComplete.dataSources = {"epics":"/cryptsetup/cryptsetup/-/autocomplete_sources/epics","iterations":"/cryptsetup/cryptsetup/-/autocomplete_sources/iterations","vulnerabilities":"/cryptsetup/cryptsetup/-/autocomplete_sources/vulnerabilities","members":"/cryptsetup/cryptsetup/-/autocomplete_sources/members?type=Wiki\u0026type_id=home","issues":"/cryptsetup/cryptsetup/-/autocomplete_sources/issues","mergeRequests":"/cryptsetup/cryptsetup/-/autocomplete_sources/merge_requests","labels":"/cryptsetup/cryptsetup/-/autocomplete_sources/labels?type=Wiki\u0026type_id=home","milestones":"/cryptsetup/cryptsetup/-/autocomplete_sources/milestones","commands":"/cryptsetup/cryptsetup/-/autocomplete_sources/commands?type=Wiki\u0026type_id=home","snippets":"/cryptsetup/cryptsetup/-/autocomplete_sources/snippets","contacts":"/cryptsetup/cryptsetup/-/autocomplete_sources/contacts?type=Wiki\u0026type_id=home","wikis":"/cryptsetup/cryptsetup/-/autocomplete_sources/wikis"}; //]]> </script> <script nonce="ym/ryTtRs2HtduQdY1nknw=="> //<![CDATA[ gl = window.gl || {}; gl.client = {"isIe":true,"isWindows":true}; //]]> </script> <header class="header-logged-out" data-testid="navbar"> <a class="gl-sr-only gl-accessibility" href="#content-body">Skip to content</a> <div class="container-fluid"> <nav aria-label="Explore GitLab" class="header-logged-out-nav gl-flex gl-gap-3 gl-justify-between"> <div class="gl-flex gl-items-center gl-gap-1"> <span class="gl-sr-only">GitLab</span> <a title="Homepage" id="logo" class="header-logged-out-logo has-tooltip" aria-label="Homepage" data-track-label="main_navigation" data-track-action="click_gitlab_logo_link" data-track-property="navigation_top" href="/"><svg aria-hidden="true" role="img" class="tanuki-logo" width="25" height="24" viewBox="0 0 25 24" fill="none" xmlns="http://www.w3.org/2000/svg"> <path class="tanuki-shape tanuki" d="m24.507 9.5-.034-.09L21.082.562a.896.896 0 0 0-1.694.091l-2.29 7.01H7.825L5.535.653a.898.898 0 0 0-1.694-.09L.451 9.411.416 9.5a6.297 6.297 0 0 0 2.09 7.278l.012.01.03.022 5.16 3.867 2.56 1.935 1.554 1.176a1.051 1.051 0 0 0 1.268 0l1.555-1.176 2.56-1.935 5.197-3.89.014-.01A6.297 6.297 0 0 0 24.507 9.5Z" fill="#E24329"/> <path class="tanuki-shape right-cheek" d="m24.507 9.5-.034-.09a11.44 11.44 0 0 0-4.56 2.051l-7.447 5.632 4.742 3.584 5.197-3.89.014-.01A6.297 6.297 0 0 0 24.507 9.5Z" fill="#FC6D26"/> <path class="tanuki-shape chin" d="m7.707 20.677 2.56 1.935 1.555 1.176a1.051 1.051 0 0 0 1.268 0l1.555-1.176 2.56-1.935-4.743-3.584-4.755 3.584Z" fill="#FCA326"/> <path class="tanuki-shape left-cheek" d="M5.01 11.461a11.43 11.43 0 0 0-4.56-2.05L.416 9.5a6.297 6.297 0 0 0 2.09 7.278l.012.01.03.022 5.16 3.867 4.745-3.584-7.444-5.632Z" fill="#FC6D26"/> </svg> </a></div> <ul class="gl-list-none gl-p-0 gl-m-0 gl-flex gl-gap-3 gl-items-center gl-grow"> <li class="header-logged-out-nav-item header-logged-out-dropdown md:gl-hidden"> <button class="header-logged-out-toggle" data-toggle="dropdown" type="button"> <span class="gl-sr-only"> Menu </span> <svg class="s16" data-testid="hamburger-icon"><use href="/assets/icons-8791a66659d025e0a4c801978c79a1fbd82db1d27d85f044a35728ea7cf0ae80.svg#hamburger"></use></svg> </button> <div class="dropdown-menu"> <ul> <li> <a href="https://about.gitlab.com/why-gitlab">Why GitLab </a></li> <li> <a href="https://about.gitlab.com/pricing">Pricing </a></li> <li> <a href="https://about.gitlab.com/sales">Contact Sales </a></li> <li> <a href="/explore">Explore</a> </li> </ul> </div> </li> <li class="header-logged-out-nav-item gl-hidden md:gl-inline-block"> <a href="https://about.gitlab.com/why-gitlab">Why GitLab </a></li> <li class="header-logged-out-nav-item gl-hidden md:gl-inline-block"> <a href="https://about.gitlab.com/pricing">Pricing </a></li> <li class="header-logged-out-nav-item gl-hidden gl-inline-block"> <a href="https://about.gitlab.com/sales">Contact Sales </a></li> <li class="header-logged-out-nav-item gl-hidden md:gl-inline-block"> <a class="" href="/explore">Explore</a> </li> </ul> <ul class="gl-list-none gl-p-0 gl-m-0 gl-flex gl-gap-3 gl-items-center gl-justify-end"> <li class="header-logged-out-nav-item"> <a href="/users/sign_in?redirect_to_referer=yes">Sign in</a> </li> <li class="header-logged-out-nav-item"> <a class="gl-button btn btn-md btn-confirm " href="/users/sign_up"><span class="gl-button-text"> Get free trial </span> </a></li> </ul> </nav> </div> </header> <div class="layout-page page-gutter wiki-sidebar right-sidebar-expanded page-with-super-sidebar"> <aside class="js-super-sidebar super-sidebar super-sidebar-loading" data-command-palette="{"project_files_url":"/cryptsetup/cryptsetup/-/files/main?format=json","project_blob_url":"/cryptsetup/cryptsetup/-/blob/main"}" data-force-desktop-expanded-sidebar="" data-is-saas="true" data-root-path="/" data-sidebar="{"whats_new_most_recent_release_items_count":3,"whats_new_version_digest":"9020798cd628cb28f6f12ce4e3a03126dcfed925f69da6beaee7457ed775d76b","is_logged_in":false,"context_switcher_links":[{"title":"Explore","link":"/explore","icon":"compass"}],"current_menu_items":[{"id":"project_overview","title":"cryptsetup","entity_id":195655,"link":"/cryptsetup/cryptsetup","link_classes":"shortcuts-project","is_active":false},{"id":"manage_menu","title":"Manage","icon":"users","avatar_shape":"rect","link":"/cryptsetup/cryptsetup/activity","is_active":false,"items":[{"id":"activity","title":"Activity","link":"/cryptsetup/cryptsetup/activity","link_classes":"shortcuts-project-activity","is_active":false},{"id":"members","title":"Members","link":"/cryptsetup/cryptsetup/-/project_members","is_active":false},{"id":"labels","title":"Labels","link":"/cryptsetup/cryptsetup/-/labels","is_active":false}],"separated":false},{"id":"plan_menu","title":"Plan","icon":"planning","avatar_shape":"rect","link":"/cryptsetup/cryptsetup/-/issues","is_active":true,"items":[{"id":"project_issue_list","title":"Issues","link":"/cryptsetup/cryptsetup/-/issues","pill_count_field":"openIssuesCount","link_classes":"shortcuts-issues has-sub-items","is_active":false},{"id":"boards","title":"Issue boards","link":"/cryptsetup/cryptsetup/-/boards","link_classes":"shortcuts-issue-boards","is_active":false},{"id":"milestones","title":"Milestones","link":"/cryptsetup/cryptsetup/-/milestones","is_active":false},{"id":"iterations","title":"Iterations","link":"/cryptsetup/cryptsetup/-/cadences","is_active":false},{"id":"project_wiki","title":"Wiki","link":"/cryptsetup/cryptsetup/-/wikis/home","link_classes":"shortcuts-wiki","is_active":true},{"id":"requirements","title":"Requirements","link":"/cryptsetup/cryptsetup/-/requirements_management/requirements","is_active":false}],"separated":false},{"id":"code_menu","title":"Code","icon":"code","avatar_shape":"rect","link":"/cryptsetup/cryptsetup/-/merge_requests","is_active":false,"items":[{"id":"project_merge_request_list","title":"Merge requests","link":"/cryptsetup/cryptsetup/-/merge_requests","pill_count_field":"openMergeRequestsCount","link_classes":"shortcuts-merge_requests","is_active":false},{"id":"files","title":"Repository","link":"/cryptsetup/cryptsetup/-/tree/main","link_classes":"shortcuts-tree","is_active":false},{"id":"branches","title":"Branches","link":"/cryptsetup/cryptsetup/-/branches","is_active":false},{"id":"commits","title":"Commits","link":"/cryptsetup/cryptsetup/-/commits/main?ref_type=heads","link_classes":"shortcuts-commits","is_active":false},{"id":"tags","title":"Tags","link":"/cryptsetup/cryptsetup/-/tags","is_active":false},{"id":"graphs","title":"Repository graph","link":"/cryptsetup/cryptsetup/-/network/main?ref_type=heads","link_classes":"shortcuts-network","is_active":false},{"id":"compare","title":"Compare revisions","link":"/cryptsetup/cryptsetup/-/compare?from=main\u0026to=main","is_active":false},{"id":"file_locks","title":"Locked files","link":"/cryptsetup/cryptsetup/path_locks","is_active":false}],"separated":false},{"id":"deploy_menu","title":"Deploy","icon":"deployments","avatar_shape":"rect","link":"/cryptsetup/cryptsetup/-/releases","is_active":false,"items":[{"id":"releases","title":"Releases","link":"/cryptsetup/cryptsetup/-/releases","link_classes":"shortcuts-deployments-releases","is_active":false},{"id":"model_registry","title":"Model registry","link":"/cryptsetup/cryptsetup/-/ml/models","is_active":false}],"separated":false},{"id":"monitor_menu","title":"Monitor","icon":"monitor","avatar_shape":"rect","link":"/cryptsetup/cryptsetup/-/incidents","is_active":false,"items":[{"id":"incidents","title":"Incidents","link":"/cryptsetup/cryptsetup/-/incidents","is_active":false}],"separated":false},{"id":"analyze_menu","title":"Analyze","icon":"chart","avatar_shape":"rect","link":"/cryptsetup/cryptsetup/-/value_stream_analytics","is_active":false,"items":[{"id":"cycle_analytics","title":"Value stream analytics","link":"/cryptsetup/cryptsetup/-/value_stream_analytics","link_classes":"shortcuts-project-cycle-analytics","is_active":false},{"id":"contributors","title":"Contributor analytics","link":"/cryptsetup/cryptsetup/-/graphs/main?ref_type=heads","is_active":false},{"id":"repository_analytics","title":"Repository analytics","link":"/cryptsetup/cryptsetup/-/graphs/main/charts","link_classes":"shortcuts-repository-charts","is_active":false},{"id":"code_review","title":"Code review analytics","link":"/cryptsetup/cryptsetup/-/analytics/code_reviews","is_active":false},{"id":"issues","title":"Issue analytics","link":"/cryptsetup/cryptsetup/-/analytics/issues_analytics","is_active":false},{"id":"insights","title":"Insights","link":"/cryptsetup/cryptsetup/insights/","link_classes":"shortcuts-project-insights","is_active":false},{"id":"model_experiments","title":"Model experiments","link":"/cryptsetup/cryptsetup/-/ml/experiments","is_active":false}],"separated":false}],"current_context_header":"Project","support_path":"https://about.gitlab.com/get-help/","docs_path":"/help/docs","display_whats_new":true,"show_version_check":null,"search":{"search_path":"/search","issues_path":"/dashboard/issues","mr_path":"/dashboard/merge_requests","autocomplete_path":"/search/autocomplete","settings_path":"/search/settings","search_context":{"group":{"id":132001,"name":"cryptsetup","full_name":"cryptsetup"},"group_metadata":{"issues_path":"/groups/cryptsetup/-/issues","mr_path":"/groups/cryptsetup/-/merge_requests"},"project":{"id":195655,"name":"cryptsetup"},"project_metadata":{"mr_path":"/cryptsetup/cryptsetup/-/merge_requests","issues_path":"/cryptsetup/cryptsetup/-/issues"},"code_search":false,"scope":"wiki_blobs","for_snippets":null}},"panel_type":"project","shortcut_links":[{"title":"Snippets","href":"/explore/snippets","css_class":"dashboard-shortcuts-snippets"},{"title":"Groups","href":"/explore/groups","css_class":"dashboard-shortcuts-groups"},{"title":"Projects","href":"/explore/projects/starred","css_class":"dashboard-shortcuts-projects"}],"terms":"/-/users/terms"}"></aside> <div class="content-wrapper"> <div class="broadcast-wrapper"> </div> <div class="alert-wrapper alert-wrapper-top-space gl-flex gl-flex-col gl-gap-3 container-fluid container-limited"> <div class="gl-alert gl-alert-danger gl-alert-not-dismissible" role="alert"> <div class="gl-alert-icon-container"> <svg class="s16 gl-alert-icon gl-alert-icon-no-title" data-testid="error-icon"><use href="/assets/icons-8791a66659d025e0a4c801978c79a1fbd82db1d27d85f044a35728ea7cf0ae80.svg#error"></use></svg> </div> <div class="gl-alert-content" role="alert"> <div class="gl-alert-body"> GitLab may not work properly, because you are using an outdated web browser. <br> Please install a <a target="_blank" rel="noopener noreferrer" href="/help/install/requirements.md#supported-web-browsers">supported web browser</a> for a better experience. </div> </div> </div> </div> <div class="top-bar-fixed container-fluid" data-testid="top-bar"> <div class="top-bar-container gl-flex gl-items-center gl-gap-2"> <div class="gl-grow gl-basis-0 gl-flex gl-items-center gl-justify-start"> <button class="gl-button btn btn-icon btn-md btn-default btn-default-tertiary js-super-sidebar-toggle-expand super-sidebar-toggle -gl-ml-3" aria-controls="super-sidebar" aria-expanded="false" aria-label="Primary navigation sidebar" type="button"><svg class="s16 gl-icon gl-button-icon " data-testid="sidebar-icon"><use href="/assets/icons-8791a66659d025e0a4c801978c79a1fbd82db1d27d85f044a35728ea7cf0ae80.svg#sidebar"></use></svg> </button> <script type="application/ld+json"> {"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"cryptsetup","item":"https://gitlab.com/cryptsetup"},{"@type":"ListItem","position":2,"name":"cryptsetup","item":"https://gitlab.com/cryptsetup/cryptsetup"},{"@type":"ListItem","position":3,"name":"Wiki","item":"https://gitlab.com/cryptsetup/cryptsetup/-/wikis/home"},{"@type":"ListItem","position":4,"name":"Home","item":"https://gitlab.com/cryptsetup/cryptsetup/-/wikis/home"}]} </script> <div data-testid="breadcrumb-links" id="js-vue-page-breadcrumbs-wrapper"> <div data-breadcrumbs-json="[{"text":"cryptsetup","href":"/cryptsetup","avatarPath":"/uploads/-/system/group/avatar/132001/lock.png"},{"text":"cryptsetup","href":"/cryptsetup/cryptsetup","avatarPath":null},{"text":"Wiki","href":"/cryptsetup/cryptsetup/-/wikis/home","avatarPath":null},{"text":"Home","href":"/cryptsetup/cryptsetup/-/wikis/home","avatarPath":null}]" id="js-vue-page-breadcrumbs"></div> <div id="js-injected-page-breadcrumbs"></div> </div> </div> <div class="gl-flex-none gl-flex gl-items-center gl-justify-center"> <div id="js-advanced-search-modal"></div> </div> <div class="gl-grow gl-basis-0 gl-flex gl-items-center gl-justify-end"> <div id="js-work-item-feedback"></div> </div> </div> </div> <div class="container-fluid container-limited limit-container-width project-highlight-puc"> <main class="content" id="content-body" itemscope itemtype="http://schema.org/SoftwareSourceCode"> <div class="flash-container flash-container-page sticky" data-testid="flash-container"> <div id="js-global-alerts"></div> </div> <div data-author-url="https://gitlab.com/mbroz" data-clone-http-url="https://gitlab.com/cryptsetup/cryptsetup.wiki.git" data-clone-ssh-url="git@gitlab.com:cryptsetup/cryptsetup.wiki.git" data-content-api="/api/v4/projects/195655/wikis/home?version=4b6a217a5ca0ee0edef6af753b66a8d4e0722550" data-edit-button-url="/cryptsetup/cryptsetup/-/wikis/home/edit" data-format-options="{"Markdown":"markdown","RDoc":"rdoc","AsciiDoc":"asciidoc","Org":"org"}" data-history-url="/cryptsetup/cryptsetup/-/wikis/home/history" data-is-page-historical="false" data-is-page-template="false" data-last-version="#<Commit:0x00007b15882e1cd8>" data-new-url="/cryptsetup/cryptsetup/-/wikis/new" data-page-heading="Home" data-page-info="{"last_commit_sha":"4b6a217a5ca0ee0edef6af753b66a8d4e0722550","persisted":true,"title":"home","content":"\n\nWhat the ...?\n=============\n**Cryptsetup** is an open-source utility used to conveniently set up disk encryption based\non the [dm-crypt](https://gitlab.com/cryptsetup/cryptsetup/wikis/DMCrypt) kernel module.\n\nThese formats are supported:\n * **plain** volumes,\n * **LUKS** volumes,\n * **loop-AES**,\n * **TrueCrypt** (including **VeraCrypt** extension),\n * **BitLocker**, and\n * **FileVault2**.\n\nThe project also includes a **veritysetup** utility used to conveniently setup\n[dm-verity](https://gitlab.com/cryptsetup/cryptsetup/wikis/DMVerity)\nblock integrity checking kernel module and **integritysetup** to setup\n[dm-integrity](https://gitlab.com/cryptsetup/cryptsetup/wikis/DMIntegrity)\nblock integrity kernel module.\n\nLUKS Design\n-----------\n**LUKS** is the standard for Linux disk encryption. By providing a standardized on-disk format,\nit not only facilitate compatibility among distributions, but also enables secure management\nof multiple user passwords. LUKS stores all necessary setup information in the partition header,\nwhich enables users to transport or migrate data seamlessly.\n\n### Specification and documentation\n * The latest version of the\n [LUKS2 format specification](https://gitlab.com/cryptsetup/LUKS2-docs).\n * The latest version of the\n [LUKS1 format specification](https://www.kernel.org/pub/linux/utils/cryptsetup/LUKS_docs/on-disk-format.pdf).\n * [Project home page](https://gitlab.com/cryptsetup/cryptsetup/).\n * [Frequently asked questions (FAQ)](https://gitlab.com/cryptsetup/cryptsetup/wikis/FrequentlyAskedQuestions)\n\nDownload\n--------\nRelease notes and tarballs are available at\n[kernel.org](https://www.kernel.org/pub/linux/utils/cryptsetup/).\n\n**The latest stable cryptsetup release version is 2.7.5**\n * [cryptsetup-2.7.5.tar.xz](https://www.kernel.org/pub/linux/utils/cryptsetup/v2.7/cryptsetup-2.7.5.tar.xz)\n * Signature [cryptsetup-2.7.5.tar.sign](https://www.kernel.org/pub/linux/utils/cryptsetup/v2.7/cryptsetup-2.7.5.tar.sign)\n _(You need to decompress file first to check signature.)_\n * [Cryptsetup 2.7.5 Release Notes](https://www.kernel.org/pub/linux/utils/cryptsetup/v2.7/v2.7.5-ReleaseNotes).\n\nPrevious versions\n * [Version 2.6.1](https://www.kernel.org/pub/linux/utils/cryptsetup/v2.6/cryptsetup-2.6.1.tar.xz) -\n [Signature](https://www.kernel.org/pub/linux/utils/cryptsetup/v2.6/cryptsetup-2.6.1.tar.sign) -\n [Release Notes](https://www.kernel.org/pub/linux/utils/cryptsetup/v2.5/v2.5.0-ReleaseNotes).\n * [Version 1.7.5](https://www.kernel.org/pub/linux/utils/cryptsetup/v1.7/cryptsetup-1.7.5.tar.xz) -\n [Signature](https://www.kernel.org/pub/linux/utils/cryptsetup/v1.7/cryptsetup-1.7.5.tar.sign) -\n [Release Notes](https://www.kernel.org/pub/linux/utils/cryptsetup/v1.7/v1.7.5-ReleaseNotes).\n\nSource and API documentation\n----------------------------\nFor development version code, please refer to the\n[source](https://gitlab.com/cryptsetup/cryptsetup/tree/master) page, with mirrors\nat [kernel.org](https://git.kernel.org/cgit/utils/cryptsetup/cryptsetup.git/) and\n[GitHub](https://github.com/mbroz/cryptsetup).\n\nFor libcryptsetup documentation see\n[libcryptsetup API](https://mbroz.fedorapeople.org/libcryptsetup_API/) page.\n\nNLS PO files are maintained by\n[TranslationProject](https://translationproject.org/domain/cryptsetup.html).\n\nRequired packages\n-----------------\nAll major Linux distributions provide cryptsetup as a bundled package. If you need\nto compile cryptsetup yourself, various additional packages are required.\nAny distribution-specific build tools are preferred when manually configuring cryptsetup.\n\nBelow are the packages needed to build for certain Linux distributions:\n\n**For Fedora**:\n```\ngit gcc make autoconf automake gettext-devel pkgconfig openssl-devel popt-devel device-mapper-devel\nlibuuid-devel json-c-devel libblkid-devel findutils libtool libssh-devel tar\n\nOptionally: libargon2-devel libpwquality-devel\n```\nTo run the internal testsuite (make check) you also need to install\n```\nsharutils device-mapper jq vim-common expect keyutils netcat shadow-utils openssh-clients openssh sshpass\n```\n\n**For Debian and Ubuntu**:\n```\ngit gcc make autoconf automake autopoint pkg-config libtool gettext libssl-dev libdevmapper-dev\nlibpopt-dev uuid-dev libsepol-dev libjson-c-dev libssh-dev libblkid-dev tar\n\nOptionally: libargon2-0-dev libpwquality-dev\n```\nTo run the internal testsuite (make check) you also need to install\n```\nsharutils dmsetup jq xxd expect keyutils netcat passwd openssh-client sshpass\n```\n\nNote that the list may change as Linux distributions evolve.\n\nCompilation\n-----------\nThe cryptsetup project uses **automake** and **autoconf** system to generate all files needed to build.\nWhen building from a git snapshot,, use **./autogen.sh \u0026\u0026 ./configure \u0026\u0026 make**\nto compile the project. When building from a release **tar.xz** tarball, the configure script\nis pre-generated (no need to run **autoconf.sh**).\nSee **./configure --help** and use the **--disable-[feature]** and **--enable-[feature]** options.\n\nTo run the test suite that come with the project, type **make check**.\nNote that most tests will need root user privileges and will run dangerous storage failure simulations.\nDo **not** run tests with root privilege on production systems! Some tests will need the **scsi_debug**\nkernel module to be installed.\n\nFor more details, please refer to the\n[automake](https://www.gnu.org/software/automake/manual/automake.html) and\n[autoconf](https://www.gnu.org/savannah-checkouts/gnu/autoconf/manual/autoconf.html) documentation.\n\nHelp!\n-----\n### Documentation\nPlease read the following before posting questions to the mailing list so that\nyou can ask better questions and better understand answers.\n\n* [Frequently asked questions (FAQ)](https://gitlab.com/cryptsetup/cryptsetup/wikis/FrequentlyAskedQuestions),\n* [LUKS Specifications](#specification-and-documentation), and\n* manuals (aka man page, man pages, man-page) \n\nThe FAQ is available online and in the source code for the project. The specifications are\nreferenced above in this document. The man pages live within the source tree and should be\navailable after installation using standard man commands, e.g. **man cryptsetup**.\n\n### Mailing List\nFor cryptsetup and LUKS related questions, please use the cryptsetup mailing list\n[cryptsetup@lists.linux.dev](mailto:cryptsetup@lists.linux.dev),\nhosted at [kernel.org subspace](https://subspace.kernel.org/lists.linux.dev.html).\nTo subscribe send an empty email message to\n[cryptsetup+subscribe@lists.linux.dev](mailto:cryptsetup+subscribe@lists.linux.dev).\n\nYou can also browse and/or search the mailing [list archive](https://lore.kernel.org/cryptsetup/).\nUSEnet News (NNTP), Atom feed and git access to the public inbox is available through\n[lore.kernel.org](https://lore.kernel.org) service.\n\nThe former **dm-crypt** [list archive](https://lore.kernel.org/dm-crypt/) is also available.\n","front_matter":{},"format":"markdown","uploads_path":"https://gitlab.com/api/v4/projects/195655/wikis/attachments","slug":"home","path":"/cryptsetup/cryptsetup/-/wikis/home","wiki_path":"/cryptsetup/cryptsetup/-/wikis/home","help_path":"/help/user/project/wiki/index.md","markdown_help_path":"/help/user/markdown.md","markdown_preview_path":"/cryptsetup/cryptsetup/-/wikis/home/preview_markdown","create_path":"/cryptsetup/cryptsetup/-/wikis"}" data-page-persisted="false" data-page-version="{"id":"4b6a217a5ca0ee0edef6af753b66a8d4e0722550","message":"Update release.\n","parent_ids":["8153634e1588e265a1c60f72ed2240c7787899ea"],"authored_date":"2024-09-03T11:56:31.000+02:00","author_name":"Milan Broz","author_email":"gmazyland@gmail.com","committed_date":"2024-09-03T11:56:31.000+02:00","committer_name":"Milan Broz","committer_email":"gmazyland@gmail.com","trailers":{},"extended_trailers":{},"referenced_by":[]}" data-show-edit-button="false" data-templates="[]" data-templates-url="/cryptsetup/cryptsetup/-/wikis/templates" data-testid="wiki-page-content-app" data-wiki-path="cryptsetup.wiki" data-wiki-url="/cryptsetup/cryptsetup/-/wikis/home" id="js-vue-wiki-content-app"></div> <aside aria-label="Wiki" class="right-sidebar right-sidebar-expanded wiki-sidebar js-wiki-sidebar js-right-sidebar gl-hidden" data-offset-top="50" data-spy="affix"> <div class="js-wiki-sidebar-resizer"></div> <div class="sidebar-container"> <div class="block gl-mb-3 gl-mx-5 gl-mt-5 gl-block sm:gl-hidden !gl-pt-0"> <a class="gutter-toggle gl-float-right gl-block md:gl-hidden js-sidebar-wiki-toggle" href="#"> <svg class="s16 gl-icon" data-testid="chevron-double-lg-right-icon"><use href="/assets/icons-8791a66659d025e0a4c801978c79a1fbd82db1d27d85f044a35728ea7cf0ae80.svg#chevron-double-lg-right"></use></svg> </a> </div> <div class="js-wiki-toc"></div> <div class="blocks-container !gl-px-3 !gl-my-5"> <div class="gl-flex gl-place-content-between gl-items-center gl-pb-3 gl-pr-1 gl-pl-3"> <div class="gl-flex gl-items-center"> <h2 class="gl-text-lg gl-my-0 gl-mr-3">Pages</h2> <span class="gl-badge badge badge-pill badge-muted"><span class="gl-badge-content">12</span></span> </div> </div> <div data-can-create="false" data-has-custom-sidebar="false" data-view-all-pages-path="/cryptsetup/cryptsetup/-/wikis/pages" id="js-wiki-sidebar-entries"></div> </div> </div> </aside> </main> </div> </div> </div> <script nonce="ym/ryTtRs2HtduQdY1nknw=="> //<![CDATA[ if ('loading' in HTMLImageElement.prototype) { document.querySelectorAll('img.lazy').forEach(img => { img.loading = 'lazy'; let imgUrl = img.dataset.src; // Only adding width + height for avatars for now if (imgUrl.indexOf('/avatar/') > -1 && imgUrl.indexOf('?') === -1) { const targetWidth = img.getAttribute('width') || img.width; imgUrl += `?width=${targetWidth}`; } img.src = imgUrl; img.removeAttribute('data-src'); img.classList.remove('lazy'); img.classList.add('js-lazy-loaded'); img.dataset.testid = 'js-lazy-loaded-content'; }); } //]]> </script> <script nonce="ym/ryTtRs2HtduQdY1nknw=="> //<![CDATA[ gl = window.gl || {}; gl.experiments = {}; //]]> </script> </body> </html>