.TH ERFS 1 .SH NAME erfs \- a tool to create an encrypted file system on the cloud .SH SYNOPSIS .B erfs .I " [-options] []" .br .SH "DESCRIPTION" .B erfs is a simple unix utility which creates and mounts an encrypted remote file system. The file system is encrypted locally and the encrypted data is stored in the cloud. .P The cloud server has no knowledge of the content. A rogue server operator can not access the data. All key material is created on the user's computer and never stored or transferred to the server. .P It supports collaboration and the same filesystem can be accessed from different computers at the same time. The data is securely and seamlessly synchronized. .SH COMMAND .TP 13 .I init Initialize (create) a new file system and print the SHARE-SECRET of the newly created file system. .TP 13 .I mount Mount the encrypted remote file system. .TP 13 .I umount Unmount the encrypted remote file system. SHARE-SECRET is optional and all filesystems will be unmounted if no specific SHARE-SECRET is given. .SH OPTIONS .TP 13 .I \-x read the SHARE-SECRET from standard input. .SH SECURITY Passing the SHARE-SECRET as command line parameter is insecure. Use the -x option or set the environment variable (example): .P $ SEC=aDe5F2ik3x35x7pfAEAWdC5Y ./erfs m .SH ENVIRONEMT The following environment variable can be set to control the behavior. .P .I SEC= Specify the SHARE-SECRET to pass it (securely) to erfs. .SH COPYRIGHT ERFS is entirely my own creation, although plenty of other code was used as examples. It is released under GPL. .SH NOTES The latest version is available from https://github.com/hackerschoice/erfs/. .SH BUGS Efforts have been made to have erfs "do the right thing" in all its various modes. If you believe that it is doing the wrong thing under whatever circumstances, please notify me and tell me how you think it should behave. I certainly encourage people to make custom mods and send in any improvements they make to it. Continued feedback from the Internet community is always welcome! .SH EXAMPLES Initialize a new encrypted and remote file system: .br $ erfs init .P Mount the new file system (replace aDe5F2ik3x35x7pfAEAWdC5Y with the SHARE-SECRET from the previous step): .br $ erfs mount aDe5F2ik3x35x7pfAEAWdC5Y .P or mount to a specific mount-point (~/secure-drive): .br $ mkdir ~/secure-drive .br $ erfs mount aDe5F2ik3x35x7pfAEAWdC5Y ~/secure-drive .P Unmount the file system: .br $ erfs umount ~/secure-drive .P or unmount the file system by specifying the SHARE-SECRET: .br $ erfs umount aDe5F2ik3x35x7pfAEAWdC5Y .P or unmount all encrypted file systems: .br $ erfs umount .SH AUTHOR This manual page was written by skyper . .P ERFS was written by skyper .