From patchwork Thu Jan 6 17:49:03 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Goffredo Baroncelli X-Patchwork-Id: 12705610 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 738E1C433FE for ; Thu, 6 Jan 2022 17:49:26 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S242407AbiAFRtX (ORCPT ); Thu, 6 Jan 2022 12:49:23 -0500 Received: from santino.mail.tiscali.it ([213.205.33.245]:56282 "EHLO smtp.tiscali.it" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S242392AbiAFRtR (ORCPT ); Thu, 6 Jan 2022 12:49:17 -0500 Received: from venice.bhome ([84.220.25.125]) by santino.mail.tiscali.it with id fVpB260072hwt0401VpDJf; Thu, 06 Jan 2022 17:49:14 +0000 x-auth-user: kreijack@tiscali.it From: Goffredo Baroncelli To: linux-btrfs@vger.kernel.org Cc: Zygo Blaxell , Josef Bacik , David Sterba , Sinnamohideen Shafeeq , Paul Jones , Boris Burkov , Goffredo Baroncelli Subject: [PATCH 2/2] Update man page for allocator_hint property. Date: Thu, 6 Jan 2022 18:49:03 +0100 Message-Id: X-Mailer: git-send-email 2.34.1 In-Reply-To: References: Reply-To: Goffredo Baroncelli MIME-Version: 1.0 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=tiscali.it; s=smtp; t=1641491354; bh=asotvVmm9NKLTEMVpHnR79w3ucYdvVxl6spURN3HzNg=; h=From:To:Cc:Subject:Date:In-Reply-To:References:Reply-To; b=kz3w09NXGVzF/VViAYegYwNONURF/lE9OTATFgTo/nAi+1YrRjGUHjq/beatMNbdO 1edIbUoCSx3B83Z9aW33sWbiMsFJlZXND3cnT//856N+W6cAPDlCqCkQicEWstMRNI eCT7WJoxltlxtD+LtJEbx1yjyIuIl+t9pZFrRJkg= Precedence: bulk List-ID: X-Mailing-List: linux-btrfs@vger.kernel.org From: Goffredo Baroncelli Update the man page of the btrfs property subcommand to show the use of the device property "allocation_hint". Signed-off-by: Goffredo Baroncelli --- Documentation/btrfs-property.asciidoc | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/Documentation/btrfs-property.asciidoc b/Documentation/btrfs-property.asciidoc index b32d000e..70b01f68 100644 --- a/Documentation/btrfs-property.asciidoc +++ b/Documentation/btrfs-property.asciidoc @@ -49,6 +49,23 @@ device as object. For a mounted filesystem, specify a mount point. compression:::: compression algorithm set for an inode, possible values: 'lzo', 'zlib', 'zstd'. To disable compression use "" (empty string), 'no' or 'none'. +allocation_hint:::: +a device property that instructs how and when the allocator should use a +block device. +Possible values are: +- 'METADATA_PREFERRED': the device has an higher priority when a new metadata +chunk is allocated. Data chunk is allowed only if there is no other possibility. +- 'METADATA_ONLY': the device is used only for metadata chunk. +Data chunk is never allowed. +- 'DATA_PREFERRED' (default): the device has an higher priority when a new data +chunk is allocated. Metadata chunk is allowed only if there is no other +possibility. +- 'DATA_ONLY': the device is used only for data chunk. +Metadata chunk is never allowed. + :::: +The default is 'DATA_PREFERRED'; if all the disks have this setting the +allocator uses all of them with the same priority. + *list* [-t ] :: Lists available properties with their descriptions for the given object.