From patchwork Mon Sep 4 06:41:10 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Qu Wenruo X-Patchwork-Id: 9936729 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork.web.codeaurora.org (Postfix) with ESMTP id 8AE7D60237 for ; Mon, 4 Sep 2017 06:41:30 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 7CA242871E for ; Mon, 4 Sep 2017 06:41:30 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 7190E2872D; Mon, 4 Sep 2017 06:41:30 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-6.9 required=2.0 tests=BAYES_00,FREEMAIL_FROM, RCVD_IN_DNSWL_HI autolearn=ham version=3.3.1 Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id B8C972872C for ; Mon, 4 Sep 2017 06:41:29 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1753276AbdIDGl2 (ORCPT ); Mon, 4 Sep 2017 02:41:28 -0400 Received: from mout.gmx.net ([212.227.15.18]:51864 "EHLO mout.gmx.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1753258AbdIDGlZ (ORCPT ); Mon, 4 Sep 2017 02:41:25 -0400 Received: from localhost.localdomain ([45.32.39.184]) by mail.gmx.com (mrgmx002 [212.227.17.184]) with ESMTPSA (Nemesis) id 0M23zf-1dVaUj3KdX-00tymS; Mon, 04 Sep 2017 08:41:23 +0200 From: Qu Wenruo To: linux-btrfs@vger.kernel.org Cc: dsterba@suse.cz Subject: [PATCH 5/5] btrfs-progs: Doc/mkfs: Add explanation for rootdir parameter Date: Mon, 4 Sep 2017 15:41:10 +0900 Message-Id: <20170904064110.25951-6-quwenruo.btrfs@gmx.com> X-Mailer: git-send-email 2.13.3 In-Reply-To: <20170904064110.25951-1-quwenruo.btrfs@gmx.com> References: <20170904064110.25951-1-quwenruo.btrfs@gmx.com> X-Provags-ID: V03:K0:Qk1dmlLniw2+MYenjT3PeJG3m9uBXKghz691/+ann7I4FJ66aEq O8PZW9CWtuKVH1Pk7AMU0Z7Ob5oyN7DgvwTfz8h9pNIihvfZiGql/7NAcRXgwOT45zWoDTS e6I7MnXEMEUu15DA6wKrvTyy2wuyIubMioZUYMeYyBmRS0kky/kUdZZ/G7R/SllsWoh0vod 4IdxPNcw4KavW5Zf0XlpA== X-UI-Out-Filterresults: notjunk:1; V01:K0:g7reqyK0X8k=:3V3Pt64GrYvHypd5LeVDuZ F+JK2FjpH/NDzMWdZmoWgoE1o5sz9PJMzVoFbWl8TSuQaUY61OGvpLgpVQzKKlvdch0J4LJcj vR0rTpWa87jLvy4z5eV6ySC8CrqBGEW5VOc+XoFQqOnp04h0kQqnuLfl7yY2JRjLoxTfxsMW8 J7oPVhIvzGme+rumOKrNwFPoLK0CI/r+TtDlx7efLjd/RnDtkG5vi31Ec96jfldj6K+SX04Mq +yESocnIQrqx1JmEeBe0GxELf9PZw8nzk8LczclJySowZjjbeguR7+8jXaQ6L4GdX1qZ5WPjl xZ91gtXmul0aYnKlx0OGX2f9UxffFi0g4nutEY+xpHDLaSMIVWWObwnwt+xUiVaGZWdN9grZ9 z/EdQcg0QqJM1PaJnpVmkXYedwQtUEvr3AnpIIQJqAK7rzXV+ksyRYJlD1YFWxlVtppzsF14R +t9VDBO3/kPyPaxjaMeA9S8bgzWYG+cXF2JyhCpYswQ7kgxV1iWAf/CmZJVLTD/ap15evNL9K o2Pl2MMLcVdNw0GJm3M6oisMKNvQ3e5wnv7Py5s3p6hfkyw1cjKJmngyhvGF07/DPBMmUWDZb 0JUkGG2lFxOqOLb5oEzK0CQ0H4UEqeQaBC7LrLNIuS9bby1Ny7TYywhy6OzvJgO/JKkUf2N1y PIhtZgXF47Vp/4A47N5zw67mTa9Lc4NICk+sz9hBAZ2BA4MMHlDHdpSatV8fCGwjC6DfjTdn0 xIkY33uRQsNI+Tdj/Yri4QKX3w7pcte5u68iCwtq74CASlwUf5gGzOeTXWZXOUwHQfJS2Oq6C +IdxqGrciPJI4VEGOZ4BzCSTuAdjQ== Sender: linux-btrfs-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-btrfs@vger.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP Original --rootdir parameter will shrink the filesystem to its minimal size, which is quite confusing for some users. Add extra note for this behavior. Reported-by: Goffredo Baroncelli Signed-off-by: Qu Wenruo --- Documentation/mkfs.btrfs.asciidoc | 3 +++ 1 file changed, 3 insertions(+) diff --git a/Documentation/mkfs.btrfs.asciidoc b/Documentation/mkfs.btrfs.asciidoc index d53d9e26..8977761f 100644 --- a/Documentation/mkfs.btrfs.asciidoc +++ b/Documentation/mkfs.btrfs.asciidoc @@ -106,6 +106,9 @@ Please see the mount option 'discard' for that in `btrfs`(5). *-r|--rootdir *:: Populate the toplevel subvolume with files from 'rootdir'. This does not require root permissions and does not mount the filesystem. ++ +NOTE: Result btrfs will be shrink to it minimal size, exceeding space will not +be accessible unless resized. *-O|--features [,...]*:: A list of filesystem features turned on at mkfs time. Not all features are