From nobody Wed Jan 31 18:36:02 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 4TQ9hy6QxBz59296; Wed, 31 Jan 2024 18:36:02 +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 4TQ9hy5ts9z4RDV; Wed, 31 Jan 2024 18:36:02 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1706726162; 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=JJoqRXbTPc0a20U0d+KvkS7a8fI886kO2gQzBU/a6Sk=; b=w8VkLMbBsJjQdNwKqv420yJiR/+KjuC+4sy157ZyZXJf27qMYtv/b8iNnuuewxdaGxg3A7 VBvjmMdx2srTiuwFF0D7CbHPgxwpj9J9aOnohXhUA9fFTdrnjZckhGMNZlOYGa2KYhszR0 jTA2zfNlOijBVCohclhzaj2MYs09Rr8EKeroRYHmzNAfc2W3nMeAfA4IMGW57w/yY86iwy /lKiwp0osHIcadHykDU1xI7SvZ4CXsIzCF9xAH9NoBCu9zAl/92YRcW2Badr6Jw9KU8ul3 xhBa80ec6Z6uWuCeIno3FFKA6HcWolbIF1ziEgPyOGZkIoSEE96TrM/pJLsm5g== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1706726162; 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=JJoqRXbTPc0a20U0d+KvkS7a8fI886kO2gQzBU/a6Sk=; b=C0hBVNAgpiIzotxfycGyFu0cKyhhkQKjWdIQDO3y1SQY6N7iWOMkEmVT7e5UVIeHNDfSbT 76pgeb8OwY3Q0GArRG5YuKAvqI1Vrr/nk+q8ll1ASLVVZnqp97JpeHViinKUv2IGFxpWDJ 5JnNPXDWb7r5906TK/vDuirDwLBb16vhoox4HCfrAqFl7EmQRv+pcGjED+nqqaoXhLcMc1 E7WpvXw4Xe/Y/PChP9+BR3uEThwTfHetmXtwIvsgD5loglkzfrt+7Gk7R+fWrpc4zHIpYU F9DIBlHkEvbqD17gRy2c68e4gBzIpe7ydNpu6xpGXyurMU0ONFAHIUPvl0PHGw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1706726162; a=rsa-sha256; cv=none; b=gFYk8lHeuvnmeKjqyPnyaEjPXpSs3WU9CWxkypRwqSP+2W1PVy5wis/RMCAWUPmA4R7ciy G3jnT0k0CWf6vcdr+Y2ugPzlYSyw4lJbD98aGapgqPQj5JBKkKhuRDB5FBNPecjRqB8tw6 j7LkK0FdCVTwVh/2QgiWc//BPRD7FBnG0C1YTbMF5Xkl0tgvFM4SyqzEoxJSpIjiJtCj8q 1GrrD22rcDXEKOpSCIe4ECwcw8qzf3OuZzbYAd3q1y4S9aZJ+7EWg6cNdPKg1vAni84NPu Wl+caaXR1vsBNLaDcIg0bas2PTz2Kh00UOBFs+0eEqMhVr7K0UVDyUuRgOenQQ== 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 4TQ9hy4ypszVDC; Wed, 31 Jan 2024 18:36:02 +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 40VIa2nX062657; Wed, 31 Jan 2024 18:36:02 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.17.1/8.17.1/Submit) id 40VIa2NM062654; Wed, 31 Jan 2024 18:36:02 GMT (envelope-from git) Date: Wed, 31 Jan 2024 18:36:02 GMT Message-Id: <202401311836.40VIa2NM062654@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Mitchell Horne Subject: git: 712fd5ac9181 - main - intro.9: minor changes 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: mhorne X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 712fd5ac9181b544d8ffcf88ab6313233c8ddaed Auto-Submitted: auto-generated The branch main has been updated by mhorne: URL: https://cgit.FreeBSD.org/src/commit/?id=712fd5ac9181b544d8ffcf88ab6313233c8ddaed commit 712fd5ac9181b544d8ffcf88ab6313233c8ddaed Author: Graham Perrin AuthorDate: 2023-08-06 17:34:03 +0000 Commit: Mitchell Horne CommitDate: 2024-01-31 18:31:32 +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 --- 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