From nobody Thu Apr 18 18:12:25 2024 X-Original-To: dev-commits-src-all@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 4VL5Tk0rrDz5HKN9; Thu, 18 Apr 2024 18:12:26 +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 4VL5Tj5VVQz3yvF; Thu, 18 Apr 2024 18:12:25 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1713463945; 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=/CF2CWUjrDa/7Rr/hGqmYXb7hwn+TE0+Aflss/0P+Y0=; b=xKpKUWkTjMvWwPrUty4qAjxNSqqlxmfUhF1Lbt3viludimA5gGEjxzT5QGwyfXPbH7Okof 9juDoqvEvbb7wDNKOx+GzD98kDuXVnXktt0M3AvH0mtFX4MEYsPPd65Buj2eosPCnv+tSk 1DOXR36HXFO2dDbKFlxFx4gI3sU6DJNtFQy9jgQ34AaLg0Bv5bqINOrwNlki9LpUlx10qd vni97m9WlyLMyxZTnxBXX+mdjs92YypnrljA0L2qMx36+uIfX55oVKwPASi2vdQXj+pErj pAqZc+ST7i+pg6+jGGOzIh5A3hcBXXNwGP8IrDyxex/7DZ7fOvMTnkiGel6R8g== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1713463945; a=rsa-sha256; cv=none; b=rxGDLqI9sV5g1vL+twthl+VluOIu1ckXhBEj5ESml3O7tAan1ghonWOEVl0h3LT+2/Froe W2PW9lm3B9DnwsFhpbnAxK1EEpr/Xka87/YHzery97AmDGlx9Q/27QmT5wWQMHXXQSxibm gRibkOoRWWPCkWnVd6h6C7P+z6EcE2MC6PeMYusaUtHF2rzW73BhJ+0f/qTziVvdYzwkb0 bqgW5bTUZ0rWp5WZdqmRLn7bU5FDTQWeTwU8tJV/d6AZCxlqZIoaJsNtRZBbOZ8CMtp6X4 eTXVkgQTYm2YriT07MlJOu/SaCyOyzuyvc/qVHKfMgUbnc5+UCNpLkYWZN++lA== 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=1713463945; 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=/CF2CWUjrDa/7Rr/hGqmYXb7hwn+TE0+Aflss/0P+Y0=; b=BzpMWmApxeMTl5wkPLNttwlaCTNd9EzQBHMqHBv+qIZvAon5MLtmDeftO29Et7W2xY9660 vQDQegBYo6JDG2egvMyUjnq6VvFhHWAabXBGO7NmQXo8wEyp7vlYMnaNWlCjawkoTqQfyi 6Co5kcqsyN9qJaDht1vQwQrK1/LaqDMxtEpOPfO9HTD8aRvksIptl+Sol7U1vrdAwnQO0m MwZLusPXsvPENfSXBT7Iq3/bHXGsVvaYw/OIk266d7RBIjNpHhzTDgCQN4u4Oxzt6Ae2ZP XIeBNIiaF+ith4uKIAbZ5jzx/nHf7dW5iF6py4cuIoems1jerk6W8qc3f7rvbw== 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 4VL5Tj55tgzL1F; Thu, 18 Apr 2024 18:12:25 +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 43IICPOp016157; Thu, 18 Apr 2024 18:12:25 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.17.1/8.17.1/Submit) id 43IICP5P016154; Thu, 18 Apr 2024 18:12:25 GMT (envelope-from git) Date: Thu, 18 Apr 2024 18:12:25 GMT Message-Id: <202404181812.43IICP5P016154@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org From: Mitchell Horne Subject: git: 9050a43e8e2c - stable/14 - intro.9: minor changes List-Id: Commit messages for all branches of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-all@freebsd.org Sender: owner-dev-commits-src-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: mhorne X-Git-Repository: src X-Git-Refname: refs/heads/stable/14 X-Git-Reftype: branch X-Git-Commit: 9050a43e8e2c458f7a93b55dc3f2c642dd26dbc1 Auto-Submitted: auto-generated The branch stable/14 has been updated by mhorne: URL: https://cgit.FreeBSD.org/src/commit/?id=9050a43e8e2c458f7a93b55dc3f2c642dd26dbc1 commit 9050a43e8e2c458f7a93b55dc3f2c642dd26dbc1 Author: Graham Perrin AuthorDate: 2023-08-06 17:34:03 +0000 Commit: Mitchell Horne CommitDate: 2024-04-18 18:11:30 +0000 intro.9: minor changes A correction: 'and' -> 'an'. Plus, several tweaks for brevity or clarity. Reviewed by: mhorne MFC after: 3 days Pull Request: https://github.com/freebsd/freebsd-src/pull/813 (cherry picked from commit 712fd5ac9181b544d8ffcf88ab6313233c8ddaed) --- share/man/man9/intro.9 | 40 ++++++++++++++++++++-------------------- 1 file changed, 20 insertions(+), 20 deletions(-) diff --git a/share/man/man9/intro.9 b/share/man/man9/intro.9 index 458ee0ab4697..e13566725976 100644 --- a/share/man/man9/intro.9 +++ b/share/man/man9/intro.9 @@ -6,7 +6,7 @@ .\" This manual page was written by Mitchell Horne under .\" sponsorship from the FreeBSD Foundation. .\" -.Dd August 2, 2023 +.Dd January 30, 2024 .Dt INTRO 9 .Os .Sh NAME @@ -16,7 +16,7 @@ Welcome to the .Fx kernel documentation. -Outside of the source code itself, this set of +Outside the source code itself, this set of .Xr man 1 pages is the primary resource for information on usage of the numerous programming interfaces available within the kernel. @@ -177,9 +177,10 @@ The kernel interface for file systems is File system implementations register themselves with .Xr vfsconf 9 . .Pp -The abstract and filesystem-independent representation of a file, directory, or -other file-like entity within the kernel is the -.Xr vnode 9 . +The +.Xr vnode 9 +is the abstract and filesystem-independent representation of a file, +directory, or other file-like entity within the kernel. .Pp The implementation of access control lists for filesystems is described by .Xr acl 9 . @@ -371,7 +372,7 @@ Signals can be sent to processes or process groups using the functions described by .Xr psignal 9 . .Ss Security -See the generic security overview in +See the overview in .Xr security 7 . .Pp The basic structure for user credentials is @@ -397,7 +398,7 @@ see .Xr mac 9 . .Pp Cryptographic services are provided by the OpenCrypto framework. -This API provides and interface for both consumers and crypto drivers; +This API provides an interface for both consumers and crypto drivers; see .Xr crypto 9 . .Pp @@ -409,9 +410,9 @@ and The interfaces for declaring loadable kernel modules are described by .Xr module 9 . .Ss Interrupts -The machine-independent portion of the interrupt framework supporting the -registration and execution of interrupt handlers is described by -.Xr intr_event 9 . +.Xr intr_event 9 +describes the machine-independent portion of the interrupt framework +that supports registration and execution of interrupt handlers. .Pp Software interrupts are provided by .Xr swi 9 . @@ -450,17 +451,16 @@ Kernel sanitizers can perform additional compiler-assisted checks against memory use/access. These runtimes are capable of detecting difficult-to-identify classes of bugs, at the cost of a large overhead. -Supported is the Kernel Address Sanitizer -.Xr KASAN 9 , -and the Kernel Memory Sanitizer -.Xr KMSAN 9 . +The Kernel Address Sanitizer +.Xr KASAN 9 +and Kernel Memory Sanitizer +.Xr KMSAN 9 +are supported. .Pp The -.Cd LOCK_PROFILING +.Xr LOCK_PROFILING 9 kernel config option enables extra code to assist with profiling and/or -debugging lock performance; -see -.Xr LOCK_PROFILING 9 . +debugging lock performance. .Ss Driver Tools Defined functions/APIs for specific types of devices. .Bl -tag -width "Xr usbdi 9" @@ -514,6 +514,6 @@ The kernel object implementation is described by .Xr man 1 , .Xr style 9 .Rs -.%T "The FreeBSD Architecture Handbook" -.%U "https://docs.freebsd.org/en/books/arch-handbook/" +.%T The FreeBSD Architecture Handbook +.%U https://docs.freebsd.org/en/books/arch-handbook/ .Re