2014-04-02 08:29:34 +00:00
|
|
|
btrfstune(8)
|
|
|
|
|
============
|
|
|
|
|
|
|
|
|
|
NAME
|
|
|
|
|
----
|
2015-06-02 17:34:40 +00:00
|
|
|
btrfstune - tune various filesystem parameters
|
2014-04-02 08:29:34 +00:00
|
|
|
|
|
|
|
|
SYNOPSIS
|
|
|
|
|
--------
|
2014-05-19 15:49:35 +00:00
|
|
|
*btrfstune* [options] <dev> [<dev>...]
|
2014-04-02 08:29:34 +00:00
|
|
|
|
|
|
|
|
DESCRIPTION
|
|
|
|
|
-----------
|
2015-06-02 17:34:40 +00:00
|
|
|
*btrfstune* can be used to enable, disable or set various filesystem
|
|
|
|
|
parameters. The filesystem must be unmounted.
|
|
|
|
|
|
|
|
|
|
The common usecase is to enable features that were not enabled at mkfs time.
|
|
|
|
|
Please make sure that you have kernel support for the features. You can find a
|
|
|
|
|
complete list of features and kernel version of their introduction at
|
|
|
|
|
https://btrfs.wiki.kernel.org/index.php/Changelog#By_feature .
|
2014-04-02 08:29:34 +00:00
|
|
|
|
|
|
|
|
OPTIONS
|
|
|
|
|
-------
|
2015-06-02 17:34:40 +00:00
|
|
|
-S <0|1>::
|
|
|
|
|
Enable seeding on a given device. Value 1 will enable seeding, 0 will disable it. +
|
|
|
|
|
A seeding filesystem is forced to be mounted read-only. A new device can be added
|
|
|
|
|
to the filesystem and will capture all writes keeping the seeding device intact.
|
2014-04-02 08:29:34 +00:00
|
|
|
-r::
|
2015-06-02 17:34:40 +00:00
|
|
|
Enable extended inode refs (hardlink limit per file in a directory is 65536). Since kernel 3.7.
|
2014-04-02 08:29:34 +00:00
|
|
|
-x::
|
2015-06-02 17:34:40 +00:00
|
|
|
Enable skinny metadata extent refs (more efficient representation of extents). Since kernel 3.10.
|
2015-06-02 16:41:01 +00:00
|
|
|
-n::
|
2015-06-02 17:34:40 +00:00
|
|
|
Enable no-holes feature (more efficient representation of file holes). Since kernel 3.14.
|
2014-07-07 01:54:53 +00:00
|
|
|
-f::
|
2015-05-15 06:28:26 +00:00
|
|
|
Allow dangerous changes, e.g. clear the seeding flag or change fsid. Make sure
|
|
|
|
|
that you are aware of the dangers.
|
|
|
|
|
-u::
|
2015-06-02 17:34:40 +00:00
|
|
|
Change fsid to a randomly generated UUID or continue previous fsid change
|
|
|
|
|
operation in case it was interrupted.
|
2015-05-15 06:28:26 +00:00
|
|
|
-U <UUID>::
|
|
|
|
|
Change fsid to <UUID>.
|
|
|
|
|
+
|
|
|
|
|
The <UUID> should be a 36 bytes string in `printf`(3) format
|
|
|
|
|
"%08x-%04x-%04x-%04x-%012x".
|
2015-06-02 17:34:40 +00:00
|
|
|
If there is a previous unfinished fsid change, it will continue only if the
|
|
|
|
|
<UUID> matches the unfinished one or if you use the option '-u'.
|
2015-05-15 06:28:26 +00:00
|
|
|
|
|
|
|
|
WARNING: Cancelling or interrupting a UUID change operation will make the
|
|
|
|
|
filesystem temporarily unmountable. To fix it, rerun 'btrfstune -u' to restore
|
2015-06-02 17:34:40 +00:00
|
|
|
the UUID and let it complete.
|
2014-04-02 08:29:34 +00:00
|
|
|
|
2015-06-02 17:34:40 +00:00
|
|
|
WARNING: Clearing the seeding flag on a device may be dangerous.
|
|
|
|
|
If a previously-seeding device is changed, all filesystems that used that
|
|
|
|
|
device will become unmountable. Setting the seeding flag back will not fix
|
|
|
|
|
that. +
|
|
|
|
|
A valid usecase is "seeding device as a base image". Clear the seeding
|
|
|
|
|
flag, update the filesystem and make it seeding again, provided that it's ok
|
|
|
|
|
to throw away all filesystems built on top of the previous base.
|
2014-04-02 08:29:34 +00:00
|
|
|
|
|
|
|
|
EXIT STATUS
|
|
|
|
|
-----------
|
2015-06-02 17:34:40 +00:00
|
|
|
*btrfstune* returns 0 if no error happened, 1 otherwise.
|
|
|
|
|
|
|
|
|
|
COMPATIBILITY NOTE
|
|
|
|
|
------------------
|
|
|
|
|
This tool exists for historical reasons but is still in use today. The
|
|
|
|
|
functionality is about to be merged to the main tool someday and *btrfstune*
|
|
|
|
|
will become deprecated and removed afterwards.
|
2014-04-02 08:29:34 +00:00
|
|
|
|
|
|
|
|
SEE ALSO
|
|
|
|
|
--------
|
|
|
|
|
`mkfs.btrfs`(8)
|
