6
eCryptfs - an enterprise-class cryptographic filesystem for linux
18
eCryptfs is a POSIX-compliant enterprise-class stacked cryptographic
19
filesystem for Linux. It is derived from Erez Zadok's Cryptfs, implemented
20
through the FiST framework for generating stacked filesystems. eCryptfs
21
extends Cryptfs to provide advanced key management and policy features.
22
eCryptfs stores cryptographic metadata in the header of each file written,
23
so that encrypted files can be copied between hosts; the file will be
24
decryptable with the proper key, and there is no need to keep track of any
25
additional information aside from what is already in the encrypted file
26
itself. Think of eCryptfs as a sort of "gnupgfs."
30
=head2 STANDARD OPTIONS
34
=item B<key=(keytype):[Key Options]>
36
Specify the type of key to be used when mounting eCryptfs.
38
=item B<cipher=(cipher)>
40
Specify the symmetric cipher to be used on a per file basis
42
=item B<ecryptfs_key_bytes=(key_bytes)>
44
Specify the keysize to be used with the selected cipher. If the cipher
45
only has one keysize the keysize does not need to be specified.
49
Allows for non-eCryptfs files to be read and written from within an
50
eCryptfs mount. This option is turned off by default.
52
=item B<verbosity=(level)>
53
Seting verbosity prevents eCryptfs from interactively requesting for options
54
to be entered. The mount will fail if an essential option is absent.
58
=item B<passwd=(passphrase)>
60
The actual password is password. Since the password is visible to utilities
61
(like ’ps’ under Unix) this form should only be used where security is not
64
=item B<passfile=(filename)>
66
The password should be specified in a file with B<passwd=(passphrase)>. It is
67
highly reccomended that the file be stored on a secure medium such as a
70
=item B<passfd=(file descriptor)>
72
The password is specified through the specified file descriptor.
76
The user types their passphrase in through stdin.
78
=item B<salt=(hex value)>
80
The salt should be specified as a 16 digit hex value.
82
=item B<keyfile=(filename)>
84
The filename should be the filename of a file containing an RSA SSL key.
92
Do not run eCryptfs in higher verbosity levels
93
unless you are doing so for the sole purpose of development, since
94
secret values will be written out to the system log in that case.
98
Please send bug reports to the lead developer, an eCryptfs mailing
99
list hosted from SourceForge, or to the SourceForge bug tracker for
100
the eCryptfs project. For kernel bugs, please follow the procedure
101
detailed in Documentation/oops-tracing.txt to help us figure out what