€•Ù5Œsphinx.addnodes”Œdocument”“”)”}”(Œ rawsource”Œ”Œchildren”]”(Œ translations”Œ LanguagesNode”“”)”}”(hhh]”(hŒ pending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”Œparent”hsbaŒ attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ refdomain”Œstd”Œreftype”Œdoc”Œ reftarget”Œ(/translations/zh_CN/filesystems/ecryptfs”Œmodname”NŒ classname”NŒ refexplicit”ˆuŒtagname”hhh ubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ(/translations/zh_TW/filesystems/ecryptfs”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ(/translations/it_IT/filesystems/ecryptfs”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ(/translations/ja_JP/filesystems/ecryptfs”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ(/translations/ko_KR/filesystems/ecryptfs”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒSpanish”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ(/translations/sp_SP/filesystems/ecryptfs”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒEnglish”uh1h hhŒ _document”hŒsource”NŒline”NubhŒcomment”“”)”}”(hŒ SPDX-License-Identifier: GPL-2.0”h]”hŒ SPDX-License-Identifier: GPL-2.0”…””}”hh£sbah}”(h]”h ]”h"]”h$]”h&]”Œ xml:space”Œpreserve”uh1h¡hhhžhhŸŒB/var/lib/git/docbuild/linux/Documentation/filesystems/ecryptfs.rst”h KubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒ6eCryptfs: A stacked cryptographic filesystem for Linux”h]”hŒ6eCryptfs: A stacked cryptographic filesystem for Linux”…””}”(hh»hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hh¶hžhhŸh³h KubhŒ paragraph”“”)”}”(hŒÎeCryptfs is free software. Please see the file COPYING for details. For documentation, please see the files in the doc/ subdirectory. For building and installation instructions please see the INSTALL file.”h]”hŒÎeCryptfs is free software. Please see the file COPYING for details. For documentation, please see the files in the doc/ subdirectory. For building and installation instructions please see the INSTALL file.”…””}”(hhËhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khh¶hžhubhŒ field_list”“”)”}”(hhh]”(hŒfield”“”)”}”(hhh]”(hŒ field_name”“”)”}”(hŒ Maintainer”h]”hŒ Maintainer”…””}”(hhåhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hãhhàhŸh³h KubhŒ field_body”“”)”}”(hŒPhillip Hellewell”h]”hÊ)”}”(hh÷h]”hŒPhillip Hellewell”…””}”(hhùhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K hhõubah}”(h]”h ]”h"]”h$]”h&]”uh1hóhhàubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÞhŸh³h K hhÛhžhubhß)”}”(hhh]”(hä)”}”(hŒLead developer”h]”hŒLead developer”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hãhjhŸh³h Kubhô)”}”(hŒ(Michael A. Halcrow ”h]”hÊ)”}”(hj%h]”(hŒMichael A. Halcrow <”…””}”(hj'hžhhŸNh NubhŒ reference”“”)”}”(hŒmhalcrow@us.ibm.com”h]”hŒmhalcrow@us.ibm.com”…””}”(hj0hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œmailto:mhalcrow@us.ibm.com”uh1j.hj'ubhŒ>”…””}”(hj'hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K hj#ubah}”(h]”h ]”h"]”h$]”h&]”uh1hóhjubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÞhŸh³h K hhÛhžhubhß)”}”(hhh]”(hä)”}”(hŒ Developers”h]”hŒ Developers”…””}”(hjYhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hãhjVhŸh³h Kubhô)”}”(hŒMichael C. Thompson Kent Yoder”h]”hÊ)”}”(hŒMichael C. Thompson Kent Yoder”h]”hŒMichael C. Thompson Kent Yoder”…””}”(hjkhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K hjgubah}”(h]”h ]”h"]”h$]”h&]”uh1hóhjVubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÞhŸh³h K hhÛhžhubhß)”}”(hhh]”(hä)”}”(hŒWeb Site”h]”hŒWeb Site”…””}”(hjˆhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hãhj…hŸh³h Kubhô)”}”(hŒhttp://ecryptfs.sf.net ”h]”hÊ)”}”(hŒhttp://ecryptfs.sf.net”h]”j/)”}”(hjœh]”hŒhttp://ecryptfs.sf.net”…””}”(hjžhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”jœuh1j.hjšubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khj–ubah}”(h]”h ]”h"]”h$]”h&]”uh1hóhj…ubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÞhŸh³h KhhÛhžhubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÙhh¶hžhhŸh³h K ubhÊ)”}”(hŒ{This software is currently undergoing development. Make sure to maintain a backup copy of any data you write into eCryptfs.”h]”hŒ{This software is currently undergoing development. Make sure to maintain a backup copy of any data you write into eCryptfs.”…””}”(hjÄhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khh¶hžhubhÊ)”}”(hŒMeCryptfs requires the userspace tools downloadable from the SourceForge site:”h]”hŒMeCryptfs requires the userspace tools downloadable from the SourceForge site:”…””}”(hjÒhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khh¶hžhubhÊ)”}”(hŒ)http://sourceforge.net/projects/ecryptfs/”h]”j/)”}”(hjâh]”hŒ)http://sourceforge.net/projects/ecryptfs/”…””}”(hjähžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”jâuh1j.hjàubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khh¶hžhubhÊ)”}”(hŒUserspace requirements include:”h]”hŒUserspace requirements include:”…””}”(hjøhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khh¶hžhubhŒ bullet_list”“”)”}”(hhh]”(hŒ list_item”“”)”}”(hŒŒDavid Howells' userspace keyring headers and libraries (version 1.0 or higher), obtainable from http://people.redhat.com/~dhowells/keyutils/”h]”hÊ)”}”(hŒŒDavid Howells' userspace keyring headers and libraries (version 1.0 or higher), obtainable from http://people.redhat.com/~dhowells/keyutils/”h]”(hŒbDavid Howells’ userspace keyring headers and libraries (version 1.0 or higher), obtainable from ”…””}”(hjhžhhŸNh Nubj/)”}”(hŒ,http://people.redhat.com/~dhowells/keyutils/”h]”hŒ,http://people.redhat.com/~dhowells/keyutils/”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”juh1j.hjubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khj ubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjhžhhŸh³h Nubj )”}”(hŒ Libgcrypt ”h]”hÊ)”}”(hŒ Libgcrypt”h]”hŒ Libgcrypt”…””}”(hj8hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khj4ubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjhžhhŸh³h Nubeh}”(h]”h ]”h"]”h$]”h&]”Œbullet”Œ-”uh1jhŸh³h Khh¶hžhubhŒnote”“”)”}”(hŒÍIn the beta/experimental releases of eCryptfs, when you upgrade eCryptfs, you should copy the files to an unencrypted location and then copy the files back into the new eCryptfs mount to migrate the files.”h]”hÊ)”}”(hŒÍIn the beta/experimental releases of eCryptfs, when you upgrade eCryptfs, you should copy the files to an unencrypted location and then copy the files back into the new eCryptfs mount to migrate the files.”h]”hŒÍIn the beta/experimental releases of eCryptfs, when you upgrade eCryptfs, you should copy the files to an unencrypted location and then copy the files back into the new eCryptfs mount to migrate the files.”…””}”(hjZhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K#hjVubah}”(h]”h ]”h"]”h$]”h&]”uh1jThh¶hžhhŸh³h Nubhµ)”}”(hhh]”(hº)”}”(hŒMount-wide Passphrase”h]”hŒMount-wide Passphrase”…””}”(hjqhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hjnhžhhŸh³h K*ubhÊ)”}”(hŒ½Create a new directory into which eCryptfs will write its encrypted files (i.e., /root/crypt). Then, create the mount point directory (i.e., /mnt/crypt). Now it's time to mount eCryptfs::”h]”hŒ¾Create a new directory into which eCryptfs will write its encrypted files (i.e., /root/crypt). Then, create the mount point directory (i.e., /mnt/crypt). Now it’s time to mount eCryptfs:”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K,hjnhžhubhŒ literal_block”“”)”}”(hŒ(mount -t ecryptfs /root/crypt /mnt/crypt”h]”hŒ(mount -t ecryptfs /root/crypt /mnt/crypt”…””}”hjsbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1jhŸh³h K0hjnhžhubhÊ)”}”(hŒKYou should be prompted for a passphrase and a salt (the salt may be blank).”h]”hŒKYou should be prompted for a passphrase and a salt (the salt may be blank).”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K2hjnhžhubhÊ)”}”(hŒTry writing a new file::”h]”hŒTry writing a new file:”…””}”(hj«hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K5hjnhžhubjŽ)”}”(hŒ*echo "Hello, World" > /mnt/crypt/hello.txt”h]”hŒ*echo "Hello, World" > /mnt/crypt/hello.txt”…””}”hj¹sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1jhŸh³h K7hjnhžhubhÊ)”}”(hX)The operation will complete. Notice that there is a new file in /root/crypt that is at least 12288 bytes in size (depending on your host page size). This is the encrypted underlying file for what you just wrote. To test reading, from start to finish, you need to clear the user session keyring:”h]”hX)The operation will complete. Notice that there is a new file in /root/crypt that is at least 12288 bytes in size (depending on your host page size). This is the encrypted underlying file for what you just wrote. To test reading, from start to finish, you need to clear the user session keyring:”…””}”(hjÇhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K9hjnhžhubhÊ)”}”(hŒkeyctl clear @u”h]”hŒkeyctl clear @u”…””}”(hjÕhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K?hjnhžhubhÊ)”}”(hŒHThen umount /mnt/crypt and mount again per the instructions given above.”h]”hŒHThen umount /mnt/crypt and mount again per the instructions given above.”…””}”(hjãhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KAhjnhžhubjŽ)”}”(hŒcat /mnt/crypt/hello.txt”h]”hŒcat /mnt/crypt/hello.txt”…””}”hjñsbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1jhŸh³h KFhjnhžhubeh}”(h]”Œmount-wide-passphrase”ah ]”h"]”Œmount-wide passphrase”ah$]”h&]”uh1h´hh¶hžhhŸh³h K*ubhµ)”}”(hhh]”(hº)”}”(hŒNotes”h]”hŒNotes”…””}”(hj hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hjhžhhŸh³h KJubhÊ)”}”(hX­eCryptfs version 0.1 should only be mounted on (1) empty directories or (2) directories containing files only created by eCryptfs. If you mount a directory that has pre-existing files not created by eCryptfs, then behavior is undefined. Do not run eCryptfs in higher verbosity levels unless you are doing so for the sole purpose of debugging or development, since secret values will be written out to the system log in that case.”h]”hX­eCryptfs version 0.1 should only be mounted on (1) empty directories or (2) directories containing files only created by eCryptfs. If you mount a directory that has pre-existing files not created by eCryptfs, then behavior is undefined. Do not run eCryptfs in higher verbosity levels unless you are doing so for the sole purpose of debugging or development, since secret values will be written out to the system log in that case.”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KLhjhžhubhÊ)”}”(hŒ Mike Halcrow mhalcrow@us.ibm.com”h]”(hŒ Mike Halcrow ”…””}”(hj&hžhhŸNh Nubj/)”}”(hŒmhalcrow@us.ibm.com”h]”hŒmhalcrow@us.ibm.com”…””}”(hj.hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œmailto:mhalcrow@us.ibm.com”uh1j.hj&ubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KUhjhžhubeh}”(h]”Œnotes”ah ]”h"]”Œnotes”ah$]”h&]”uh1h´hh¶hžhhŸh³h KJubeh}”(h]”Œ5ecryptfs-a-stacked-cryptographic-filesystem-for-linux”ah ]”h"]”Œ6ecryptfs: a stacked cryptographic filesystem for linux”ah$]”h&]”uh1h´hhhžhhŸh³h Kubeh}”(h]”h ]”h"]”h$]”h&]”Œsource”h³uh1hŒcurrent_source”NŒ current_line”NŒsettings”Œdocutils.frontend”ŒValues”“”)”}”(h¹NŒ generator”NŒ datestamp”NŒ source_link”NŒ source_url”NŒ toc_backlinks”Œentry”Œfootnote_backlinks”KŒ sectnum_xform”KŒstrip_comments”NŒstrip_elements_with_classes”NŒ strip_classes”NŒ report_level”KŒ halt_level”KŒexit_status_level”KŒdebug”NŒwarning_stream”NŒ traceback”ˆŒinput_encoding”Œ utf-8-sig”Œinput_encoding_error_handler”Œstrict”Œoutput_encoding”Œutf-8”Œoutput_encoding_error_handler”jwŒerror_encoding”Œutf-8”Œerror_encoding_error_handler”Œbackslashreplace”Œ language_code”Œen”Œrecord_dependencies”NŒconfig”NŒ id_prefix”hŒauto_id_prefix”Œid”Œ dump_settings”NŒdump_internals”NŒdump_transforms”NŒdump_pseudo_xml”NŒexpose_internals”NŒstrict_visitor”NŒ_disable_config”NŒ_source”h³Œ _destination”NŒ _config_files”]”Œ7/var/lib/git/docbuild/linux/Documentation/docutils.conf”aŒfile_insertion_enabled”ˆŒ raw_enabled”KŒline_length_limit”M'Œpep_references”NŒ pep_base_url”Œhttps://peps.python.org/”Œpep_file_url_template”Œpep-%04d”Œrfc_references”NŒ rfc_base_url”Œ&https://datatracker.ietf.org/doc/html/”Œ tab_width”KŒtrim_footnote_reference_space”‰Œsyntax_highlight”Œlong”Œ smart_quotes”ˆŒsmartquotes_locales”]”Œcharacter_level_inline_markup”‰Œdoctitle_xform”‰Œ docinfo_xform”KŒsectsubtitle_xform”‰Œ image_loading”Œlink”Œembed_stylesheet”‰Œcloak_email_addresses”ˆŒsection_self_link”‰Œenv”NubŒreporter”NŒindirect_targets”]”Œsubstitution_defs”}”Œsubstitution_names”}”Œrefnames”}”Œrefids”}”Œnameids”}”(jQjNjjjIjFuŒ nametypes”}”(jQ‰j‰jI‰uh}”(jNh¶jjnjFjuŒ footnote_refs”}”Œ citation_refs”}”Œ autofootnotes”]”Œautofootnote_refs”]”Œsymbol_footnotes”]”Œsymbol_footnote_refs”]”Œ footnotes”]”Œ citations”]”Œautofootnote_start”KŒsymbol_footnote_start”KŒ id_counter”Œ collections”ŒCounter”“”}”…”R”Œparse_messages”]”Œtransform_messages”]”Œ transformer”NŒ include_log”]”Œ decoration”Nhžhub.