From mboxrd@z Thu Jan 1 00:00:00 1970 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 99984C25B4E for ; Sun, 22 Jan 2023 10:20:12 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229788AbjAVKUL (ORCPT ); Sun, 22 Jan 2023 05:20:11 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:53070 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229987AbjAVKUK (ORCPT ); Sun, 22 Jan 2023 05:20:10 -0500 Received: from mx0b-00069f02.pphosted.com (mx0b-00069f02.pphosted.com [205.220.177.32]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id D2FE71E9F6; Sun, 22 Jan 2023 02:20:08 -0800 (PST) Received: from pps.filterd (m0246632.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.17.1.19/8.17.1.19) with ESMTP id 30M4uMSK018855; Sun, 22 Jan 2023 10:19:58 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=message-id : date : from : subject : to : cc : references : in-reply-to : content-type : content-transfer-encoding : mime-version; s=corp-2022-7-12; bh=SMA9KbT/Wzg9El37iDuPDmmJj0sy/jNh066E90ifcwo=; b=nA4eP8E7K8lAMtlUFyWsbh8u3JQEFJXJbBNUHnHz7DM99h/HeOGJ9hCrY2imNRbpqFYd JVvAkfrDKpbloatgntjqsNtffO+A9uRt60Zx/pVCh0VuZe3UZN/Zp4zXUNSxglTCNJxf npySs1+qPezC1c0+nP4JRmZxLmiySwpMmlGD3a4Ab36u2IhmZbGB2w5dxxgUSQ98/ie5 U5Om2IvRylIkTrhwb4C5t2bZtefER4yHHyg+44eLeJN6uipXKI2rpDFGodsS0iYpRcP4 IDhRwngO2JXp2qcJy0ncx0AEBUoDMIpLxzr9eqS5/qWwiw/yVccZWAsCNSiNLOgnYgZB Nw== Received: from iadpaimrmta02.imrmtpd1.prodappiadaev1.oraclevcn.com (iadpaimrmta02.appoci.oracle.com [147.154.18.20]) by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 3n87nt19ns-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sun, 22 Jan 2023 10:19:58 +0000 Received: from pps.filterd (iadpaimrmta02.imrmtpd1.prodappiadaev1.oraclevcn.com [127.0.0.1]) by iadpaimrmta02.imrmtpd1.prodappiadaev1.oraclevcn.com (8.17.1.5/8.17.1.5) with ESMTP id 30M9NUgR004800; Sun, 22 Jan 2023 10:19:58 GMT Received: from nam12-dm6-obe.outbound.protection.outlook.com (mail-dm6nam12lp2177.outbound.protection.outlook.com [104.47.59.177]) by iadpaimrmta02.imrmtpd1.prodappiadaev1.oraclevcn.com (PPS) with ESMTPS id 3n86g97xgv-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sun, 22 Jan 2023 10:19:57 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=PAiJ5qNd7Uw1UHmC0MGlfY14DbD8YpZVrxefnsHQQ3x7/3IahZatGdjovmvqzuBIPh9l3fNOcZ7d0LGMJM61WMxbO0Rxay4aWVSJO+GA/4ESBkHbjNnCydm2Hih1/94gFZHg73kpe+mzUWPwdZQYXZBKg4kRx/8CVzT3O2dkRF01xAQhLna/ACgsO0nmLpggxOcP6XWmNjSqh7HtJVZFmNJglnAUXSMVEa0722DXlMxma4PCY7yYwf92i07YKXq+1wsPBRKdc0IrMOhPJ+umgniZdEeE/fZu45aWe8TN784MRPesD8qX/1tJdBQzgfoDvrXVtkkt/9Ld6fuMjzymOw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=SMA9KbT/Wzg9El37iDuPDmmJj0sy/jNh066E90ifcwo=; b=gGvcRXEcwsXrGJdxSbSmBZb7drEK3ANgSDI4j4Q6U7WHPgurPZ4UdOfl2O7Izl88f4deM+FWZmAlxkPEARWF4wCbDzE6ucDrAvdxHH5ZgenDf3OwNIW+00QdD54bRGm2xlSb/S3c4VNfejk1xJKy4CDUWLmK1XFkPCDgSRJc6EAd8uYKLhQeLxKfjxRk4o3NPb++okArxUZ83ZRsQ1DPoT15NB226iYBIjB7KXnQ3c6GdkQPQcXJtrVfzrlvXDs0dJmTdYVAhJMdNqfAhpknhVLOGuGjO/+TYrs+X4vMFrcS16v4iSw6Cgr45r9McZb3ZA2LLS14aHGUHr3mimb6PA== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=oracle.com; dmarc=pass action=none header.from=oracle.com; dkim=pass header.d=oracle.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.onmicrosoft.com; s=selector2-oracle-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=SMA9KbT/Wzg9El37iDuPDmmJj0sy/jNh066E90ifcwo=; b=hw4Fy3a+ZOwf79An84RlPXZ79HboMmiq7DnBaa2VohAm4Xk+rQZzrUOC2hikoBFwpG3lnirJ+DPKyBDwYU0jIpT1PZyWR4tyLFOxf0IOJPffNgBpzPBeVZrvrSKcdsSNpJ8sZwma+Uz+LBnS0seMBuov/b1+zK9Vw39u+AMQqbo= Received: from PH0PR10MB5706.namprd10.prod.outlook.com (2603:10b6:510:148::10) by PH7PR10MB5724.namprd10.prod.outlook.com (2603:10b6:510:125::11) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6043.9; Sun, 22 Jan 2023 10:19:56 +0000 Received: from PH0PR10MB5706.namprd10.prod.outlook.com ([fe80::560e:9c52:a6bd:4036]) by PH0PR10MB5706.namprd10.prod.outlook.com ([fe80::560e:9c52:a6bd:4036%8]) with mapi id 15.20.6043.009; Sun, 22 Jan 2023 10:19:55 +0000 Message-ID: Date: Sun, 22 Jan 2023 18:19:45 +0800 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:91.0) Gecko/20100101 Thunderbird/91.3.0 From: Anand Jain Subject: Re: [PATCH 02/34] btrfs: better document struct btrfs_bio To: Christoph Hellwig , Chris Mason , Josef Bacik , David Sterba Cc: Damien Le Moal , Naohiro Aota , Johannes Thumshirn , Qu Wenruo , Jens Axboe , "Darrick J. Wong" , linux-block@vger.kernel.org, linux-btrfs@vger.kernel.org, linux-fsdevel@vger.kernel.org References: <20230121065031.1139353-1-hch@lst.de> <20230121065031.1139353-3-hch@lst.de> Content-Language: en-US In-Reply-To: <20230121065031.1139353-3-hch@lst.de> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit X-ClientProxiedBy: SG2PR02CA0053.apcprd02.prod.outlook.com (2603:1096:4:54::17) To PH0PR10MB5706.namprd10.prod.outlook.com (2603:10b6:510:148::10) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: PH0PR10MB5706:EE_|PH7PR10MB5724:EE_ X-MS-Office365-Filtering-Correlation-Id: a74338f1-8d1d-4219-3121-08dafc6234e2 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: q+1Ua3anU+9SfXZfjNDIgRwun2bxLT/fdvVsV9IYbnMKogYCbr5sfLiZS8qU8es0SoKI/RB/PoA9u4KQ0uZVLEjYIiFX2FCtQ8VUaMXXhRnKwKOXXjTMrxSVLcx6V3MTqL1yP6UyVTyhWvPdU4codQ0bK9nCxdNWXpCN6lmtOaMZW509rDPWCFGWMY9+C8qcz39CSk/IgjqRDOibLctXN/hOzbQbUcUs1PA5o4fJSpnFvqGzReExuvpRnVQQr6DgvoK07Am5ieKBCmYzrdaRESaaKY/Xz8YbUtK6yFDoR3fT7q2k74FRJYFTBZrDqmnRy/tx1lnVTn/IU6DoPLBCWeRx1UGAbhy1yuIi+rvPtOob8GSnMLhKG/fcZuoWgVx0MMy9oOzGszrXw6qNQU10fN1DNxApfCnl4+D8fBZWgVYD0kVNF9Mo/m1xEy8pK20nzp+wcE/t7gNdvZJHLnhrACXci+/Z40UtHJ1NT/NaTodlevzVRJvs4hicfnPSoLv2wu007ZQrEBtqg2zlmR2cWu/3BKI4OPBybWfOkwPb5z44Ii3QeRLtsOgoHKr2P5wb7qFumO2c0ZCvH7AP5eUGMlFg85MBTaMAYiXV56GwbuxKqhm+AEywUk+Jw79YeOqzq4PpiQ7a7/uy/7loTLH+GS097myExBzJynr2lyoN3HmPIAqABY9Cv3qQ/Ywizc6CiyitpYy37HXA8OiPUS8fJ4BgHmO61SUgpMOhdU8VjRc= X-Forefront-Antispam-Report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:PH0PR10MB5706.namprd10.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230022)(376002)(396003)(366004)(136003)(39860400002)(346002)(451199015)(36756003)(2616005)(558084003)(316002)(66946007)(66556008)(66476007)(4326008)(110136005)(8676002)(54906003)(19618925003)(7416002)(2906002)(31696002)(5660300002)(44832011)(31686004)(6666004)(26005)(6506007)(186003)(6512007)(6486002)(478600001)(4270600006)(41300700001)(38100700002)(86362001)(8936002)(45980500001)(43740500002);DIR:OUT;SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?B?RTFqaFJlTmxiNU0rSWErR0h6dStMdnBLU3JIa2gwaVpMOFNnVnQwNXBtVEpG?= =?utf-8?B?TEQvVE5UcWcxV1g2RnkwZk5Md1ByR2VZM0FBM2h0M25hS2ZLNnp3NURhK29v?= =?utf-8?B?c3BhT3Y1c2lWNnk4aFFGOWhYT2ZZZUs4RlJDTGhFdzJRZys2SmJhZlVTeFRl?= =?utf-8?B?Q2xYYXcyUlNRZmwrcFZocXkrQkJlRzhLWEJabE9TR0czVGIvVlVDQmNFeWs2?= =?utf-8?B?RnpKNVdNK3hyemYweVFxM1VkU3gzRVJiV0M5ZWQyN284TTdRZXpKNVpSZHJR?= =?utf-8?B?bjNSd3IwQjYwcmFxeVhBenlXS0JZZldETTA1YjJLTjlKSjBZU3FoV2dtSWFX?= =?utf-8?B?ZEhKeGJJUVh5K1dqZTdKYi80cFN3ZmkxRjVkbFNaWkdiQTBic2lZOVNvSUVN?= =?utf-8?B?SXVuQjE0TDgzNmN4WE5yalh0amJLWVNFd3p3ak9VblZxRy9BcDRacXRCcWtw?= =?utf-8?B?cXczc2NnSkl4WkE3R2ErRUoyRXpVSTlmNXdJVmZzREZjOTYvcmFacVFCNFFU?= =?utf-8?B?VjgwR3ozSVJEQjJOK05WQkVVRS9RdS91UTNBaXFOR2ZERHlTZ0ZQa3paaVZF?= =?utf-8?B?S2xwWlB6cFpaQjltVEE4NHpGaUNxSUhrVUlJRndmU2U5WUtQbCt4dkJOcHoz?= =?utf-8?B?bnpadEZOOEpkSldyTy9YTnBMekdrYXJpKzdYRS9Ud2Y1dllNemQreDRYaGVk?= =?utf-8?B?Q0N4U3l1TjNsdEMyR3JadEN1c29JYUZkMlJLUGF6SzZsTForR2g0cmEvQjlV?= =?utf-8?B?S1NkanVuNFBlRlpQTGNRRisxekZlbEtEU1hCQnY0WTlpOUszRXVSUXVkZzZE?= =?utf-8?B?N0tzSTk4aXdKdU9UUFgyL2w4Yy9DYThtOEdsOHRXNnhmLzV3TVAreGZGUEs5?= =?utf-8?B?Vmo1UUcxWklmUE5VWnNlNUVMTjFvMnBybjdJa3I3SUxpbnBHci9PRU9sV0pS?= =?utf-8?B?THkybWphR1Bka3UrbGdWZnB4Y0wwbTdsOWlXVWNISnFZajhBY21IVE9Ra2Zx?= =?utf-8?B?a2FTZmxvRVIwYU5pSzlQQjNUNFcyZVlYMjRUVE4rNWdBb00xRHNEYW5SbldT?= =?utf-8?B?cWY5SUNVU0hmbmpvOGNuOUpraHhJakRCaGFpcjhSUGJmVmU3NHozK0l4ZElE?= =?utf-8?B?WTR0ZU1RL0VlL3E1L0tqR1hKb0xXVFNUR2s5NDZJL2ZUTHpVQ0V5NjNKQzJt?= =?utf-8?B?RVhWZENYVTZCR2F6YmlFek0xeVpucVRsZDVxVjdxSTJkZ3BtYmtES2RHUDJO?= =?utf-8?B?cGdVUlhEc2FLMHJzOHl6ek5sQ2dsc2dKU091SzRZNHlCaEkwUGNkMUlhbnNm?= =?utf-8?B?ZXVqMXhTTlhXMnBWQUlPTnRZOXVkN05tRWVpdFJzc3hTbnFhb0E0czlhVVVi?= =?utf-8?B?WkE2aWxoYlNSRURYa1hBbXppM0g4MEJVQ3RudEtmTlBYc0FtTEl4dmFsT2JR?= =?utf-8?B?NWJZYXpKZ0h6MmYzNW5CVXVVQjRWUHl5NlUrcC93V01SalYrVmk2bGxkUzhs?= =?utf-8?B?RTFjQVg2Q3F6a2pRS0M1QXVoajZZeVdxM1dEYllFdlY4eDBTVmdxSTAzN0VG?= =?utf-8?B?cHRkNmJLa1hvNURDcUI4LzhhK3p1SHRUVW0vaXBnOVNMcXdrNVhSOGNRNDFE?= =?utf-8?B?N29HWWFBZk5wVWlsblZCT2E0YnFtM0JMRVNpZ0EySnVQaTcrZjRpa0JNUWtz?= =?utf-8?B?WEtnYkVheGNrR1VtQlJZQTZIamI2ajVaelU5OUVpQm9iejgxbkZUb3BZdU5V?= =?utf-8?B?cHpOcnBXeHhBWnJSSFRSSkZvSlozYnFvdmhmN0NIYVZhdWdKQVJId1BEYWds?= =?utf-8?B?UFlITWt1R2lGb3FxZFpyTlZYVTUwbGRpVTRpMVF0K1lsVWswNG1wS29idUpJ?= =?utf-8?B?bnBBSzhMd0xpM3BrMmNkQ3l5aEozZzZtWmV4bTVBZUFUVDBsczZsSEpFSDUr?= =?utf-8?B?Rlk4S3NoekIxQUttMjVMNHJIOGNWWXM1RGtnNjc0WTNIUnFPQUJTRkF3QVlC?= =?utf-8?B?UUwreGNLTlNiT0tMWkM3U21oMnYweU5wZitVTCtzUTkwcFp2WmNjSEEwdm5j?= =?utf-8?B?cEg2aXdBWDlEWExyd0V2TXBpM2ZHMHFmdk5tOG1FZlNmakxsdDV1cldBeFdq?= =?utf-8?B?WStMUjREcjdLaDdPT25EamJ5alA0aDlzYXFsOWpsdTRubmNpdVcvSVlKTnlx?= =?utf-8?B?Q3c9PQ==?= X-MS-Exchange-AntiSpam-ExternalHop-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-ExternalHop-MessageData-0: =?utf-8?B?NEJxNTZ6eGZXbGhwTWs1c242MHByTG9BVW1qaktDSHFjdGx0THRCMHNDK2Uy?= =?utf-8?B?M2UwTGthMEtSWWpsZCtrRGtnaTZqSzRzbm5QLzk0S0k4REVEU04zSnIzZjd3?= =?utf-8?B?bi8rdG9LMURVbkFDQnJPeEJHZTBxemJiRitoSjlqUTczQ2JiKzdiN21SdjUw?= =?utf-8?B?UFpIVU9JOVBBVUpjYlhTY09nVWVrRThUVGR6eU84ZWNyVytacGF4T1ZPVnRP?= =?utf-8?B?NHRLYmc0a0w1RWN4dUh6REZYUE1PVllrZzQ5MFNhUW9CYnZFMHhpaXZ6bDhp?= =?utf-8?B?SStnUFhwYkpBWjJqZndCcHNNTDYvR1RoWjQ3VlBqSDZpdHZPY1ZENnJ1MXRO?= =?utf-8?B?ajhTamY4dGNwM0I4eERhWXVsZFNURDRJWVUrT1R1UWJQd0lUOSswaThhUTRF?= =?utf-8?B?N0VoN0FSaUl3RTU0MGxDTzkvSit3TCs3Y0lNZ3pyT0VSNnJLanhpdDJsdWpo?= =?utf-8?B?NmdGa3c0aFhmeHFkalZ0eVVXdHBBaFZNQ2UySnRuRjQxK0NNNWhLVzY2Qm51?= =?utf-8?B?MTlhVlpTeHFob0VwVkhlbEM0aDV0VGlZTEZ0ZStWeThWNDlDZU1haVNsejJP?= =?utf-8?B?REliMzFGZkJQOVBOMjVuKzd4NzYyVDdKNXhWSXZHMy85TTM4czhGS2luUDh6?= =?utf-8?B?UUxiVXZDc0JXcGo4QVdoTU5pcitlTmFsdkhMV1g2MHZvQkVqWEJ0N1NZSnBM?= =?utf-8?B?Y0FHZWR6T0NSZlY4djQ2Y2R0RlpPcXU0Vmw5eEFiSVc3cnRZaGF4NSszZ3RV?= =?utf-8?B?T3k3YWM0RC8xVmVzZUVob24zSkNNaUk3a1RnTjlvaGRDSFhUTHlRRFduTFlh?= =?utf-8?B?Unp0eElvMjZxRXZRVEtDRGd2U0hZdVlWRis3b1Eyb3FJNTdhdiszTStUdU9z?= =?utf-8?B?K3FVOUNoK3hGNXd6cnA5bVhRMGlwNnBIRXVidG5BckVQTlhuTG1SQm9LTndT?= =?utf-8?B?YVg5aHUvRkdRTzBkcWhoeE16R2FhSVhkcTZYS0h2Q3JkaEt6V3hLaWdVV1cv?= =?utf-8?B?ZHpFUGdpUDNHUDR0MHh5K0hCaFV1Y2R3MWxJUEJKbTZkZTQ1Q0dMWXdMdzdT?= =?utf-8?B?WnhLME8vajY0b0J4L3NVNndkZ3BETG5qdGMwWkQ3UUgwQUxtNVp2TlBqMGR3?= =?utf-8?B?RTluQzFWcm51RVVDVG4yNk5OSUZ4ODFPVUtoQ2Jud0lDTFQzbHF3SmZlMWhE?= =?utf-8?B?MFBvZmNMQjN6bHFoUVlOc25YM0ZHcGVXVnY0ZDlBV1NTeFo1L25lT2g4ZU9t?= =?utf-8?Q?S2XyrpvnBD87UcO?= X-OriginatorOrg: oracle.com X-MS-Exchange-CrossTenant-Network-Message-Id: a74338f1-8d1d-4219-3121-08dafc6234e2 X-MS-Exchange-CrossTenant-AuthSource: PH0PR10MB5706.namprd10.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 22 Jan 2023 10:19:55.5109 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 4e2c6054-71cb-48f1-bd6c-3a9705aca71b X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: d4gJEmuJqv1QhABuHBBk87mwIKGxKE18NzNAyEBFTLwulerEe9hmHtjRkM5sbtCNRVh46aiC4uIvni5WBOOS+g== X-MS-Exchange-Transport-CrossTenantHeadersStamped: PH7PR10MB5724 X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.219,Aquarius:18.0.930,Hydra:6.0.562,FMLib:17.11.122.1 definitions=2023-01-22_07,2023-01-20_01,2022-06-22_01 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 phishscore=0 mlxscore=0 spamscore=0 bulkscore=0 mlxlogscore=958 malwarescore=0 adultscore=0 suspectscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2212070000 definitions=main-2301220100 X-Proofpoint-ORIG-GUID: c8aFUgRuTTDVWtSM0T6c5RK2QGSIT29Z X-Proofpoint-GUID: c8aFUgRuTTDVWtSM0T6c5RK2QGSIT29Z Precedence: bulk List-ID: X-Mailing-List: linux-block@vger.kernel.org LGTM Reviewed-by: Anand Jain