From patchwork Thu Oct 29 23:17:38 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Daniel Xu X-Patchwork-Id: 11867889 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-12.8 required=3.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_PATCH, MAILING_LIST_MULTI,SIGNED_OFF_BY,SPF_HELO_NONE,SPF_PASS,URIBL_BLOCKED, USER_AGENT_GIT autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 33968C4742C for ; Thu, 29 Oct 2020 23:18:15 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id A99842076E for ; Thu, 29 Oct 2020 23:18:14 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=pass (2048-bit key) header.d=dxuuu.xyz header.i=@dxuuu.xyz header.b="H66bcqMq"; dkim=temperror (0-bit key) header.d=messagingengine.com header.i=@messagingengine.com header.b="XfXbS9i8" Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1726033AbgJ2XSO (ORCPT ); Thu, 29 Oct 2020 19:18:14 -0400 Received: from out1-smtp.messagingengine.com ([66.111.4.25]:37337 "EHLO out1-smtp.messagingengine.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1725785AbgJ2XSN (ORCPT ); Thu, 29 Oct 2020 19:18:13 -0400 Received: from compute3.internal (compute3.nyi.internal [10.202.2.43]) by mailout.nyi.internal (Postfix) with ESMTP id 7EB545C0108; Thu, 29 Oct 2020 19:18:12 -0400 (EDT) Received: from mailfrontend2 ([10.202.2.163]) by compute3.internal (MEProxy); Thu, 29 Oct 2020 19:18:12 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=dxuuu.xyz; h= from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; s=fm1; bh=AXuYrhu3YPP81 ZrepInzGdwzWKZJiZkCsNS+VW9ucCA=; b=H66bcqMqwdW4YHUZY6mLdVT/ZtoIf a7Jeyh7z8hP2lsG0EKHv4rl8uqZ5MNqZgvu3j/lLl8CzXPsO0MEndKufhs+K2I+t zhuANNYhbE5Tjbra3yT2z32wfFOfwm3uNGG4fMgyT+9VuRupTTMTRlzUw5afKDOM c4AdqjpNLrnQDXIxVBQ89NAKacN/bfXQRgatzAJ0Mt4C/mgmNmUyv7A9wZe3Gy/P PXk7lxDLD8thbmQ4X3z0dPMiQguODjYKl2WU50XJqBncWayKSAHoemdYpWMI0PcS 9/vOm4l2X97rehrH0x75OTFDESLOxgqiJlfUhr23QaI+vNMoa/rvLMXAA== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-transfer-encoding:date:from :in-reply-to:message-id:mime-version:references:subject:to :x-me-proxy:x-me-proxy:x-me-sender:x-me-sender:x-sasl-enc; s= fm1; bh=AXuYrhu3YPP81ZrepInzGdwzWKZJiZkCsNS+VW9ucCA=; b=XfXbS9i8 V6fmQ+0OrhI8VeEPtNRNFtR9V4Ytsi2pY1VrEzLCXerRR3nCn+Yp3I6uFeRrGDS8 ep6aO4DbJp1jIzL7MO5OQ4qJHhmaSujNSO5h3zVHttcSu/i4HzM0fEtci/SNGzeg Tso+IlvpKAPlN2hiRBNqfQHcMYTvAABn2cSE6OC7oB/2srUlZ+Q35H1reKLRwXQi WjIVSUOggPhvk5f8YAV98xwmDEENDhC6uxqRLMJDueGk8zdXh4gMfuQbLskWfZLg N+B8x8GUfum45x4YTg6MTL728oxYoU2fnmWWxPBRVbGNMnb2TKsM+IjNac3PwkOe BWcvoNeOSjsUxg== X-ME-Sender: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedujedrleeggddtkecutefuodetggdotefrodftvf curfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfghnecu uegrihhlohhuthemuceftddtnecufghrlhcuvffnffculdejtddmnecujfgurhephffvuf ffkffojghfggfgsedtkeertdertddtnecuhfhrohhmpeffrghnihgvlhcuighuuceougig uhesugiguhhuuhdrgiihiieqnecuggftrfgrthhtvghrnhepgfekudelkefhteevhfeggf dvgeefjeefgfeuvddutdfhgffghfehtdeuueetfeeinecukfhppeduieefrdduudegrddu fedvrddunecuvehluhhsthgvrhfuihiivgeptdenucfrrghrrghmpehmrghilhhfrhhomh epugiguhesugiguhhuuhdrgiihii X-ME-Proxy: Received: from dlxu-fedora-R90QNFJV.thefacebook.com (unknown [163.114.132.1]) by mail.messagingengine.com (Postfix) with ESMTPA id BD80C3064674; Thu, 29 Oct 2020 19:18:11 -0400 (EDT) From: Daniel Xu To: linux-btrfs@vger.kernel.org, dsterba@suse.cz Cc: Daniel Xu , kernel-team@fb.com Subject: [PATCH 3/3] btrfs-progs: rescue: Update docs with create-control-device Date: Thu, 29 Oct 2020 16:17:38 -0700 Message-Id: <41ce291ac76b461c891ae64fbe18dcbb723178ef.1604013169.git.dxu@dxuuu.xyz> X-Mailer: git-send-email 2.26.2 In-Reply-To: References: MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-btrfs@vger.kernel.org This commit updates the documentation for the new `btrfs rescue create-control-device` subcommand. Signed-off-by: Daniel Xu --- Documentation/btrfs-man5.asciidoc | 8 +++++++- Documentation/btrfs-rescue.asciidoc | 5 +++++ 2 files changed, 12 insertions(+), 1 deletion(-) diff --git a/Documentation/btrfs-man5.asciidoc b/Documentation/btrfs-man5.asciidoc index 65352009..082599c1 100644 --- a/Documentation/btrfs-man5.asciidoc +++ b/Documentation/btrfs-man5.asciidoc @@ -898,12 +898,18 @@ filesystem module: * get the supported features (can be also found under '/sys/fs/btrfs/features') The device is usually created by a system device node manager (eg. udev), but -can be created manually: +can be created manually with: -------------------- # mknod --mode=600 c 10 234 /dev/btrfs-control -------------------- +or with: + +-------------------- +# btrfs rescue create-control-device +-------------------- + The control device is not strictly required but the device scanning will not work and a workaround would need to be used to mount a multi-device filesystem. The mount option 'device' can trigger the device scanning during mount. diff --git a/Documentation/btrfs-rescue.asciidoc b/Documentation/btrfs-rescue.asciidoc index af544372..db40ce64 100644 --- a/Documentation/btrfs-rescue.asciidoc +++ b/Documentation/btrfs-rescue.asciidoc @@ -93,6 +93,11 @@ the log and the filesystem may be mounted normally again. The keywords to look for are 'open_ctree' which says that it's during mount and function names that contain 'replay', 'recover' or 'log_tree'. +*create-control-device* :: +Creates /dev/btrfs-control control device ++ +This command is for convenience when *mknod* is not installed on a system. + EXIT STATUS ----------- *btrfs rescue* returns a zero exit status if it succeeds. Non zero is