Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.36 as permitted sender) client-ip=23.128.96.36;
From:   John Garry <john.g.garry@oracle.com>
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 <john.g.garry@oracle.com>
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>
In-Reply-To: <20230929093717.2972367-1-john.g.garry@oracle.com>
References: <20230929093717.2972367-1-john.g.garry@oracle.com>
Content-Transfer-Encoding: 8bit
Content-Type: text/plain
MIME-Version: 1.0
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?a15QTDqeSvdDpTIcIsM2jEOdGrwrhCno5v9ntJJYlDsxM65GFmEVWLeINLlm?=
 =?us-ascii?Q?YAtG2k4dHMDHWXyczNKWdxDfTjuTUwTe2KF0vL+OCMR0Uwc9FnXE5J0ecqEY?=
 =?us-ascii?Q?gDR/lL1esZZD06hPtQR7G7VEO46Moie2AvnLZSO2QjEA0peBGOrFvznWiOEX?=
 =?us-ascii?Q?ZiGQ5nFvT2esJ+spsDahfPEM/t+EHC8D/ntye1bXW8rOZ+/OmWAjWpWDNNBC?=
 =?us-ascii?Q?0d4ouk7RXhrksbreOEPkepkJ+h9A2JPOLuVuZbmC6akoMlJrAvdslNY0sE3R?=
 =?us-ascii?Q?t6vDQNU4lqH87eCJ0QOYCfZbfOMBlIeR+g2fAMPc9gq/jPimE9KZSO3iHWDy?=
 =?us-ascii?Q?RrU1AL/dneK2zBFubv3cUzI/XEpDminrK39BJ2gaBC4yO6+nsXVCf1EqJaD5?=
 =?us-ascii?Q?+Kb0243rNuCCiLfHAYKME0bJpErI9KLg8WvQEz0PZALMwQWkbxx4SNUKzP6F?=
 =?us-ascii?Q?6DfGqn2bJOXtR1TEL5EcmnprQd6oYmB75yr2pYb5Hwle4dw9tZbQEjloPSI4?=
 =?us-ascii?Q?84tLCYr3bkMaSgVOEm6ixrPM7X4Cw7TLS+n/Z2SYB+smwk0kBbwhtW4Apc9C?=
 =?us-ascii?Q?30w7vqrpfVhDq8FLJGZUIHPA+6KOf/rOpI57CkJ/WMsqsNa3EUpk//Oj30Nr?=
 =?us-ascii?Q?u7Xb695wfz6q3m6h+HihjZX9cq+UcaaipqBggaJjfXadvUxvEW5iq5esTnju?=
 =?us-ascii?Q?2xitSdpIyV0pXwl0GkZM7I+t0d5c5+nQvPqoC0gYgTcrr83uRvKH/ZiqdY3h?=
 =?us-ascii?Q?/RTKf4moYQZ1n8YhuycTuiT6JGJdwD95we5REDtAITGkmnQEpImQiu5mACxh?=
 =?us-ascii?Q?fS6zaMHxG2Dbm0u/0fsjDpPECQeXFq1TtF3KevPJ+er85zjqX6h537SG8uc2?=
 =?us-ascii?Q?Adsv5rh9SvUWzKLW9/ohjG6ryBos+jmjUQlFNBWzjxVFaz0vUf5Vz4Wlbw1C?=
 =?us-ascii?Q?DTGFOVBEtWpIfVMmDMnzMsRjrKzPcjpXhOHVJyqjyDH1UKN/eT5T3DVA5Bwc?=
 =?us-ascii?Q?DA25JPyzmPzR3cTj01x/iRmHmur/1Y2JXHNqJEk7PBiDS5x6qNdkzq6acTiJ?=
 =?us-ascii?Q?AB9J89c8pP1e1FtqXfbLmXowQn4/pOe0L6cwIaxq2iGvwmnIdMpF4PuqbgpD?=
 =?us-ascii?Q?bUznUuu5nJEKlmAxiZW1VVbiT/mv0K5+bcfUzsWfXS7oe645A6aGsRoyuCii?=
 =?us-ascii?Q?qfvZPuavYOO071fCrWSka6zLAI5wbWeOn2+JTfPHARur9In5C9EIXAnF1oP9?=
 =?us-ascii?Q?nMnmSZlswnZ0va9q8pi6TSeNYDBwT/X43CU6XD1z0K4sCLT6iPTRY1AiLOxL?=
 =?us-ascii?Q?ZJZ4Rzh0qB09Fh/58q1zV5zhGAcIHa9i4bCHgZWxongF1kwnG1E28+8Z/UwP?=
 =?us-ascii?Q?MCLvJREBEE1+YhyOwyWFmMe080DJaAMDQs0Z33m8H/k7bO7AuXzsq8S9yKs3?=
 =?us-ascii?Q?ruzn/a3nJd2sF62ifrtXJbPvAPZAKA8Rs1OU65Ymd3d4Ur9PRFYad/KTRnrn?=
 =?us-ascii?Q?7sf1JKhVCWFFNz4PnZFRZEpMuMHctoScMdksdt3TQ4xbQj+SjWso9KXmASeY?=
 =?us-ascii?Q?du0g+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: <linux-kernel.vger.kernel.org>
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:38:58 -0700 (PDT)

Document RWF_ATOMIC for asynchronous I/O.

Signed-off-by: John Garry <john.g.garry@oracle.com>
---
 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
-- 
2.31.1