From patchwork Mon May 11 08:08:54 2015 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Qu Wenruo X-Patchwork-Id: 6373901 Return-Path: X-Original-To: patchwork-linux-btrfs@patchwork.kernel.org Delivered-To: patchwork-parsemail@patchwork1.web.kernel.org Received: from mail.kernel.org (mail.kernel.org [198.145.29.136]) by patchwork1.web.kernel.org (Postfix) with ESMTP id 314199F3E9 for ; Mon, 11 May 2015 08:09:20 +0000 (UTC) Received: from mail.kernel.org (localhost [127.0.0.1]) by mail.kernel.org (Postfix) with ESMTP id 48E4D2035E for ; Mon, 11 May 2015 08:09:19 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.kernel.org (Postfix) with ESMTP id 4B1A32037F for ; Mon, 11 May 2015 08:09:18 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752728AbbEKIJP (ORCPT ); Mon, 11 May 2015 04:09:15 -0400 Received: from cn.fujitsu.com ([59.151.112.132]:6243 "EHLO heian.cn.fujitsu.com" rhost-flags-OK-FAIL-OK-FAIL) by vger.kernel.org with ESMTP id S1752661AbbEKIJK (ORCPT ); Mon, 11 May 2015 04:09:10 -0400 X-IronPort-AV: E=Sophos;i="5.04,848,1406563200"; d="scan'208,217";a="91967363" Received: from unknown (HELO edo.cn.fujitsu.com) ([10.167.33.5]) by heian.cn.fujitsu.com with ESMTP; 11 May 2015 16:05:12 +0800 Received: from G08CNEXCHPEKD02.g08.fujitsu.local (localhost.localdomain [127.0.0.1]) by edo.cn.fujitsu.com (8.14.3/8.13.1) with ESMTP id t4B87lfj028793 for ; Mon, 11 May 2015 16:07:47 +0800 Received: from localhost.localdomain (10.167.226.33) by G08CNEXCHPEKD02.g08.fujitsu.local (10.167.33.89) with Microsoft SMTP Server (TLS) id 14.3.181.6; Mon, 11 May 2015 16:09:10 +0800 From: Qu Wenruo To: Subject: [PATCH v2 13/13] btrfs-progs: Update Doc for btrfs-property Date: Mon, 11 May 2015 16:08:54 +0800 Message-ID: <1431331734-11714-14-git-send-email-quwenruo@cn.fujitsu.com> X-Mailer: git-send-email 2.4.0 In-Reply-To: <1431331734-11714-1-git-send-email-quwenruo@cn.fujitsu.com> References: <1431331734-11714-1-git-send-email-quwenruo@cn.fujitsu.com> MIME-Version: 1.0 X-Originating-IP: [10.167.226.33] Sender: linux-btrfs-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-btrfs@vger.kernel.org X-Spam-Status: No, score=-6.9 required=5.0 tests=BAYES_00, RCVD_IN_DNSWL_HI, T_RP_MATCHES_RCVD, UNPARSEABLE_RELAY autolearn=ham version=3.3.1 X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on mail.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP Update offline related new function for btrfs-property. Signed-off-by: Qu Wenruo --- v2: Seperated from previous patch. --- Documentation/btrfs-property.asciidoc | 17 ++++++++++++++++- 1 file changed, 16 insertions(+), 1 deletion(-) diff --git a/Documentation/btrfs-property.asciidoc b/Documentation/btrfs-property.asciidoc index 8b9b7f0..c7239ef 100644 --- a/Documentation/btrfs-property.asciidoc +++ b/Documentation/btrfs-property.asciidoc @@ -32,7 +32,8 @@ The '-t ' option can be used to explicitly specify what type of object you meant. This is only needed when a property could be set for more then one object type. + -Possible types are 's[ubvol]', 'f[ilesystem]', 'i[node]' and 'd[evice]'. +Possible types are 's[ubvol]', 'f[ilesystem]', 'i[node]', 'd[evice]' and +'o[ffline]'. + Set the name of property by ''. If no '' is specified, all properties for the given object are printed. '' is one of @@ -44,6 +45,20 @@ label:::: label of device compression:::: compression setting for an inode: lzo, zlib, or "" (empty string) +fsid:::: +fsid for an offline btrfs: 36 bytes UUID string in `printf`(3) format: +"%08x-%04x-%04x-%04x-%012x" +chunk_tree_uuid:::: +chunk tree uuid for an offline btrfs: 36 bytes UUID, same as 'fsid'. + + +NOTE: To use 'fsid' and 'chunk_tree_uuid' in 'offline' type, '-t offline' must +be specified explicitly, as most offline operation are dangerous and user +should be aware of the danger. + +WARNING: If process of changing 'fsid' or 'chunk_tree_uuid' is canceled, the +filesystem will not be mountable as it is in a inconsistent status. To make it +mountable again, the uuid change needs to be reran and ensure it completes. *list* [-t ] :: Lists available properties with their descriptions for the given object.