€•Ë6Œ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ŒPortuguese (Brazilian)”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ(/translations/pt_BR/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Þ)”}”(hj h]”hŒPhillip Hellewell”…””}”(hj h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K hj ubah}”(h]”h ]”h"]”h$]”h&]”uh1jhhôubeh}”(h]”h ]”h"]”h$]”h&]”uh1hòh³hÇh´K hhïh²hubhó)”}”(hhh]”(hø)”}”(hŒLead developer”h]”hŒLead developer”…””}”(hj)h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h÷hj&h³hÇh´Kubj)”}”(hŒ(Michael A. Halcrow ”h]”hÞ)”}”(hj9h]”(hŒMichael A. Halcrow <”…””}”(hj;h²hh³Nh´NubhŒ reference”“”)”}”(hŒmhalcrow@us.ibm.com”h]”hŒmhalcrow@us.ibm.com”…””}”(hjDh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œmailto:mhalcrow@us.ibm.com”uh1jBhj;ubhŒ>”…””}”(hj;h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K hj7ubah}”(h]”h ]”h"]”h$]”h&]”uh1jhj&ubeh}”(h]”h ]”h"]”h$]”h&]”uh1hòh³hÇh´K hhïh²hubhó)”}”(hhh]”(hø)”}”(hŒ Developers”h]”hŒ Developers”…””}”(hjmh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h÷hjjh³hÇh´Kubj)”}”(hŒMichael C. Thompson Kent Yoder”h]”hÞ)”}”(hŒMichael C. Thompson Kent Yoder”h]”hŒMichael C. Thompson Kent Yoder”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K hj{ubah}”(h]”h ]”h"]”h$]”h&]”uh1jhjjubeh}”(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´Kubj)”}”(hŒhttp://ecryptfs.sf.net ”h]”hÞ)”}”(hŒhttp://ecryptfs.sf.net”h]”jC)”}”(hj°h]”hŒhttp://ecryptfs.sf.net”…””}”(hj²h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”j°uh1jBhj®ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´Khjªubah}”(h]”h ]”h"]”h$]”h&]”uh1jhj™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]”jC)”}”(hjöh]”hŒ)http://sourceforge.net/projects/ecryptfs/”…””}”(hjøh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”jöuh1jBhjô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 ”…””}”(hj%h²hh³Nh´NubjC)”}”(hŒ,http://people.redhat.com/~dhowells/keyutils/”h]”hŒ,http://people.redhat.com/~dhowells/keyutils/”…””}”(hj-h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”j/uh1jBhj%ubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´Khj!ubah}”(h]”h ]”h"]”h$]”h&]”uh1jhjh²hh³hÇh´Nubj )”}”(hŒ Libgcrypt ”h]”hÞ)”}”(hŒ Libgcrypt”h]”hŒ Libgcrypt”…””}”(hjLh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´KhjHubah}”(h]”h ]”h"]”h$]”h&]”uh1jhjh²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.”…””}”(hjnh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K#hjjubah}”(h]”h ]”h"]”h$]”h&]”uh1jhhhÊh²hh³hÇh´NubhÉ)”}”(hhh]”(hÎ)”}”(hŒMount-wide Passphrase”h]”hŒMount-wide Passphrase”…””}”(hj…h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhj‚h²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:”…””}”(hj“h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K,hj‚h²hubhŒ literal_block”“”)”}”(hŒ(mount -t ecryptfs /root/crypt /mnt/crypt”h]”hŒ(mount -t ecryptfs /root/crypt /mnt/crypt”…””}”hj£sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1j¡h³hÇh´K0hj‚h²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).”…””}”(hj±h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K2hj‚h²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´K5hj‚h²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Æuh1j¡h³hÇh´K7hj‚h²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´K9hj‚h²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?hj‚h²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´KAhj‚h²hubj¢)”}”(hŒcat /mnt/crypt/hello.txt”h]”hŒcat /mnt/crypt/hello.txt”…””}”hjsbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1j¡h³hÇh´KFhj‚h²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”…””}”(hjh²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.”…””}”(hj,h²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´NubjC)”}”(hŒmhalcrow@us.ibm.com”h]”hŒmhalcrow@us.ibm.com”…””}”(hjBh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œmailto:mhalcrow@us.ibm.com”uh1jBhj: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”j‹Œ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”}”(jejbjjj]jZuŒ nametypes”}”(je‰j‰j]‰uh}”(jbhÊjj‚jZjuŒ 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.