Table Of Contents

File System CreationΒΆ

A S3QL file system is created with the mkfs.s3ql command. It has the following syntax:

mkfs.s3ql [options] <storage url>

This command accepts the following options:

--cachedir <path>
 Store cached data in this directory (default: ~/.s3ql) (default: /home/nikratio/.s3ql)
--authfile <path>
 Read authentication credentials from this file (default: ~/.s3ql/authinfo2) (default: /home/nikratio/.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. (default: None)
--quiet be really quiet (default: False)
--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. (default: False)
--version just print program version and exit
-L <name> Filesystem label (default: )
--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. (default: False)
--force Overwrite any existing data. (default: False)

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.