From patchwork Fri Sep 29 09:37:14 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: John Garry X-Patchwork-Id: 146474 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:cae8:0:b0:403:3b70:6f57 with SMTP id r8csp3902187vqu; Fri, 29 Sep 2023 02:52:49 -0700 (PDT) X-Google-Smtp-Source: AGHT+IHzu21B9bN0MG85nRtRf5LKeonYUxngPbNjuauZgmM1yIr23im38sfYdlG4ZnP3koW5Z4o2 X-Received: by 2002:a9d:6a03:0:b0:6bf:2476:a97e with SMTP id g3-20020a9d6a03000000b006bf2476a97emr3933532otn.5.1695981169692; Fri, 29 Sep 2023 02:52:49 -0700 (PDT) ARC-Seal: i=2; a=rsa-sha256; t=1695981169; cv=pass; d=google.com; s=arc-20160816; b=BEUElk/hU6bhVnmXPkKhokpVYYPuGFrvSr2y8NqYSepw3cmf6QoFrYAoTj+KGsil+3 v9v43xYBJ5SmXSl7EKXrpkB6wj9fKzyVtRv2lotsf+Jyfqmo4THGVHQK88YZOUVPNNph dgCuLcVl2n0DC554y+3sQevoYc8ubc8OEuZ/LfC0aFr4TSkpq444psPbe6sMvDhKjDsh S1O774chE/D+fCUCzorCXS1pODig69M7bNpJr5FYZuMRVtPCGRpmgn5HDTeaUf6RGLuj Hp8X/GsocwfxsVkDdoIQVC/I/OKDcGWmeEXZzWnHKJcUmfrt8MDwko/dAgnHj6VPhtYb 8THw== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:mime-version:content-transfer-encoding :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature:dkim-signature; bh=H70Kb5To4c+I7RjuZVipuDWhe9KKC9Ipgu212PqVmP8=; fh=R1RNKHRRpWl71R0BDm+HzSMSP7ET7WjXBS6kzq8E2Lo=; b=0+XPnBqw/9n1QHlyqPCh/UkjFQNUf2MoS6M6bPcBOp2fVhWB9V/rs6g+cgSmP7NFbj 4rgKmKOb/NYAnrwBbpyT9XyooJJ5NibyLrjMQtHQS08yypd5F8FeW5jyJgv7NaqzaWSc 4IuaClPEz15cm6bAT/G/OcmP3PmokMd1Knw/TtRF/AbvgzMEnRWmvOFrmqBJ4rnIrpr5 QLOUD8+TZ579R0H495F1UqHB0ZDdlE5zkT7XRqflDpdHYOi1XY5TN/dumNvQfM0G61rL BidagRwoIAkqPyTjVs0lDZ1j1gN1mmywZO2HyR1fTFfiqZFH/Rr2zzHxkx4K+CMNQlpk ccEA== ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@oracle.com header.s=corp-2023-03-30 header.b=WgNJaGcl; dkim=pass header.i=@oracle.onmicrosoft.com header.s=selector2-oracle-onmicrosoft-com header.b=w78dflW6; arc=pass (i=1 spf=pass spfdomain=oracle.com dkim=pass dkdomain=oracle.com dmarc=pass fromdomain=oracle.com); spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:7 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=oracle.com Received: from snail.vger.email (snail.vger.email. [2620:137:e000::3:7]) by mx.google.com with ESMTPS id u29-20020a63141d000000b00578acf1e8a3si20414344pgl.576.2023.09.29.02.52.49 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 29 Sep 2023 02:52:49 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:7 as permitted sender) client-ip=2620:137:e000::3:7; Authentication-Results: mx.google.com; dkim=pass header.i=@oracle.com header.s=corp-2023-03-30 header.b=WgNJaGcl; dkim=pass header.i=@oracle.onmicrosoft.com header.s=selector2-oracle-onmicrosoft-com header.b=w78dflW6; arc=pass (i=1 spf=pass spfdomain=oracle.com dkim=pass dkdomain=oracle.com dmarc=pass fromdomain=oracle.com); spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:7 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=oracle.com Received: from out1.vger.email (depot.vger.email [IPv6:2620:137:e000::3:0]) by snail.vger.email (Postfix) with ESMTP id 31420804E442; Fri, 29 Sep 2023 02:38:49 -0700 (PDT) X-Virus-Status: Clean X-Virus-Scanned: clamav-milter 0.103.10 at snail.vger.email Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S233023AbjI2Jij (ORCPT + 20 others); Fri, 29 Sep 2023 05:38:39 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:55958 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S233014AbjI2Jic (ORCPT ); Fri, 29 Sep 2023 05:38:32 -0400 Received: from mx0a-00069f02.pphosted.com (mx0a-00069f02.pphosted.com [205.220.165.32]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 299771A8; Fri, 29 Sep 2023 02:38:30 -0700 (PDT) Received: from pps.filterd (m0246629.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.17.1.19/8.17.1.19) with ESMTP id 38SK9TWV022472; Fri, 29 Sep 2023 09:38:17 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=from : to : cc : subject : date : message-id : in-reply-to : references : content-transfer-encoding : content-type : mime-version; s=corp-2023-03-30; bh=H70Kb5To4c+I7RjuZVipuDWhe9KKC9Ipgu212PqVmP8=; b=WgNJaGclR+r+gj0VDL+VxElWdzeO8kLFd5/9VKvkmxga0jldKSJz4e9W7pONbnfFYNLV OIrTpJzKuk0VdRHT7UPs1e2cBWSIlRoUgq5NkCULKg01ioC5KUj/l4r5T/f4XLB0PbZ+ uCaJO6pb7xB/RIb1G1Tp6hzP4S/mRes76isq5moytUFOQaruf4JRZrZSQS5+wT3qvgZN jmCC3l6iXh/AmsPqlBN496B83DpPaGQv4OdZAFV4uVJk2JP2K272NALip85FQwOw5Jc+ 0WRtaLblgjXRZo5wIMzoPUUtGUB8TbL4/dyNF5R+YpT7FAHWhU/SyhaPkHKMtUVDYxvN 8A== Received: from phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (phxpaimrmta03.appoci.oracle.com [138.1.37.129]) by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 3t9qwbp9hx-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 29 Sep 2023 09:38:17 +0000 Received: from pps.filterd (phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com [127.0.0.1]) by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (8.17.1.19/8.17.1.19) with ESMTP id 38T7msw3014617; Fri, 29 Sep 2023 09:38:16 GMT Received: from nam11-bn8-obe.outbound.protection.outlook.com (mail-bn8nam11lp2168.outbound.protection.outlook.com [104.47.58.168]) by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (PPS) with ESMTPS id 3t9pfbk60g-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 29 Sep 2023 09:38:16 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=HD1HXmkkyaJHePN5SCuR3tma/EZlO5e9n+sboUHScFsSuIwVOVNg532rPnL6kQkgmGTj48kmvODTBsslwyzfTbxDvyIlxKhnZKqNta6c3iQrzXojdeE4xccJby9FS6pgcwH3ZgGe8pnBcQmv1B9Fd0x/8CTu4z1Dis3UDQDMWEz9d62gSnrJ7zNsOGaA0tM+48swpLPmJiA5IY2v3HHHXks4Rea9r6Bn7Ylnp8mUcwFgjW72gOEaTnONAh0q4bLTiNmdqRC6brgj6dRiSSTWjNNnhChaTrMd9lhaCr3IH0UmrOfjei6vE12IsNw86UMSZj8dl/5MtFsi61X2WPMVUQ== 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=H70Kb5To4c+I7RjuZVipuDWhe9KKC9Ipgu212PqVmP8=; b=P4RBYpLckRcXyhZuqJ4TLOrBfhKcXjUDdi70aYSnaIUDj7aM6ZSy49b2WBzA5UoyebYTT4WKu3u6Ytx9A77kWsyaV3FJGfS/UPtNOuJH979Qo/+CAEcg0lxav/wrSjpGbC/mxFyDsBmvhP4l4l0Ra1RtgVfLUSvIMaia6cOHVWlTia6BHVWnNi6NPDRAzwyMclidiwH7mFrcInJIYRlKSvgRSSsvc7jkvCyG4wKc+bJbsrAIGR/XmqJtWfiyqxqCCckp2/4LF7O0qJfC7R53GHJR+vtnMFuUTp4xivUWWVETuF7ptIabbJ1+/nk5GlEyzcUek/XGXw9jKhze3m91XA== 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=H70Kb5To4c+I7RjuZVipuDWhe9KKC9Ipgu212PqVmP8=; b=w78dflW6B7Qe/91NK2WkBB2Ivsm/rQjpigeuO1Ia5jf9extpw5XQbwOfigQvQLVjfupCnSl1TFjyJACHQzHosEt82xHmGjPgeHJcJVd+37wUwg0rWWf2/8iSSbmHs+JMZ7IJjR+CqDLZMrjglkUXtqat3RJd5l8eYQn185UyNSU= Received: from DM6PR10MB4313.namprd10.prod.outlook.com (2603:10b6:5:212::20) by IA1PR10MB7197.namprd10.prod.outlook.com (2603:10b6:208:3f2::21) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6813.28; Fri, 29 Sep 2023 09:37:48 +0000 Received: from DM6PR10MB4313.namprd10.prod.outlook.com ([fe80::ebfd:c49c:6b8:6fce]) by DM6PR10MB4313.namprd10.prod.outlook.com ([fe80::ebfd:c49c:6b8:6fce%7]) with mapi id 15.20.6813.027; Fri, 29 Sep 2023 09:37:48 +0000 From: John Garry To: linux-kernel@vger.kernel.org, linux-api@vger.kernel.org Cc: martin.petersen@oracle.com, djwong@kernel.org, david@fromorbit.com, himanshu.madhani@oracle.com, John Garry Subject: [PATCH 1/4] statx.2: Document STATX_WRITE_ATOMIC Date: Fri, 29 Sep 2023 09:37:14 +0000 Message-Id: <20230929093717.2972367-2-john.g.garry@oracle.com> X-Mailer: git-send-email 2.31.1 In-Reply-To: <20230929093717.2972367-1-john.g.garry@oracle.com> References: <20230929093717.2972367-1-john.g.garry@oracle.com> X-ClientProxiedBy: BYAPR07CA0019.namprd07.prod.outlook.com (2603:10b6:a02:bc::32) To DM6PR10MB4313.namprd10.prod.outlook.com (2603:10b6:5:212::20) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: DM6PR10MB4313:EE_|IA1PR10MB7197:EE_ X-MS-Office365-Filtering-Correlation-Id: 364669fd-2ab8-406b-7a35-08dbc0cfbde3 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: 5DLIS1Bc73pQnN2BpZ8wKDS1/aHNUC0VZR6GsjmjH8ZnL0K8sofSpTy45sA8D/5U0BW7mLwckKhfXbVQIxR43O4eBKMwd+lEiHeZpIM7T4amaCBRrIhkTee/DG6KF87EC+8R7PEq4cpRGxOKcqT/37nyXB+1tSLaQ510aoY/IWRAzuEGxVt7rXxj392s7Ed3J8CW0b33ME8DikioaVWLurrVOzgCF9edlg1atjrtRnD1wiIJ8DSur3SWxDDyPCgbvLp8ECKZUVtfaURMAmPaO2VcCaLI/rUOVGvDF4aQ9VV/hnkJ4nVhuCiuBGE1VO2ylmrm/8vmGnm8p8T3ZIurF80aw6J/CCK8+czBTHzTwCZ+ARqZ2x7O2xNFuTnMgp9q6D4V8ACfScSmrlm8k8CPdOHL+/kOyuVauyAeFIpA+vZXd8J2Vq1fYiPAD3iqgwJtwM7mKRH0gJg9Vu2oiPKSTAYqPTD/1RH/DE+pJffC6Z9LpuxGNowSyEU0pKrTwmvOjun/Cg/V35FUEkhm+aq1NohDgWy5OqCQyjiUcPKTBiQ9V3kiMkknm9mlfR2Vxo5h X-Forefront-Antispam-Report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:DM6PR10MB4313.namprd10.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230031)(346002)(366004)(396003)(39860400002)(376002)(136003)(230922051799003)(186009)(64100799003)(451199024)(1800799009)(2906002)(86362001)(103116003)(6506007)(6666004)(83380400001)(6512007)(5660300002)(38100700002)(6486002)(478600001)(36756003)(8676002)(8936002)(4326008)(1076003)(107886003)(2616005)(41300700001)(26005)(66556008)(66946007)(66476007)(316002);DIR:OUT;SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: PZbnYSksUu0FJ9IF1aWl3u4+U2I3+/T8S3tsvC1ut3xs0e5A8CSnnK2JkHTDBqNo2wPGpMdeEnn5BihJboJKYl+70cn0sfxJe2SDv1pKe8VrAhPiEF+MmTdG65lWVReRb19PHat++o6/tkXiXfB9F/TUFChANgzrF3VGwM3ypiFZ1Ct6aIZxoKJ9/SkJgSeTstF7lhpQhn5l6ndvUQSqKTl6QfOjUm096OSCW3yWPaNUwi+tpvey0LTGujnSGEKpKwXZ+vA8of5C857t1WhtfPU3Pz1mp4TqIsVUk9XhAVBdDR8iMqeQfUtWftbjH406ZkF41dBkc0yYkhRi6Ksc+z9wX1TLTS9diDYQXE/TQ2YWJLp/B8IZwcv4JB1RRNWZXQs89l2c5NF+hYunbGE5VGTotMlXjnWdbvv791g/8gF3pcU4EGzgoq8+GgfbS20BWcu2/K/RuaBTf11lqUYYJrOx76wfCjh/IS+pM6gM5feSgyIRjsudjibET30ePb2jA8j5ALDYeCNK5ITKStJbDrTb/COo7rIqQbzjqr4ldLP4ebfLb71jQS649QabMv4r4r5/P4yNcfOZ0ZxLaWffJ2gcl2HZrLiECxuctCvMkmlPFtS8tnLG9EbHiz9jtIO8D9PKXGZ5DKySQ2kMT+QkHDl6MM6D8XDPIeqeG5ZPNr/tGm1l3usg/GRKTKi9zSzfv9nZzm99pgT1fXoc1N29YCSiPfZBWSVj9hGYc39o5BO37FEFiCOI3VNkKNdXLUGd0AgqolgWx6/HP7xL7XuuEDFQrnUZMUFeVp+MlKkCX1U7J6eyMI4LvQUnSYAGPEe/UXxnnwJLSKwMSiiJFWNTmzYcwxfQtMGFy2W2nU1Q22DF7FxReJnTGyn8m2lBgjorNudFOv+oMX+2dqSHAXD4uu8WsOltnAuREdpG3tTQogCyi5EfzXQR1yq24z6JEenwlTEDC2Re8sSqDP6q5M1S1gZvLhUnt5/JbO1M7k9cUBL8ItTTX5irM+PTxFmeAp10kuTdn1ZHCrSUVN8rGMsVNRfyMEF1iwYJcKJ/KnO1qT7f3plEUroKT5wiNlbHkaRrjcxfofU7gmNWBBU4eowNlptUicf/8h9mdPdBxoiTw0K9Rz0FyBT71hc31pFDq1+oS+jbim7qMfaNSoZsKC+lcy6uzp1Gzda0kBILPkOtXSycXzbNzgEbttrBKel4HE2nXpeuvtEkfbZs+DqBWyfpL+bBUappUUqZA8a/eOSNjoR2otq2qkyD+rXdd1hvju8LclACKZOjjk6+2f2sKv8M1MwXLtK4s5DaTN7Ijq4ITqWOEtlmKHnM1CxClAeLJSVfgkTfigkoSg1FpD9uwPQN+FmvMpP8pnmkkUpH+FWW5WFsYNMu/71DQsE7U5jaVKG9yFRqh96U23Xe88ce1mpC5HB4M6wgfPEdUj1xufXJ4WewmYc2lJFJOGwTKNxNfc4OZQ7JJ45VA3fEt+WcQFFeBtRHs9IGS4WTDeQvdzpokmZC24t5He1egUVL++OB+LFvLedAFHJhFsJr9ecclKfrGu3P0d+AeG739kdkNO72iXRfUs9MkH2rd+BfBwdOGlTzYEi9ShdTXK8vckW95NM+nw== X-MS-Exchange-AntiSpam-ExternalHop-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-ExternalHop-MessageData-0: jAnO+Arwn076xuHIKqBaAbEDuJfe9gYMu4NDO8WCWfCgryTRGgD4SluO61+4pd+HjCeIUYXJj1FkUkMimELKzQKMskbJNPzR6rGV5L452XDaUUeVWB+gTjH9eLZUyP0wG97/cPvGpjmJP6o1PXclNmtigewKgRHkCuIjgJoEryvX1wMSLuu0Rl2L4V0Ahv25MeQ3d53QnzvWEwqPI/JwD5F6igrQO0vNr7LZvD/p/dBHGx8st0Am4pxhxdUfMVwPhNFCQ1+E7xngoBhlQOM45tTetynzW2e+A7nIROTHUsqPk1EDhq6kAxFb0WSAVrhCPOkyHmSjGzbi9YC8D5kCf7CiesYmoKptEoRRFVuiDkMML8O0gzITnVC2gBc2PzLJ5TqwQXsjCR4XXiPkqj4wx4LOxxQ/cv4OhXAeWl40LI4/JKeqPTN9dVIpUEefPZC2yVdvpp3BQp5i5nObRNDgNQQYnu3ATDb9bIjOBFyFMCN54msdbCOGHyRQX0ASnlMKn3eqfxGY4NNJiwFyT6tVO1I7r6OlMW0ypgZGfLGAFLfR2mlsJ6HLvH0Tm7ojGjKWk0SU6euS9lrRh38I0zkOqE7WXUoykyFqYQAZYroSMg8eRvD3FCil0+b/d8ezmwjnkh/y36KcKes5VGN/z2CIhhgxEFoCjgVnanzKiJ85TmoacO4Pd/XXCrbhQr9z4e2Gjt8lH+neWGyXg7umMQS+00kePuQgofdQBGvQbl5xDlBN/Z1H6tBRvK4PS2Trg5q3cNrTM3CEBnLyJB8wF/pHo3pVH7GtOJTDQHg0vpou9Afni4lIQ34KWp5hz/q2IGfTlE1svTZ6VEEjqCfFacxYtA== X-OriginatorOrg: oracle.com X-MS-Exchange-CrossTenant-Network-Message-Id: 364669fd-2ab8-406b-7a35-08dbc0cfbde3 X-MS-Exchange-CrossTenant-AuthSource: DM6PR10MB4313.namprd10.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 29 Sep 2023 09:37:48.0977 (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: nPRRmzwNsNUo/s9zLIEJtqfXECbzApe8buO+L13ndSLrUEs5T3Q35bDr+FHSHbVUyfp0ehFYy/MP1+Rh/v7VhQ== X-MS-Exchange-Transport-CrossTenantHeadersStamped: IA1PR10MB7197 X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.267,Aquarius:18.0.980,Hydra:6.0.619,FMLib:17.11.176.26 definitions=2023-09-29_07,2023-09-28_03,2023-05-22_02 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 spamscore=0 bulkscore=0 mlxscore=0 mlxlogscore=999 suspectscore=0 phishscore=0 adultscore=0 malwarescore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2309180000 definitions=main-2309290083 X-Proofpoint-GUID: jZDlhSAZ5q83izRNtivGjaf8YAYYmVJk X-Proofpoint-ORIG-GUID: jZDlhSAZ5q83izRNtivGjaf8YAYYmVJk X-Spam-Status: No, score=-2.8 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_LOW, RCVD_IN_MSPIKE_H5,RCVD_IN_MSPIKE_WL,SPF_HELO_NONE,SPF_NONE autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (snail.vger.email [0.0.0.0]); Fri, 29 Sep 2023 02:38:49 -0700 (PDT) X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1778365150433009673 X-GMAIL-MSGID: 1778365150433009673 From: Himanshu Madhani Add the text to the statx man page. Signed-off-by: Himanshu Madhani Signed-off-by: John Garry --- man2/statx.2 | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/man2/statx.2 b/man2/statx.2 index bcc67c8e3bd3..23b9c6953ec5 100644 --- a/man2/statx.2 +++ b/man2/statx.2 @@ -68,6 +68,9 @@ struct statx { /* Direct I/O alignment restrictions */ __u32 stx_dio_mem_align; __u32 stx_dio_offset_align; +\& + __u32 stx_atomic_write_unit_max; + __u32 stx_atomic_write_unit_min; }; .EE .in @@ -255,6 +258,8 @@ STATX_ALL The same as STATX_BASIC_STATS | STATX_BTIME. STATX_MNT_ID Want stx_mnt_id (since Linux 5.8) STATX_DIOALIGN Want stx_dio_mem_align and stx_dio_offset_align (since Linux 6.1; support varies by filesystem) +STATX_WRITE_ATOMIC Want stx_atomic_write_unit_min and stx_atomic_write_unit_max + (since Linux 6.7; support varies by filesystem) .TE .in .PP @@ -439,6 +444,16 @@ or 0 if direct I/O is not supported on this file. This will only be nonzero if .I stx_dio_mem_align is nonzero, and vice versa. +.TP +.I stx_atomic_write_unit_min +The minimum size (in bytes) supported for direct I/O +.RB ( O_DIRECT ) +on the file to be written with torn-write protection. This value is guaranteed to be power-of-2. +.TP +.I stx_atomic_write_unit_max +The maximum size (in bytes) supported for direct I/O +.RB ( O_DIRECT ) +on the file to be written with torn-write protection. This value is guaranteed to be power-of-2. .PP For further information on the above fields, see .BR inode (7). @@ -492,6 +507,9 @@ It cannot be written to, and all reads from it will be verified against a cryptographic hash that covers the entire file (e.g., via a Merkle tree). .TP +.BR STATX_ATTR_WRITE_ATOMIC " (since Linux 6.7)" +The file supports torn-write protection. +.TP .BR STATX_ATTR_DAX " (since Linux 5.8)" The file is in the DAX (cpu direct access) state. DAX state attempts to From patchwork Fri Sep 29 09:37:15 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: John Garry X-Patchwork-Id: 146682 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:cae8:0:b0:403:3b70:6f57 with SMTP id r8csp4194105vqu; Fri, 29 Sep 2023 10:25:16 -0700 (PDT) X-Google-Smtp-Source: AGHT+IGdZzFGgxZ8VtpFOFqAES/u7nnsMBG3oAJlUng9uo47bj/2EmYTviT4Mi4vQGluUOpbUxuH X-Received: by 2002:aca:2208:0:b0:3ae:17af:7387 with SMTP id b8-20020aca2208000000b003ae17af7387mr4598170oic.43.1696008316429; Fri, 29 Sep 2023 10:25:16 -0700 (PDT) ARC-Seal: i=2; a=rsa-sha256; t=1696008316; cv=pass; d=google.com; s=arc-20160816; b=w/hHDAjPSGar6otvU4vT2kCFE4GYqU7X3RqzD+qFCPF31O/xa7no0FT9ja+PF8lSUN Caw9bpaP5CWOsSWRalO1fUtN2x47X8KQ9vskKNE9T/0/1Gzmtbgex7aveZPAS0RO8ppc YGsL9wUd9bCiy/y2VUcDtGDEIANpTJxMN4HnYHRFjvmci3URuhPjBkSHrwB8zyWhF030 hy50yD2f00Q7LUZiqckqeFJAH6bYz5V4OpKtMKnFy237wNnAlyLRgTbMTSM+R0li3Ae5 UJmc+NXnFNaTixGipJGlnRPhd76SVYCfXGxAfzlD/elZVe4oeSwCoMHexYpVHOf14SnU 9mDQ== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:mime-version:content-transfer-encoding :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature:dkim-signature; bh=9GQJcZ37W7JCKiCpJzkcGdZwr9NNU5Er8nVCAxQEX5Q=; fh=R1RNKHRRpWl71R0BDm+HzSMSP7ET7WjXBS6kzq8E2Lo=; b=JIYTInr1D14L1MY15fHcYCdxGhh6nOcpb70ErOUZ12M6hzMhIIgHSRpMzDlChrZ4LK 8SYLaMZpUpfcdSvmh/CLC/V40PzIh5NB46pKYNr+Yt5lIA6/BYTiy/nMU+P+Us+5hUEW 979hHFyEUHZihwZ+vPV23hvoaigL3TC2mjS+GeBd0XmI4vZLr2Hi+/jp9tezliBubhQq NZTpthZj3HX8rML+oKkyXaYwNtrKw8b5rimSkBrJmaoiEcN6S50+pTbQX81RTkPhulP+ qgrHHpar1ie1OhDLenTOMsfDR9wxchOfANIxxnzWCia0Ss5sLYX7Wj3wa/RQGmBrcnjl G9uA== ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@oracle.com header.s=corp-2023-03-30 header.b="zbPnEP/b"; dkim=pass header.i=@oracle.onmicrosoft.com header.s=selector2-oracle-onmicrosoft-com header.b=ZrHAbCRp; arc=pass (i=1 spf=pass spfdomain=oracle.com dkim=pass dkdomain=oracle.com dmarc=pass fromdomain=oracle.com); spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.35 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=oracle.com Received: from groat.vger.email (groat.vger.email. [23.128.96.35]) by mx.google.com with ESMTPS id r3-20020a63fc43000000b00578e21ee4a0si21731337pgk.174.2023.09.29.10.25.16 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 29 Sep 2023 10:25:16 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.35 as permitted sender) client-ip=23.128.96.35; Authentication-Results: mx.google.com; dkim=pass header.i=@oracle.com header.s=corp-2023-03-30 header.b="zbPnEP/b"; dkim=pass header.i=@oracle.onmicrosoft.com header.s=selector2-oracle-onmicrosoft-com header.b=ZrHAbCRp; arc=pass (i=1 spf=pass spfdomain=oracle.com dkim=pass dkdomain=oracle.com dmarc=pass fromdomain=oracle.com); spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.35 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=oracle.com Received: from out1.vger.email (depot.vger.email [IPv6:2620:137:e000::3:0]) by groat.vger.email (Postfix) with ESMTP id D46D880BB525; Fri, 29 Sep 2023 02:39:19 -0700 (PDT) X-Virus-Status: Clean X-Virus-Scanned: clamav-milter 0.103.10 at groat.vger.email Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S233040AbjI2Jig (ORCPT + 20 others); Fri, 29 Sep 2023 05:38:36 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:55972 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S233018AbjI2Jic (ORCPT ); Fri, 29 Sep 2023 05:38:32 -0400 Received: from mx0a-00069f02.pphosted.com (mx0a-00069f02.pphosted.com [205.220.165.32]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 430BE1AB; Fri, 29 Sep 2023 02:38:31 -0700 (PDT) Received: from pps.filterd (m0246627.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.17.1.19/8.17.1.19) with ESMTP id 38SK9Wn6011902; Fri, 29 Sep 2023 09:38:18 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=from : to : cc : subject : date : message-id : in-reply-to : references : content-transfer-encoding : content-type : mime-version; s=corp-2023-03-30; bh=9GQJcZ37W7JCKiCpJzkcGdZwr9NNU5Er8nVCAxQEX5Q=; b=zbPnEP/b6fZBGpGP4lxWLPdo/0z+e24tjK+lmcztEG9qLEdVdFFiwC7KiWnFbKHHXjyq B2Gf5ZE3yxFt/Wurklk/s450o0ufXW9p7oLZgmUka9plYt7rphOuE6My7ONWk3MVQ9pk zDM8Krvbh7jrQ3abzM+h8OEiU4FC0zJdx29MbnEQ8lid6ubnXsVnGRxBaWoQ9AD99D9S CE8yK7WkAvWpPV0Q4l9OnRimKChtFxcSKKgJGK6hY7BJaMe3qoBGjv4vFmCXsiOX2kT8 /bLpnkAZl1icUkNQF4PD9QYzei03IlkzZKOFhbn/iZBbv+eLtXmMIYlE0+kYuBbrGxe/ ug== Received: from phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (phxpaimrmta03.appoci.oracle.com [138.1.37.129]) by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 3t9pm2efdw-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 29 Sep 2023 09:38:18 +0000 Received: from pps.filterd (phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com [127.0.0.1]) by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (8.17.1.19/8.17.1.19) with ESMTP id 38T7msw5014617; Fri, 29 Sep 2023 09:38:17 GMT Received: from nam11-bn8-obe.outbound.protection.outlook.com (mail-bn8nam11lp2168.outbound.protection.outlook.com [104.47.58.168]) by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (PPS) with ESMTPS id 3t9pfbk60g-2 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 29 Sep 2023 09:38:17 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=hSk7h3mwJb4RRBkRMPbmsxx6PDrT4uTSVvdlJQ8es2a9CUXm7Zow0NTA5XhUFCZHXy1nsEvWZyrXvHo4eYtFU8Q33mzW4KjuIEiEOYEpWMyI1reYbJjssLMan8aYZGvrhmPVkX/UYefQ997pesj5jVg4hnjrl0+QTwcKAXWtP9DQKjVG9G5QoSdma8a030L3DQt20nPBMKinzDbRwp/WGXI+h0DMGGfjYW4srXX3jeEcQQVZSaD7ieDq7dSuOcIevHEvtLegPy0xNt+MqGaAThOBASdcBlMweWNIA0D5v6JdfIBujfxBC28l9LGaz5N8w6eGzNXMNVkujXv/9mWZfg== 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=9GQJcZ37W7JCKiCpJzkcGdZwr9NNU5Er8nVCAxQEX5Q=; b=CAn4UzLV5tH/W67djbGbMpcum3usRuOr8GXLVAQqT33/kZQrGDpd/K8Uq32IDbyqjt9uE8vBilyDlfig+2WjlP/47TE+HHFHHG5bBSOwNQfCs5HOp5h+OyJNQeG/J4Hs2yNHpz1UXV9IjC950U/G0xiR69fxzFkWVVTRl5bnxCBMHjQVJn1Gr5U0geOtS67oBSjwKhTlfFntJnJxQYBPvMmETnTs9NmK1nhORlqMepHc/cQQ6UOHxIRC7oQC7s3UFPETDEc0Evr1qzYSHyoTpY0Hh00Ve4BmgV4jS4U4iRgNCOT1nvZAzZa0sjwLjRhbwL5Hl4kyAxUrRdXfUWwFpQ== 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=9GQJcZ37W7JCKiCpJzkcGdZwr9NNU5Er8nVCAxQEX5Q=; b=ZrHAbCRpnTVGYBu+V8KYkmaH3cfGHBF1V99yDcb+9eWVSea2CE7wdi8QtrHBVcbDCSZ+e5ZSkQg1Ho9VGb73UcksS+ePz9kqBlK9KgJjGODcnskkJLLVEoTBM9Po1pZX6b5MXEFnxN+422dqk+C35Mr1WmJKzkDRIEtb+QeoI8Q= Received: from DM6PR10MB4313.namprd10.prod.outlook.com (2603:10b6:5:212::20) by IA1PR10MB7197.namprd10.prod.outlook.com (2603:10b6:208:3f2::21) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6813.28; Fri, 29 Sep 2023 09:37:50 +0000 Received: from DM6PR10MB4313.namprd10.prod.outlook.com ([fe80::ebfd:c49c:6b8:6fce]) by DM6PR10MB4313.namprd10.prod.outlook.com ([fe80::ebfd:c49c:6b8:6fce%7]) with mapi id 15.20.6813.027; Fri, 29 Sep 2023 09:37:50 +0000 From: John Garry To: linux-kernel@vger.kernel.org, linux-api@vger.kernel.org Cc: martin.petersen@oracle.com, djwong@kernel.org, david@fromorbit.com, himanshu.madhani@oracle.com, John Garry Subject: [PATCH 2/4] readv.2: Document RWF_ATOMIC flag Date: Fri, 29 Sep 2023 09:37:15 +0000 Message-Id: <20230929093717.2972367-3-john.g.garry@oracle.com> X-Mailer: git-send-email 2.31.1 In-Reply-To: <20230929093717.2972367-1-john.g.garry@oracle.com> References: <20230929093717.2972367-1-john.g.garry@oracle.com> X-ClientProxiedBy: SJ0PR05CA0006.namprd05.prod.outlook.com (2603:10b6:a03:33b::11) To DM6PR10MB4313.namprd10.prod.outlook.com (2603:10b6:5:212::20) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: DM6PR10MB4313:EE_|IA1PR10MB7197:EE_ X-MS-Office365-Filtering-Correlation-Id: 5db892d2-3c53-47f3-30f4-08dbc0cfbf50 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: cR9g4lYJfU5dsJnxbVPD+rQqm92VmPSfx4GSgN7DhaTnkJBfmJqko3zkNjEEJb/QOpMckWfDIKNQBNIyQ11IW72HokqOeGn2Fi5taPtPo+U67JLHDEEjf6s0BX4v9UsedQumnYJfueOi0tDIef8dR14Oef64psAtY9mqt9H7wxjPF8aJxvkjSn1HvfHe2XCRpiGkAS3cF0nlyThz249UzX7uN18MXxOWLgcJHA4M9/MaXy3WiOJRMMIrW0SNbUFVQBLYy+//tE9usjOh6qJEbySfg6kocXNm47WKzb4lwB4zRbclUl24FWyPwLZNl7REEdsxgBKFOeP4T+3izhafp6/LN3/QTxcsQLIjXhS8sBFvbS5rXJ1xWSNyXwjIOct8DxEsUMRvXCbPJVt8XB3RwrUjOs4YatkyEIUmhMWA2ctEbZIm1QmEgPOMBCo/TynPUePbeXQgbQpce6RbmFZA4AIWTjLqN6Qi3JUVrOlHDV/5E3ROzOOJ8arLna2Gz0YwtI3aTB4CwM5DW7W2TYPuh2eMbg4mJge5gaad72+EFM5s9FoxE0kbimBdGbS95AH9 X-Forefront-Antispam-Report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:DM6PR10MB4313.namprd10.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230031)(346002)(366004)(396003)(39860400002)(376002)(136003)(230922051799003)(186009)(64100799003)(451199024)(1800799009)(2906002)(86362001)(103116003)(6506007)(6666004)(83380400001)(6512007)(5660300002)(38100700002)(6486002)(478600001)(36756003)(8676002)(8936002)(4326008)(1076003)(107886003)(2616005)(41300700001)(26005)(66556008)(66946007)(66476007)(316002);DIR:OUT;SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: 0PMY7oc0udatbggKglm/Xi0CO3HS01/O8EFTketJzHPSJ2jv/E9FcTVogKqJ66nVP1eMP5rGluyJHE8mbxofDVW+aZvHZjqpEwCfYzpUjIOYUFz7XKNJHeBYibFVXpgyow8Yun18laFxVJ4lZk4cBIrNckP7itpEP7E6VAxzdXHXrRN44zc9Xlt74qbyUdQY6tV3edZHegocw8ktIpEdEIHoJI8Sf4gI6sag1BQeuos/e/PUjwgGiUVeUjS5ruWIQZDQDu3C2R/szGehlPs57dv87YYAvciT9l1NiClTuOZ5xDWPanwkeCLIubXDCxpEBpaBRzWr+aydVUi4NsSIKsB+XRM0EZxb1j1xc2mW9Di0Kfk7s/OcXV4Xu6U3PHLmAyg58wfPVYfFKs6Mp5CO+lxXIayRljpBIoj+Fan4o2iCkhKX7mP+0B5EHBbqNYBJ3ojLgroG8TbI+qVXTOrKFpKehd2Bo2Arm6TnowUbWtqu7PZtucfANxoDxKd68uL3UGDzti0QZDOPupvxvw5sQJF38OTO+0+i+HwnUh0TvLB9ZltUW56F9lPOqXuyuyfd+r8rHnd9S7MuxK0bmO9k5UIkM46D/lHtgEUPjzg8Jc7b8TRQncvMzXbdRwe1vy4qn9gt9x3rpf7w7Gakls4PIjS8nklOwzG1aszJZNZPomxKRZ5n5/lCwM/AyCmn/mINTc5gURUZAhX4JONZ/Uf5L5t4JHyrd9Sj9QJ/slgOKw7VjXng3qLptjpWRFrSUsedEMxwu9Rbjht87fm5+f3X/T6wU9RZd8vVrNHBfkTWaP9rV9ym3CKa4ixHslGB1TMoBTfZS7ko3fXxQFAgczYCqz2MELMblX/aYgNUIYJBTQCWk1CRg27OfMNSoCOYv6x5zl4w+3wDYSxXhrGeiFcmzGcE19wUZPsJwPDZ35wVYdwu2bAcyLYkRcFw4+uJ0zCF8AwAHfxR4FFVsSmNezmQsihb8zXbo0T2JR0Zuo8OvXpc/JJFHbcqWaR93Hy6otp0e5srDyiKsDy6p8IONn24eEzCnpVB9cBxONGocN3bsDHnld6R++kSt48qyFvp1hPI5w0HYdZfkE00pfLd2gkzkW/x4W17EcaFLTlRqJgcpNu4nvDORxUVYlkH8YM64fsCBfq+9BMAhaSt9gLnxVgA8WRLG19zdof3X71ty2Jt6SGSEY1pCOA43s/pTH+gjvLR8jFqf2BbqhVV11X+/N22kcvSSkIL5YuiuOBwP9n/G5+f2rGOc3smnoL1gNGBRsGXyfhdZJhvxcQe+62TluOwqeS4JEL2SUzeXCDyg7/dMSLMirEu40xFGqt697aLPwZpGFfNjuwYvJQVVuH7xZTcogJJF+ifEeJKq4TTHYu9k9oXp9c9AyCdVoTv5fKBawDHx7BI1FueriqnnZs2VQunROhxgP7UZa1kwckGq9Y+9Okc5KpkKAgSxJz3Uh8WpYkjPa40S+zepsRrRTB/4wfywNZOKk0+zWBpJPicRS8WJ6ZuIDy0IZ5amBrLMWBPFy/RrTFcxWDnKrVhtds0qT/TwrHUnA4IpuDUcZKk0UfY8ibgoUBl3i18qJoF6EuRq7TXkX1xkjbgluhoxgqRgrYpog== X-MS-Exchange-AntiSpam-ExternalHop-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-ExternalHop-MessageData-0: xQfkns7B3pbW8Vn6CQ0x7Esccm6jOG9urUEGMV0zeauqvCxuEVs3besLeklLSxn/ssNccv+DWumOtvxMmSeYfF2o83KbbsfgYTCU/acAO2gh0PSKoM15ebJmV16uyw3s7zrLEbmOglN4dIiwbS6RNEjK1y53ljwVzmsmlRBzPAsxjzdqC2sxQPvV9RiJwiFCYIe5BpQ08uvSZ8++fDHr6Oks/tl6SOyXH64ecjHXtZulqz73bjlPTKVjBtFLUdRDPRnyit1rDqb3yZB41ma0BQwmHBOKpsHmXAwSMz7cgGTEzByS32IVIcyFqXdvlGnUDI0FIS6pMK+teS82JZqDhEBT0LeIhZSoaLDqaao7itPp2w/jSjrKARStS8JX7nAra4M69uxhhiIBZjFhz0LOIpHINYWcewbnAbBzznj0LtXlbHPjHb3HChfz6HObaKxB6IJaR0vRUg+s053hZQ6fLiSiawVxwNBVsY2vy0KrZEO8C+E9UN+dUEiKO5Jfj6eNbTzoST/x1ePGOAsVuHM1KWuVSr9VcGy4w855qXwx8LLOxc0W0zz0neHguG1YmEA2rvfBv9K5LrMmAEwndCajScMR40CaydBb1MFdNOqM/nvNJd6CP63/64VOSidcf9N877M4Of/AwJ7PeOKcxAeFbMYaOLA979DyFEJrSUfECQduSVVpqAqnEJTRclSJeX6jUfyrDxDUKNJ4t8tflQP4Cyb2hYK5NwFe49nnFEiKzPCOVzofI7lqzk6yDTL8mFpiERGLT2Io6xvf/+aXWdeoRR+T21EZnSpKW71RDqBwZ58B3kyw3g9XLGNOCA1G4iuZlnsXfvMu/UCaJNxPgzFc5w== X-OriginatorOrg: oracle.com X-MS-Exchange-CrossTenant-Network-Message-Id: 5db892d2-3c53-47f3-30f4-08dbc0cfbf50 X-MS-Exchange-CrossTenant-AuthSource: DM6PR10MB4313.namprd10.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 29 Sep 2023 09:37:50.4997 (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: ux9e3Q3ycltU5cxyF4Q0SDl/mA8J25PX6PrR7rht+b32CI95tLp+QbwGyloPXYrgkbuN8BbsElJNAtAV/ZEXUg== X-MS-Exchange-Transport-CrossTenantHeadersStamped: IA1PR10MB7197 X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.267,Aquarius:18.0.980,Hydra:6.0.619,FMLib:17.11.176.26 definitions=2023-09-29_07,2023-09-28_03,2023-05-22_02 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 spamscore=0 bulkscore=0 mlxscore=0 mlxlogscore=999 suspectscore=0 phishscore=0 adultscore=0 malwarescore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2309180000 definitions=main-2309290083 X-Proofpoint-ORIG-GUID: uUq2pdZimbRws6NHWX4lcaeNOOed3oUi X-Proofpoint-GUID: uUq2pdZimbRws6NHWX4lcaeNOOed3oUi X-Spam-Status: No, score=-0.9 required=5.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI, SPF_HELO_NONE,SPF_PASS autolearn=unavailable autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on groat.vger.email Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (groat.vger.email [0.0.0.0]); Fri, 29 Sep 2023 02:39:19 -0700 (PDT) X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1778393615910255198 X-GMAIL-MSGID: 1778393615910255198 From: Himanshu Madhani Add RWF_ATOMIC flag description for pwritev2(). Signed-off-by: Himanshu Madhani #jpg: complete rewrite Signed-off-by: John Garry --- man2/readv.2 | 45 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 45 insertions(+) diff --git a/man2/readv.2 b/man2/readv.2 index fa9b0e4e44a2..ff09f3bc9792 100644 --- a/man2/readv.2 +++ b/man2/readv.2 @@ -193,6 +193,51 @@ which provides lower latency, but may use additional resources. .B O_DIRECT flag.) .TP +.BR RWF_ATOMIC " (since Linux 6.7)" +Allows block-based filesystems to indicate that write operations will be issued +with torn-write protection. Torn-write protection means that for a power or any +other hardware failure, all or none of the data from the write will be stored, +but never a mix of old and new data. This flag is meaningful only for +.BR pwritev2 (), +and its effect applies only to the data range written by the system call. +The total write length must be power-of-2 and must be sized between +stx_atomic_write_unit_min and stx_atomic_write_unit_max, both inclusive. The +write must be at a natural offset within the file with respect to the total +write length. Torn-write protection only works with +.B O_DIRECT +flag, i.e. buffered writes are not supported. To guarantee consistency from +the write between a file's in-core state with the storage device, +.BR fdatasync (2) +or +.BR fsync (2) +or +.BR open (2) +and +.B O_SYNC +or +.B O_DSYNC +or +.B pwritev2 () +flag +.B RWF_SYNC +or +.B RWF_DSYNC +is required. +For when regular files are opened with +.BR open (2) +but without +.B O_SYNC +or +.B O_DSYNC +and the +.BR pwritev2() +call is made without +.B RWF_SYNC +or +.BR RWF_DSYNC +set, the range metadata must already be flushed to storage and the data range +must not be in unwritten state, shared, a preallocation, or a hole. +.TP .BR RWF_SYNC " (since Linux 4.7)" .\" commit e864f39569f4092c2b2bc72c773b6e486c7e3bd9 Provide a per-write equivalent of the From patchwork Fri Sep 29 09:37:16 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: John Garry X-Patchwork-Id: 146472 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:cae8:0:b0:403:3b70:6f57 with SMTP id r8csp3900930vqu; Fri, 29 Sep 2023 02:50:15 -0700 (PDT) X-Google-Smtp-Source: AGHT+IHoRcK2aLhbdLvf1OCvuKVk1T3hHXeqBGVnmM1Wiu2dfSwsTJ3noIOxVG9m9XrsMfSLgUAv X-Received: by 2002:a05:6a20:442a:b0:12f:c0c1:d70 with SMTP id ce42-20020a056a20442a00b0012fc0c10d70mr4124903pzb.40.1695981014989; Fri, 29 Sep 2023 02:50:14 -0700 (PDT) ARC-Seal: i=2; a=rsa-sha256; t=1695981014; cv=pass; d=google.com; s=arc-20160816; b=M7FVuKvvHh7qBTHburI+KQdlNM58e03dnr8hOydhmyrGQZcocNaBPzLBPAExyXcheU BjAo+MDIpEybpR408V19ifoZVuLs2Z5rVqsZj2AtnWvlUnOJEVhV1gKNK59EHkwhY8mJ MFZxB4RmdCVKQii/t3dXNW44Kcn9anTnbIguv74vcQrvoMV5M3IF8AzoMuugyK/epb4k SOpNBDYRbMP1GYtGdECaBZ8BMmgAtq61TZssjquP7UpsbUZgaIMc6T9ISpXl8zoazRzZ l69P6rplBe62D0aSBO3O9BVPDHAu5mnTSxazXp1pih4uqwg5Ek5Es1ZQz0wFNk7b+fgp xqpQ== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:mime-version:content-transfer-encoding :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature:dkim-signature; bh=7XOjzuMjfk2j+QCe92vGIHxnfuGoYWuw3/vr5tagzt0=; fh=R1RNKHRRpWl71R0BDm+HzSMSP7ET7WjXBS6kzq8E2Lo=; b=xV4gW6NpsAxd+aiJK//dO5xb0OaREB1AgmTC+43ZinZE/CIM/EJNurOVV3Ofsu5icu Z4FBNGDtR+OQAgmINj8aIRH0ct7bK8eyPSpgkr7VbPwr45hOKYyiF7K/+vWihF3LmoVv yeu/3uputlJGljSr8ptE3GUYthdX3M5PeviYYZJIC5AgEJ0l7/4hefRUfzau5ZKhqPsl Z4GwKCyIUxvuxQ2Suvs+fMC3QjyqkaZDvPpZcXiih6u8lKSejESCnXWtS17tRcEmZEtp v9O7YGNFMMsLxVevLuROPhOWw6M12ttgH5ebafLIXELGU+hAHNeJO781+UW9EIfhFwAG o5cg== ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@oracle.com header.s=corp-2023-03-30 header.b="1/izO0lN"; dkim=pass header.i=@oracle.onmicrosoft.com header.s=selector2-oracle-onmicrosoft-com header.b="XOWi/wDE"; arc=pass (i=1 spf=pass spfdomain=oracle.com dkim=pass dkdomain=oracle.com dmarc=pass fromdomain=oracle.com); spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:4 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=oracle.com Received: from howler.vger.email (howler.vger.email. [2620:137:e000::3:4]) by mx.google.com with ESMTPS id a15-20020a170902710f00b001c381bd030csi19201055pll.172.2023.09.29.02.50.14 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 29 Sep 2023 02:50:14 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:4 as permitted sender) client-ip=2620:137:e000::3:4; Authentication-Results: mx.google.com; dkim=pass header.i=@oracle.com header.s=corp-2023-03-30 header.b="1/izO0lN"; dkim=pass header.i=@oracle.onmicrosoft.com header.s=selector2-oracle-onmicrosoft-com header.b="XOWi/wDE"; arc=pass (i=1 spf=pass spfdomain=oracle.com dkim=pass dkdomain=oracle.com dmarc=pass fromdomain=oracle.com); spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:4 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=oracle.com Received: from out1.vger.email (depot.vger.email [IPv6:2620:137:e000::3:0]) by howler.vger.email (Postfix) with ESMTP id 14C4C80ECF96; Fri, 29 Sep 2023 02:38:37 -0700 (PDT) X-Virus-Status: Clean X-Virus-Scanned: clamav-milter 0.103.10 at howler.vger.email Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S233007AbjI2Ji2 (ORCPT + 20 others); Fri, 29 Sep 2023 05:38:28 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:51090 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S232960AbjI2Ji0 (ORCPT ); Fri, 29 Sep 2023 05:38:26 -0400 Received: from mx0b-00069f02.pphosted.com (mx0b-00069f02.pphosted.com [205.220.177.32]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id E83C419F; Fri, 29 Sep 2023 02:38:22 -0700 (PDT) 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 38SK8wUn013176; Fri, 29 Sep 2023 09:38:19 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=from : to : cc : subject : date : message-id : in-reply-to : references : content-transfer-encoding : content-type : mime-version; s=corp-2023-03-30; bh=7XOjzuMjfk2j+QCe92vGIHxnfuGoYWuw3/vr5tagzt0=; b=1/izO0lNRkaeigjkftR7NOUt/rK2N7ehlqE9WcPwUhcLkhCmBzsJW1sGArhhZJ78Tb+H VcXGrPLnsrSF5BoixKY44Est5X/JGdXawkVgfyQj8lf0mYGuXoFsfnGjT9tR1uVlkhi6 lmD1FF2hMVqck/v/kyJDv9kHnfjGJdEpT3e338dCYvFeAla+zt0xkLOEhyxcD+/+vEv9 wTTfXVil48AbmoAx6jPcQwZlXbKSUoEVJ0JbAUT9HtFWi/a9IjudGPndSN/+zdbQrrrq 5B9YZa7mYycrfnXx141HyntqoOt1tnvNTQRRNwlL3Oa3GAbmvH4ivYlYaNmigOtqnnBy Yw== Received: from phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (phxpaimrmta03.appoci.oracle.com [138.1.37.129]) by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 3t9qmupbvd-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 29 Sep 2023 09:38:19 +0000 Received: from pps.filterd (phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com [127.0.0.1]) by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (8.17.1.19/8.17.1.19) with ESMTP id 38T7msw6014617; Fri, 29 Sep 2023 09:38:18 GMT Received: from nam11-bn8-obe.outbound.protection.outlook.com (mail-bn8nam11lp2168.outbound.protection.outlook.com [104.47.58.168]) by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (PPS) with ESMTPS id 3t9pfbk60g-3 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 29 Sep 2023 09:38:17 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=NVd2koIQ8GS87HMbjETWZp/BzKttHhWu6YbGQaeimbQImZ49hpzKg5MFhqyQBDsC6OmU4ERtH/wwiIulmFECo/aw5BW9zZhXncqnJ2/qbdKOrRAkNRqcB4MOzseAkEhPua7AoR3yxIO+PmO7SE45gAS/Jev0ZIaQqeVolIvaJIYG0bCUIAm/UQqmlU0YshkuplQzLp708MyyC29rT0u95sH2YlMENvj+gxxwri0zdL7cVzeKDN1yK9wEB6zSyBrzDlHJZtS2d2U/gym8EZYWx8xSRt8OYgbJqsgB+bc3/5f7um2bwzRQ1Y2j30LOKRHsJdF5wSNQLN4S4n7xjWuUTA== 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=7XOjzuMjfk2j+QCe92vGIHxnfuGoYWuw3/vr5tagzt0=; b=Kp0L/ZuLKl63XBj5J/huNl9MhIZzHvF/uUhIA76jJ+Y01o4ItpcCN3Jt7f2NcS9IUavvjsHvriCa0mQegmEhNk4LATHI5z39qnsHl47kXCkcmoPLJ98eOO8ak8OHhr3X0r6Xl9w8yY2MokrWhkDEoQVmVz1g5OfKASLnjPLkUII1xhPXteXfP8lC8cHk+3Ab6hn/GmiYZOYu9AEuQkgfJrgi5fEc8pVM8r6K4cs81LyhRq1nKX/LJlNkOuE9/6S4a2Lt3EC6JxZy5dcMffnMum6pkEjiIa1ZWhsUfwlLewivuzVxpQHAYEfAwLPuVK1JGZXkFw3PBvz7llgmNmcuOw== 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=7XOjzuMjfk2j+QCe92vGIHxnfuGoYWuw3/vr5tagzt0=; b=XOWi/wDES3OR+50XEhGUwS7c+014xJJ02cF/4F8EmL34yOsqVMMjCyQQxrnHxbJPz+LqCKyzmoL5U3A/oXjel/9bjNvZOCdbKLT1IzUeBIaCbUHhHluirX/SNbfa+4hATb6RIRrUEVfVkzSRekWGRLkbme2eGMXjM5Ltb4GZQxo= Received: from DM6PR10MB4313.namprd10.prod.outlook.com (2603:10b6:5:212::20) by IA1PR10MB7197.namprd10.prod.outlook.com (2603:10b6:208:3f2::21) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6813.28; Fri, 29 Sep 2023 09:37:53 +0000 Received: from DM6PR10MB4313.namprd10.prod.outlook.com ([fe80::ebfd:c49c:6b8:6fce]) by DM6PR10MB4313.namprd10.prod.outlook.com ([fe80::ebfd:c49c:6b8:6fce%7]) with mapi id 15.20.6813.027; Fri, 29 Sep 2023 09:37:53 +0000 From: John Garry To: linux-kernel@vger.kernel.org, linux-api@vger.kernel.org Cc: martin.petersen@oracle.com, djwong@kernel.org, david@fromorbit.com, himanshu.madhani@oracle.com, John Garry Subject: [PATCH 3/4] man2/open.2: Document RWF_ATOMIC Date: Fri, 29 Sep 2023 09:37:16 +0000 Message-Id: <20230929093717.2972367-4-john.g.garry@oracle.com> X-Mailer: git-send-email 2.31.1 In-Reply-To: <20230929093717.2972367-1-john.g.garry@oracle.com> References: <20230929093717.2972367-1-john.g.garry@oracle.com> X-ClientProxiedBy: SJ0PR05CA0014.namprd05.prod.outlook.com (2603:10b6:a03:33b::19) To DM6PR10MB4313.namprd10.prod.outlook.com (2603:10b6:5:212::20) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: DM6PR10MB4313:EE_|IA1PR10MB7197:EE_ X-MS-Office365-Filtering-Correlation-Id: 50f18aa7-1dd5-4a3a-94a8-08dbc0cfc0ec X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: e8Bvlpv+pZYbGivheD+1qfJvmmIvwbSw1Phfm1aYJoTdugQIJAVLFMoRXHvTQx8bMKwUIZqdYQ5GNtj5YvH7PY31uousEAR0ZQvCsOQvHqVg1O86X4c/00MeRczpo/vgs+uGFKjtnwtWYvmhjmVDLVoCrFXXh8PCQDpGMJSeXOTSU1SSRoLgZIcfp2wjotlmb4tW5LYNc6CbOJYQbkzGKFQZCBA4RMQw54jRv3/zfgnynuQm5kWzstLbp34PyDKRZJhluxBWUvkqssk7TNMT4rK+dx55zsD4obwjLiaMpZzAKRGaDJ3YD6ay3bGM148po+N5sDG6fBa9eH+8p3G+5sUSGhvk785JngB4jbWxb6peX/YxDfYR7fabavy2N7K/wQUGgMm9vBGPQaHkH5NzlFMopVS+NB7CqalUWudSLo7scMrBwp/+vj7sTVTwCjJI38Er/f0zazs2UGE8e4oNMofAsuCuryk7bFcOu08M/9d4CKLyV+Mmmkm2uXOg/B+X56jf57MuJzURJ3WfISVqxJ53tiLxMWpyQjAPsYBqtJHD7/VrMhTdz151Ay+nmLy4 X-Forefront-Antispam-Report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:DM6PR10MB4313.namprd10.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230031)(346002)(366004)(396003)(39860400002)(376002)(136003)(230922051799003)(186009)(64100799003)(451199024)(1800799009)(2906002)(86362001)(103116003)(6506007)(6666004)(83380400001)(6512007)(5660300002)(38100700002)(6486002)(478600001)(36756003)(8676002)(8936002)(4326008)(1076003)(107886003)(2616005)(41300700001)(26005)(66556008)(66946007)(66476007)(316002);DIR:OUT;SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: GjrftV7ruvrqXEa91ICkNF42cGKIZzDK8j0DiiBNRGfHchXZ87l92wlpS8HcILSDjavcyIuischCDmca9qMAxS1dWuvW5khyWNTKHtd9Wzm9mnLPFBdlCaQS5Mu3Sg5WeCnyxQl3QcHmcItBLAqORstFKTUZvtcukH8RCa2dJlLkBgN7OPJ1Rcvt1qUUBlbLEIyDlqu5oKdJh2lsPuZfydwR11tQ9UheddRKyIsr9rvPcBVmaoTYFsLur4tbbHEh5iLUhPIAJTs9J0E63+VNLndt65CrVJHGewe0hdV6x4sjlYGdHUF+gmD3urdW1uZYWpXeu+ZvJ1Im+712hWNTg7RZAMzirRUfJwpQdUKaN0ZIiJU1p5MPOgF7Yh0MGowJcrIFShnjUgUvEI0kRjcRyvkxNZoNUuWPSpa5OJyBgx3VFc+ztj7nEAAAtEzwYaodjYyZ8q0izb5/M5t6rLI4vocyxhB58M3fB+sZwUSE/I9dBlrlbRKl48aU08vC6793jKMSuDq+K4xC2opShGur1RM+XAktbVVFpYmQO2cINzyp6zM5TX7r+Tlkms7kGF54cZtmw77Wun02lrcEFwlSuqbnYEX92iRpvaOF0YeuVK4SxF/JILWjJdupBTLBl4/ht488syq7q0bTsjJMecJ/Wx15JC2+2UEneX+eywHwoO0DxKrenUonHYGtlu/Fj6mjelZBmTe55vjV+m3HwRpEgP8e1sAAm/SYtWmWVQdx+UZZ2r37mJgdWTnNtFSdwkReqMMv0FEbOjpw3nnvZsnP77YDyJxhezoMNV9wPPBwW+iM9iauCMlUD3dHjEik44H1vL6wInb8T/RmyH8OBoyL0YOrsy0fQxojW0pKROCjKDcneLyWfN58/dn4GjWAi6gqcyljnqhXv/zw1AKNQy88pe9gajzX+cNnJepRodzqlXMH88uY6POgdT2ePQGdvISG9NcWNj7TMrhV0QigGHEroz4NbDgZRSlb9SMwPQCeG92Dlg9WPZU+8rbZ4bagHTY6/XHuGTtqZ5I5jw/Od+iVK8GSPaeF5sKhR68UsxsI+VE1rbHixqdwfy4OpwxCciOKAgVLdJxgJtcIQCR+iw87ebax4ugNJ5zZK9gUB28Kvwb1bqyLxzL07KCsh5OTE3FGu9RvGq3cjmwDZ/8K+UyfRcqhtsiXNY04bQhhi64KpuP0m+SjBcNtSHlWIiS7sbB2jVZq6iMlBj1nVMx/vBGp7RCEI2FESrwKwFBdHlm5O2Isvpa0niPVNU7kgy9hHWnLGxMWJPQONSaFMsn2Lc2v5xy1H1S+imSOhqPbB/Am7MMZ5Pwpl6+6tbYP6yhtPx5kYNw93z+E1MkXkulm5S+9parzFKuaSfI1OO3BfRmCqZvpK+e8PcxfHd7qxQJpKECsUs0OpEovFPP+PFFG/KTPjBFF4QzwHk3pDmhyd7KCAX2ytKFOVahTBLBNbQzecZORnidkc/f3gdAM/7se3Mm5DBlL/LJnjcVBhOtOLtKbPe1bHt5KU+QJsOGvzE+Y4owhGfgcbm7xgT1+gfOYQXXx3uhwHvxGeCp7AAJpYQ3nlb027wWqcYDAhCktRYSX1r34 X-MS-Exchange-AntiSpam-ExternalHop-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-ExternalHop-MessageData-0: USomWYX4Z2MzJ1xo5MYNSSdyJAqlON7bU3Zbh6NX5LWxWjHPTHEp+i2eI9wN1pmOJIL3VezA0CDvhciwKuUzit0KpYFGfr801i1m3sqnaxkIBzU45EK0bHyIAOc6vZa6H3+9oFOvKhfEZgZpa4BFDtfbjmm+nR/ev+liTYboExk2LJ//y+5knK81GDsGnjKCu3ZfAl8qo1U3qCMr5F5fYMqODny2m4IC9Ztmwxu19+JYNmQwWIbURBGTFMHxMZaMbNhsQadY2WwWl/4mbXB1AgAvP5Rlux+cWuqPGgCak/9DJ/Kfa//H2H14riFBkS7kg2zvsj8tNbbN9FmpNs7rZxTpPZY7xVA8MMhG9FHguLF0+OiYYARzs8U2AtfoUJfb9kIuoz0QAW9fUiTRMjreXYn1YzG/RbN/u6WndQzU/6VxLVVnDwunu3E6yP/BCM88Glb0Jw60iXNUjR7Dy+KEaYD9gz8Ge0/bEJdpLXwnhdifTSuG6aLwVWMR6BjrtfgKs/usJlH+OO+1YGyl3shrndu0p0h+y9W6jY5pK0i57S18K37KqNqw8JjVbAXSiEg/nnQz8TPhd5syAwiQqpjmbOF+KFNcEu25VtG6t4uvDs32A6wne0VDNdsGTDqeE1G5nrigyhRLinNNhWHHQ2aa6ciFXV+p9VQ289HNW0H4YmFkYdLfW/iU31hvB1OBziLVO7OJ+QFlK3Hmb2kfFVv+VK4oDIpGoKO4HkxDV8RJiN5QYDwG96t71W/r+zjtIZA9rOgCctPFO8OjbU9PiUbH7qMrGTFsPETRXTJ3IXAhaQ+C5GHZTqP3czxSJdPCRi/j5WNREGt45Bl5id3VvhSL7A== X-OriginatorOrg: oracle.com X-MS-Exchange-CrossTenant-Network-Message-Id: 50f18aa7-1dd5-4a3a-94a8-08dbc0cfc0ec X-MS-Exchange-CrossTenant-AuthSource: DM6PR10MB4313.namprd10.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 29 Sep 2023 09:37:53.1903 (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: OK5iHTHm8863P3fbfVVBw6hofHBenhcwpywhCQk2ESzpe9QVPwwcqvuE5L6HKYb4+qOmnNWNJ/JHiIANh53QJg== X-MS-Exchange-Transport-CrossTenantHeadersStamped: IA1PR10MB7197 X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.267,Aquarius:18.0.980,Hydra:6.0.619,FMLib:17.11.176.26 definitions=2023-09-29_07,2023-09-28_03,2023-05-22_02 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 spamscore=0 bulkscore=0 mlxscore=0 mlxlogscore=999 suspectscore=0 phishscore=0 adultscore=0 malwarescore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2309180000 definitions=main-2309290083 X-Proofpoint-GUID: 8HL7VOI_6h7NURaMGP6Zc1pcMxu_k5N8 X-Proofpoint-ORIG-GUID: 8HL7VOI_6h7NURaMGP6Zc1pcMxu_k5N8 X-Spam-Status: No, score=-2.1 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_BLOCKED, RCVD_IN_MSPIKE_H5,RCVD_IN_MSPIKE_WL,SPF_HELO_NONE,SPF_NONE autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (howler.vger.email [0.0.0.0]); Fri, 29 Sep 2023 02:38:37 -0700 (PDT) X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1778364988321973328 X-GMAIL-MSGID: 1778364988321973328 Document special rule when using RWF_ATOMIC flag in conjunction with O_DIRECT (which is the only time which it can be used). Some block devices have a virtual boundary, which is a boundary at which write iovec vectors start and end addresses need to align to - see virt_boundary_mask in linux kernel sysfs-block Doc. To avoid splitting writes with torn-write protection in the kernel for when vectors cross this boundary, special iovec boundary rules are added such that we don't cross this boundary. Even though a virt_boundary_mask may be larger than the CPU page size, we just impose that as a reasonable limit, which matches what the linux kernel NVMe driver uses today - NVMe is of special interest for supporting RWF_ATOMIC. Signed-off-by: John Garry --- man2/open.2 | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/man2/open.2 b/man2/open.2 index 4c921723c95c..e5b9d107859a 100644 --- a/man2/open.2 +++ b/man2/open.2 @@ -1782,6 +1782,19 @@ blockdev \-\-getss .EE .in .PP +When +.B O_DIRECT +is used in conjunction with +.BR pwritev2 () +and +.BR RWF_ATOMIC +flag, in addition to any alignment rules already imposed by the filesystem and +underlying block device, it must be ensured that +.I iovec +vectors have no gaps such that the end alignment of a vector must have the same +start alignment of any subsequent vector and that alignment must be least +at a page boundary. +.PP .B O_DIRECT I/Os should never be run concurrently with the .BR fork (2) From patchwork Fri Sep 29 09:37:17 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: John Garry X-Patchwork-Id: 146584 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:cae8:0:b0:403:3b70:6f57 with SMTP id r8csp4079776vqu; Fri, 29 Sep 2023 07:33:02 -0700 (PDT) X-Google-Smtp-Source: AGHT+IGaeTXCyw2ijKlJj6pQL3h01d6en11SyhXnd9Qu3tly6z67apQ0fjLeazRfU287EKZRISjx X-Received: by 2002:a05:6a20:4286:b0:15d:ec88:356e with SMTP id o6-20020a056a20428600b0015dec88356emr5522429pzj.41.1695997981897; Fri, 29 Sep 2023 07:33:01 -0700 (PDT) ARC-Seal: i=2; a=rsa-sha256; t=1695997981; cv=pass; d=google.com; s=arc-20160816; b=vBLC+kX2JYZvGbGGFxdrEIhxLzfo6Ijns3fEftiUinxqNGtYIVfCEOhflcFYCP2Vh7 p3+PuQ3rKT23q5iQWzjNSy1RRdNGA8Z5zHMpqJwyuorGvu7sea+Ga7q8R/IGrtS719Dn G4wSzYK5CRn00Xfc/pvn9M9yKfnVW1mCRp28rHyEyBoWktKDm0pLUj4JDVKmODj1VD1Z yDz5RZklYhlHcN9aVslo0cKqdKoa+3oHtC6oUF4Y9D/hqcQVOIlDPnBgFdlEj/PJ1jF7 hUoMqschCCqNsACP3L+6fZqDsDevHrwLW+32FbxvLFo5AG4ucHmNwNnXgLBDM/S6TV6h prSw== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:mime-version:content-transfer-encoding :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature:dkim-signature; bh=cB2dvNd8c26enk8ct08GHLYV4CjtYHjIUQSAXzr5vao=; fh=R1RNKHRRpWl71R0BDm+HzSMSP7ET7WjXBS6kzq8E2Lo=; b=FeI6A039lBhsBRv07VwaeLG0jQs8ON6Gd7zspNlKItgSOKGJzHgY8zNFDjyhZryQYZ cnvm2I8DnAXGgRYN+4+6Rysc4QmG3WLf3mB/jKL05OdmjlxdnHdCQItiVzqa3xGduC6f e8FjDuGAzTeYDLD8dRMav4+YtDZ7TQjDQeORwxe5QbS974hM3jfvG+9O4BSrwQmZpCT2 X9pMSL7wJ7BPKhKA6rfHQgJIjX0Au8Z8PBT0nR5/T7vXhDWfdMPm461YCu5+vz4wHW2t +MP3+VO2LBY7CPKYSl9KUGZlyYEmLb75bzezfrYW6o9tYWal60F2YettmPctFvpticXN rrgg== ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@oracle.com header.s=corp-2023-03-30 header.b=pKeeFfIC; dkim=pass header.i=@oracle.onmicrosoft.com header.s=selector2-oracle-onmicrosoft-com header.b=FyYD2rrB; arc=pass (i=1 spf=pass spfdomain=oracle.com dkim=pass dkdomain=oracle.com dmarc=pass fromdomain=oracle.com); spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:6 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=oracle.com Received: from pete.vger.email (pete.vger.email. [2620:137:e000::3:6]) by mx.google.com with ESMTPS id bz41-20020a056a02062900b00578cbee11easi3198100pgb.9.2023.09.29.07.33.01 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 29 Sep 2023 07:33:01 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:6 as permitted sender) client-ip=2620:137:e000::3:6; Authentication-Results: mx.google.com; dkim=pass header.i=@oracle.com header.s=corp-2023-03-30 header.b=pKeeFfIC; dkim=pass header.i=@oracle.onmicrosoft.com header.s=selector2-oracle-onmicrosoft-com header.b=FyYD2rrB; arc=pass (i=1 spf=pass spfdomain=oracle.com dkim=pass dkdomain=oracle.com dmarc=pass fromdomain=oracle.com); spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:6 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=oracle.com Received: from out1.vger.email (depot.vger.email [IPv6:2620:137:e000::3:0]) by pete.vger.email (Postfix) with ESMTP id 5859E82271A8; Fri, 29 Sep 2023 02:39:15 -0700 (PDT) X-Virus-Status: Clean X-Virus-Scanned: clamav-milter 0.103.10 at pete.vger.email Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S233016AbjI2Jic (ORCPT + 20 others); Fri, 29 Sep 2023 05:38:32 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:51086 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S232932AbjI2Ji0 (ORCPT ); Fri, 29 Sep 2023 05:38:26 -0400 Received: from mx0b-00069f02.pphosted.com (mx0b-00069f02.pphosted.com [205.220.177.32]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 50D0C1A5; Fri, 29 Sep 2023 02:38:23 -0700 (PDT) Received: from pps.filterd (m0246630.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.17.1.19/8.17.1.19) with ESMTP id 38SK9uhS020207; Fri, 29 Sep 2023 09:38:19 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=from : to : cc : subject : date : message-id : in-reply-to : references : content-transfer-encoding : content-type : mime-version; s=corp-2023-03-30; bh=cB2dvNd8c26enk8ct08GHLYV4CjtYHjIUQSAXzr5vao=; b=pKeeFfIC6jtxJUHyGZHsJdVW5ssteAzH5Fv93y2bcj4+jXUPuhnB6ZiI2nJZ3IYgID8w Wh7VxLtSYS2UxFsrSIPNeox100K+d0TSPF8zI6AyGcpr9huAQUonfHv4OvOLnAAI/OZd DgORTEybB0+ywyXprQN2cAJGBHXScTuLxxldNECiD0f30RGVLNos4uisKx9WYa2rCo3e wh4OldV8pEK3D7XhZktOTjX7nMUtmSyNF4EnoB/ERjl8gKyNiOwsoZj2uy1hZF/kRNL2 yRWw8mWFgliIo21GyGhgaooCYwfdLK+eVQdFznGqSGHcV1xYxJBUJ2fi3xjtpSFby3vn kQ== Received: from phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (phxpaimrmta03.appoci.oracle.com [138.1.37.129]) by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 3t9peee7ss-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 29 Sep 2023 09:38:19 +0000 Received: from pps.filterd (phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com [127.0.0.1]) by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (8.17.1.19/8.17.1.19) with ESMTP id 38T7msw7014617; Fri, 29 Sep 2023 09:38:18 GMT Received: from nam11-bn8-obe.outbound.protection.outlook.com (mail-bn8nam11lp2168.outbound.protection.outlook.com [104.47.58.168]) by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (PPS) with ESMTPS id 3t9pfbk60g-4 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 29 Sep 2023 09:38:18 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=la83E3u2k4W6nTq6kd72SFQcxXWFf0FQqjzIir0IrK8Qn4eYn/Q82116Oa6npBeYpRlFyhOcDDFPH68e4i0CE8w+wM+LDUX1yeDYTWO8GRMW11w8+qSpcMF9PFAY5RQKAwAcgf4UMpqjLZ4IH2a7C17c/KZ3UJ6qgAPsmWIEhY84LH9rzB0VV71GsWGqXwiw7qiei9kLpvFlJ0eXrq8KpB5PusrtSKRsa+BZ1TsIXVHwC7FTkKFrmQ221d1OtC1sla8CxFCjld1r2AHUwlnXMcUoDrSTXJs2j1Ly0i/GOFGM1MFY05cFjEquPyhEji6e7UN0K0ksfcCHAISQ9eGF3A== 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=cB2dvNd8c26enk8ct08GHLYV4CjtYHjIUQSAXzr5vao=; b=kMZNuFG0dT/uYh0256UCTi0EsZ2C08ULYzNJb9VJkKerUaKagG1LfDf5p51Jb7Ycg5x5DZSuBv+d0SrrZayovwkwrmHO03WV+qfHqi6mpx/yaQmyzptYqaJAItxQk55ZhZk9cn/zdE1UBswaj426bZAg287d9Z9XALa7vKMRCRkWMB9AwiBFx5qV6k4WDIeQ9Y3GOsa5MCuXUPGKJyKhZk3qGzBOMBxeQ3e2TbSh4gRMuo194OLiGfDZda5kTqxuVH5af44d4878GHyI1PGBDNN2P+HB9/jAqXfKpyqEU6wbW07FgAwk6YgipxdJTH+NDCBiO6rnPq8NOVKr4ZK4Hg== 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=cB2dvNd8c26enk8ct08GHLYV4CjtYHjIUQSAXzr5vao=; b=FyYD2rrB7jcURui5oNRjcLx10l779jAath30gVUQshMcoThCo4N2xsmiUy6ngGrCZA5pyndddq9+dydl235ZKEEmkxn/kzrN0ITJlPTWAxJ/22yKMjnYWtHAA84JkmtY80+w9tqfz6jikVDhdDWQf8dt76OYObv7lz9Vue+e64I= Received: from DM6PR10MB4313.namprd10.prod.outlook.com (2603:10b6:5:212::20) by IA1PR10MB7197.namprd10.prod.outlook.com (2603:10b6:208:3f2::21) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6813.28; Fri, 29 Sep 2023 09:37:54 +0000 Received: from DM6PR10MB4313.namprd10.prod.outlook.com ([fe80::ebfd:c49c:6b8:6fce]) by DM6PR10MB4313.namprd10.prod.outlook.com ([fe80::ebfd:c49c:6b8:6fce%7]) with mapi id 15.20.6813.027; Fri, 29 Sep 2023 09:37:54 +0000 From: John Garry To: linux-kernel@vger.kernel.org, linux-api@vger.kernel.org Cc: martin.petersen@oracle.com, djwong@kernel.org, david@fromorbit.com, himanshu.madhani@oracle.com, John Garry Subject: [PATCH 4/4] io_submit.2: Document RWF_ATOMIC Date: Fri, 29 Sep 2023 09:37:17 +0000 Message-Id: <20230929093717.2972367-5-john.g.garry@oracle.com> X-Mailer: git-send-email 2.31.1 In-Reply-To: <20230929093717.2972367-1-john.g.garry@oracle.com> References: <20230929093717.2972367-1-john.g.garry@oracle.com> X-ClientProxiedBy: BL1PR13CA0070.namprd13.prod.outlook.com (2603:10b6:208:2b8::15) To DM6PR10MB4313.namprd10.prod.outlook.com (2603:10b6:5:212::20) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: DM6PR10MB4313:EE_|IA1PR10MB7197:EE_ X-MS-Office365-Filtering-Correlation-Id: 12f97f38-4e82-4ced-3036-08dbc0cfc1d6 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: OHIz+1BkDyUM5eWgiQb0Ssi0Ons14ONS2iQFWxv2M58J2tllPvLjGs9LXrriqme8EFwKaTs+KfblmgE6E5AuE8PLcqPiAPlVFIWcCJgDdfYCTsdtNFGCS5uRUS8OqS8wPN29CQ9TQCM+pJb1pAMyknk6BnPfxvbtZu7PgFbKxwzepSOaAvl+sb9yT3KPYrH58v4zCTg+o4kdEyRZfwPXndBM1ORjgyN/5Hw5nQ6AWRsn8KosZwufK17g71VycrzE2LG3nTLaCsNQ6jiIOFjafqRu9dvFuIbn/8gfX1BS+oT7j8QQWhCfsOKChCO6LWbBy4OWnZ9v5uCpktHKEulKtTz9rOtiZoC1kYxCCaU6WgSnJEwgjIAY4HThqbT4CGo/Hg6ko9xWHdik647g2xrbG5/oa4ZKAR7MO/v4k5zwYPBwCdLJl6Oh3HvLOLVhkmu5HZztb/m4RHrTSdvkwMTDunLjeWD+abxghX0EW2qWc5HLZgMooutE2jiMfHs82qnj/yzSGt8OUGA8S2eBkxSixiwv4XyLpGEI68RRdHWYvFgKpUgiwbRuS61qpQbxzAg9 X-Forefront-Antispam-Report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:DM6PR10MB4313.namprd10.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230031)(346002)(366004)(396003)(39860400002)(376002)(136003)(230922051799003)(186009)(64100799003)(451199024)(1800799009)(2906002)(86362001)(4744005)(103116003)(6506007)(6666004)(83380400001)(6512007)(5660300002)(38100700002)(6486002)(478600001)(36756003)(8676002)(8936002)(4326008)(1076003)(107886003)(2616005)(41300700001)(26005)(66556008)(66946007)(66476007)(316002);DIR:OUT;SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: a15QTDqeSvdDpTIcIsM2jEOdGrwrhCno5v9ntJJYlDsxM65GFmEVWLeINLlmYAtG2k4dHMDHWXyczNKWdxDfTjuTUwTe2KF0vL+OCMR0Uwc9FnXE5J0ecqEYgDR/lL1esZZD06hPtQR7G7VEO46Moie2AvnLZSO2QjEA0peBGOrFvznWiOEXZiGQ5nFvT2esJ+spsDahfPEM/t+EHC8D/ntye1bXW8rOZ+/OmWAjWpWDNNBC0d4ouk7RXhrksbreOEPkepkJ+h9A2JPOLuVuZbmC6akoMlJrAvdslNY0sE3Rt6vDQNU4lqH87eCJ0QOYCfZbfOMBlIeR+g2fAMPc9gq/jPimE9KZSO3iHWDyRrU1AL/dneK2zBFubv3cUzI/XEpDminrK39BJ2gaBC4yO6+nsXVCf1EqJaD5+Kb0243rNuCCiLfHAYKME0bJpErI9KLg8WvQEz0PZALMwQWkbxx4SNUKzP6F6DfGqn2bJOXtR1TEL5EcmnprQd6oYmB75yr2pYb5Hwle4dw9tZbQEjloPSI484tLCYr3bkMaSgVOEm6ixrPM7X4Cw7TLS+n/Z2SYB+smwk0kBbwhtW4Apc9C30w7vqrpfVhDq8FLJGZUIHPA+6KOf/rOpI57CkJ/WMsqsNa3EUpk//Oj30Nru7Xb695wfz6q3m6h+HihjZX9cq+UcaaipqBggaJjfXadvUxvEW5iq5esTnju2xitSdpIyV0pXwl0GkZM7I+t0d5c5+nQvPqoC0gYgTcrr83uRvKH/ZiqdY3h/RTKf4moYQZ1n8YhuycTuiT6JGJdwD95we5REDtAITGkmnQEpImQiu5mACxhfS6zaMHxG2Dbm0u/0fsjDpPECQeXFq1TtF3KevPJ+er85zjqX6h537SG8uc2Adsv5rh9SvUWzKLW9/ohjG6ryBos+jmjUQlFNBWzjxVFaz0vUf5Vz4Wlbw1CDTGFOVBEtWpIfVMmDMnzMsRjrKzPcjpXhOHVJyqjyDH1UKN/eT5T3DVA5BwcDA25JPyzmPzR3cTj01x/iRmHmur/1Y2JXHNqJEk7PBiDS5x6qNdkzq6acTiJAB9J89c8pP1e1FtqXfbLmXowQn4/pOe0L6cwIaxq2iGvwmnIdMpF4PuqbgpDbUznUuu5nJEKlmAxiZW1VVbiT/mv0K5+bcfUzsWfXS7oe645A6aGsRoyuCiiqfvZPuavYOO071fCrWSka6zLAI5wbWeOn2+JTfPHARur9In5C9EIXAnF1oP9nMnmSZlswnZ0va9q8pi6TSeNYDBwT/X43CU6XD1z0K4sCLT6iPTRY1AiLOxLZJZ4Rzh0qB09Fh/58q1zV5zhGAcIHa9i4bCHgZWxongF1kwnG1E28+8Z/UwPMCLvJREBEE1+YhyOwyWFmMe080DJaAMDQs0Z33m8H/k7bO7AuXzsq8S9yKs3ruzn/a3nJd2sF62ifrtXJbPvAPZAKA8Rs1OU65Ymd3d4Ur9PRFYad/KTRnrn7sf1JKhVCWFFNz4PnZFRZEpMuMHctoScMdksdt3TQ4xbQj+SjWso9KXmASeYdu0g+woUEIKZsMrG2kQmM7cv6NGzkgfnK4nAzpQm X-MS-Exchange-AntiSpam-ExternalHop-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-ExternalHop-MessageData-0: TNzWdvA5krFBwvLlNHwxJ/wg4R1Hgbj+b+8OPXvhGpYSnvlpI+SnwT1rwoc5yEsXLnr6NwrHs2c4RIifDlkBXFkyKYPKMTZpmi2tzM8lBlPdyPiy8erbXgxK9S82pbWxxEEYE0UdUEoUFKrO201sjEz0LEcSXZXpkKfS1sHtJjoYdd9lULC4WkDYeEi3glCxRBor+9QPEf6TBWTAXtWZlTW5Zcsg5elfqBZ8SChRILcA4zntiUc201lUiAdLcieWb4yD/fFZJf98ThTC15eoj7kmHmih4mLPr2ukVviSGHUQduNHo8VBGiE1NMOLWQrY5HyKl1KwStR4JypCHnxAMx9/07NaZRVNSrUf8vfvhhHcSXmdRsf9Jxrd1iUuP/pMCgXxPfs9ON9S3OmGmEmYOeZfCiS+Q+Vm6JtLvGx4W3+F/gqKu7gleSHYHc9STnfidU4ZdEGRj2wi7klsFX4GmaFTSUZ3v4kH6B1iDddNEqgcUl/XWNj1nibCL+WFQTJfk6X0daYqN3tmb7fz/HFOx1D+Nw5uOlag9lZ/zLTtsiXsru9cjq68ro4HWo3lNUjkI9HLG/K+HG1u2BxQLMt44wF4DIV2dHkTvzaBT3HJptcHB0tASZZnyqB9r+p3g+tHSXc0g283BbaQyZo0G5uWUseDgZF25QN1Jayo3RhZ1PPmG9eEym4+DkxqAqQl8lEcsRM0bIVl2I2RU6q380WZJOR2sAYQZCXSbFnB0lL+8BAnxE83v/K/4ffbI2LjXkSheqYF0Z4R2XseKPpJUMe84TxUQSPvJ3biUlE7FLkFmUESGGBmkdOsXnvLf+7CIe2rxirPsYrZ4WVIxCb5hGFvYQ== X-OriginatorOrg: oracle.com X-MS-Exchange-CrossTenant-Network-Message-Id: 12f97f38-4e82-4ced-3036-08dbc0cfc1d6 X-MS-Exchange-CrossTenant-AuthSource: DM6PR10MB4313.namprd10.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 29 Sep 2023 09:37:54.7629 (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: 0ooZyV3Ds3mAtUgKq4ZUGLSIlah6g21n2yUeA3NZ9lPbDdr4t0b258hWzk48ibND5kupsWNckf6IBaW422Nuug== X-MS-Exchange-Transport-CrossTenantHeadersStamped: IA1PR10MB7197 X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.267,Aquarius:18.0.980,Hydra:6.0.619,FMLib:17.11.176.26 definitions=2023-09-29_07,2023-09-28_03,2023-05-22_02 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 spamscore=0 bulkscore=0 mlxscore=0 mlxlogscore=999 suspectscore=0 phishscore=0 adultscore=0 malwarescore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2309180000 definitions=main-2309290083 X-Proofpoint-ORIG-GUID: CyzkjWuJMLdq0PAejmzEemeGfPpKrp95 X-Proofpoint-GUID: CyzkjWuJMLdq0PAejmzEemeGfPpKrp95 X-Spam-Status: No, score=-0.9 required=5.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI, SPF_HELO_NONE,SPF_PASS autolearn=unavailable autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on pete.vger.email Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (pete.vger.email [0.0.0.0]); Fri, 29 Sep 2023 02:39:15 -0700 (PDT) X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1778382780070512951 X-GMAIL-MSGID: 1778382780070512951 Document RWF_ATOMIC for asynchronous I/O. Signed-off-by: John Garry --- man2/io_submit.2 | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/man2/io_submit.2 b/man2/io_submit.2 index 1030bb6cd965..beba8865ac2a 100644 --- a/man2/io_submit.2 +++ b/man2/io_submit.2 @@ -140,6 +140,11 @@ as well the description of .B O_SYNC in .BR open (2). +.TP +.BR RWF_ATOMIC " (since Linux 6.7)" +Write a block of data such that a write will never be +torn from power fail or similar. See See the description +of the flag of the same name in pwritev2(2). .RE .TP .I aio_lio_opcode