A S3QL file system is created with the mkfs.s3ql command. It has the following syntax:
mkfs.s3ql [options] <storage url>
Note
When using the Amazon S3 backend and working with a newly created bucket initial performance is often very bad (cf. issue 363). This problem typically disappears after 1 – 2 days.
This command accepts the following options:
--cachedir <path> Store cached data in this directory (default: ~/.s3ql) --authfile <path> Read authentication credentials from this file (default: ~/.s3ql/authinfo2) --debug <module> activate debugging output from <module>. Use all to get debug messages from all modules. This option can be specified multiple times. --quiet be really quiet --ssl Always use SSL connections when connecting to remote servers. For backends that allow only encrypted connections, S3QL uses SSL automatically, even if this option is not set. --version just print program version and exit -L <name> Filesystem label --max-obj-size <size> Maximum size of storage objects in KiB. Files bigger than this will be spread over multiple objects in the storage backend. Default: 10240 KiB. --plain Create unencrypted file system. --force Overwrite any existing data.
Unless you have specified the --plain option, mkfs.s3ql will ask you to enter an encryption password. This password will not be read from an authentication file specified with the --authfile option to prevent accidental creation of an encrypted file system.