From nobody Sat Mar 02 03:38:03 2024 X-Original-To: dev-commits-src-main@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4TmrJW4zsNz5Brbq; Sat, 2 Mar 2024 03:38:03 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4TmrJW4L4Lz4kGq; Sat, 2 Mar 2024 03:38:03 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1709350683; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=NTOwl0kos5g65HTHZZuyTO9vNiouONCQjIYlwA07A14=; b=H7/4htJpITftcPSPgnDPLGQ3+dqqUQjgAQPhpzEfaJQ5EZFMNrWSrD0RpwvAYW+DapGtLi wVp17pINi7HCbjeugVia33MPCjEAGHIVrv78UIIXV4b5VMc38EqFbQ8qs17lEJsFTRvEI9 PVAcDrKnH8kzlYK7OrjfA2liVY7czCTHq3GWKYcmFm8Z0DpU24uLtog8kC4rKOs2HoWEn4 o7nrO9YxO3/C/8UU9+2zslATMFIbe3vaqmB/GANTybHEUmmmdjs+5Mul9UIiaMjYM6iydS daRJ3W6iZ93lM3E1eQEbhX4gR0fgIaGcOeW9LHaeM4Av9MdGuJDuU5UA9n3rLA== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1709350683; a=rsa-sha256; cv=none; b=cR2pmqI8VsgLTsFes9RjEa6L8KAh/I7YY1euIMbdAElXgZwmeq1WD2o6P6mp9wDsEYKEDN tADOpVEBYGh74gnCtot2ln3P5IhEZI/TLXebEMOLB9s4XjWKvouoDSdqvzCkNmL9wWD0WG hFytAYtSJPBW/8Trs8V3rlVLhdqfexOiEiwSV18AJ9CiGtIJJ4tICbfPmlwlXoLpmjay2U zwdwNMWfjDtFlxrXSvFPePPsI/ZGIpl/WbElGx10K3OaybOBUldnmZR/r97p07cLy8jbt5 MK8fDy0nShL/gduXTiPduDHDii0eWxxU6dd2xVh5BVBnsr2xIqIamW7w7P2nkg== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1709350683; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=NTOwl0kos5g65HTHZZuyTO9vNiouONCQjIYlwA07A14=; b=F38Fzkjrjc8Ce69FkNLUoEVoFUWmAPOn8lKIXOwgA89Qi6O1TpMjBYlIg6M2Wq2SdzmC34 n4//l9ZIV9OO1JrEhwRIIPNieG/2yx+VrGxRS1qFuaXOvCQCehT3+kX9+WhWH8AW10mynX z2RdAyrv34Wuoh/DtSawofLhwk+sb0EqgTKkq/6anThW90ucbPQiKWNPE/LwacwIunbWcH WeR8WxN0jnNX7f2m3o6Ys310JUqaNOo9jl52wsV8DmO10kV8QILFIDLK/dshse7rSLGQ0U 9epA2112nxlOaN2AR9PJn7a0w5vkoUu4VR0n5N+sM28jQbOCxpdY9P8SshFnwQ== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4TmrJW3xCCztqc; Sat, 2 Mar 2024 03:38:03 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.17.1/8.17.1) with ESMTP id 4223c3ch098537; Sat, 2 Mar 2024 03:38:03 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.17.1/8.17.1/Submit) id 4223c3TP098534; Sat, 2 Mar 2024 03:38:03 GMT (envelope-from git) Date: Sat, 2 Mar 2024 03:38:03 GMT Message-Id: <202403020338.4223c3TP098534@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Warner Losh Subject: git: 0d161f7b60db - main - read.2: Use .Fn markup instead of .Xr for read/write calls List-Id: Commit messages for the main branch of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-main List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-src-main@freebsd.org X-BeenThere: dev-commits-src-main@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: imp X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 0d161f7b60dbc0b0d0bdb8e0d289e196c22e831b Auto-Submitted: auto-generated The branch main has been updated by imp: URL: https://cgit.FreeBSD.org/src/commit/?id=0d161f7b60dbc0b0d0bdb8e0d289e196c22e831b commit 0d161f7b60dbc0b0d0bdb8e0d289e196c22e831b Author: Christopher Davidson AuthorDate: 2024-03-02 03:32:37 +0000 Commit: Warner Losh CommitDate: 2024-03-02 03:34:10 +0000 read.2: Use .Fn markup instead of .Xr for read/write calls Udpate both write / read references from .Xr to .Fn to eliminate self-reference cross reference. Reviewed by: imp Pull Request: https://github.com/freebsd/freebsd-src/pull/1128 --- lib/libsys/read.2 | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/lib/libsys/read.2 b/lib/libsys/read.2 index 94644045afc1..123851128291 100644 --- a/lib/libsys/read.2 +++ b/lib/libsys/read.2 @@ -129,15 +129,15 @@ before the end-of-file, but in no other case. In accordance with .St -p1003.1-2004 , both -.Xr read 2 +.Fn read and -.Xr write 2 +.Fn write syscalls are atomic with respect to each other in the effects on file content, when they operate on regular files. If two threads each call one of the -.Xr read 2 +.Fn read or -.Xr write 2 , +.Fn write , syscalls, each call will see either all of the changes of the other call, or none of them. The