~ubuntu-branches/debian/stretch/s3ql/stretch

« back to all changes in this revision

Viewing changes to rst/umount.rst

  • Committer: Bazaar Package Importer
  • Author(s): Nikolaus Rath
  • Date: 2011-07-01 14:02:17 UTC
  • Revision ID: james.westby@ubuntu.com-20110701140217-cyyclk7tusagxucf
Tags: upstream-1.0.1
ImportĀ upstreamĀ versionĀ 1.0.1

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.. -*- mode: rst -*-
 
2
 
 
3
==========
 
4
Unmounting
 
5
==========
 
6
 
 
7
To unmount an S3QL file system, use the command::
 
8
 
 
9
 umount.s3ql [options] <mountpoint>
 
10
 
 
11
This will block until all data has been committed to the storage
 
12
backend.
 
13
 
 
14
Only the user who mounted the file system with :command:`mount.s3ql`
 
15
is able to unmount it again. If you are root and want to unmount an
 
16
S3QL file system mounted by an ordinary user, you have to use the
 
17
:command:`fusermount -u` or :command:`umount` command instead. Note
 
18
that these commands do not block until all data has been uploaded, so
 
19
if you use them instead of `umount.s3ql` then you should manually wait
 
20
for the `mount.s3ql` process to terminate before shutting down the
 
21
system.
 
22
 
 
23
The :command:`umount.s3ql` command accepts the following options:
 
24
 
 
25
.. pipeinclude:: ../bin/umount.s3ql --help
 
26
   :start-after: show this help message and exit
 
27
 
 
28
If, for some reason, the `umount.sql` command does not work, the file
 
29
system can also be unmounted with `fusermount -u -z`. Note that this
 
30
command will return immediately and the file system may continue to
 
31
upload data in the background for a while longer.