summaryrefslogtreecommitdiff
path: root/doc/html/_sources/mkfs.txt
blob: f0b9db43f5cb15998451464ce416cf1b7eeeec52 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
.. -*- mode: rst -*-

====================
File System Creation
====================

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
  <http://code.google.com/p/s3ql/issues/detail?id=363>`_). This
  problem typically disappears after 1 -- 2 days.
  
This command accepts the following options:

.. pipeinclude:: python ../bin/mkfs.s3ql --help
   :start-after: show this help message and exit

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 :cmdopt:`--authfile`
option to prevent accidental creation of an encrypted file system.