From nobody Fri Jun 16 16:45:06 2023 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 4QjQ4f55V0z4dvJH; Fri, 16 Jun 2023 16:45:06 +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 4QjQ4f2h5sz3HgS; Fri, 16 Jun 2023 16:45:06 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1686933906; 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=qL+dOpmZmiZp3IFp9bkRU6P7RimdQffH+0F3j7wYXhs=; b=XGgbwthsNG0lwzR1HjLRqB/43A9r9tFvrAWqjyUAIR8f+XnPnVbB7/gGfyiHrqtzZlsUpD W3bBWhSXVx05hRVnb013VONIOz8OBPQ8uPeyDu6JLpi1qgIbeTK89FXKhun9mXuEptTG3l cnz565Hj3wYVNxUMvH7VpK3OBrrlI9yKybKGAQeUNzTtTWXQ8aiZcn+l6YFi6oyzhTLoVj 8gYFsZCKh7FVaM/IgbSdgciPYzl92gId+P0aszGsRkkB0TscDahl50vOas9kEOGr04qLvO soKRWyhHEOFO7/NG2d+W1AL20ualIPY1yx9bTPS/1crON8Cc/gBxRVL0uvJAxw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1686933906; 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=qL+dOpmZmiZp3IFp9bkRU6P7RimdQffH+0F3j7wYXhs=; b=yR+T2ACzpJMNfANRxXE6MPcyMGzx1ArL6PjytHFxD8qMkHlSoQNwe5epyfVeOrKPEBxJL1 zAepJuHRihc5/GBotf/8leO5n+E9kfyO/5ySCG2/EM4v89ofvF9thp6zghyGm+SdF3zieO 6B5T9fb9+a9iWr8d8xAr+sKZBdOSovPYuBPzmrjfCDRKaiFDdhZCwfk40T2tUj7W5tHvbo LKWIvmHXEB/6CXssEiuqTx/K8BYJDXDAhW12PAg9hVJcYdSrYUpeXAsR+NBmtOWRrbmwFM j4FpRYd/w3h8CRYW/ZQQUBGgs/G7BRgsUIAsE8G5ms5Ahh36YFoT46htMNsCvQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1686933906; a=rsa-sha256; cv=none; b=CcqsFxIKv1kA5ZpbFWV80rEmXHZA8OiJhi1GuuFGkMVkoxgq7G9E0/ZHKnFGPq+upnVb5E JHouyO+CsAlRve3Tjm/7m46aIt0TorYoLcIo7673rCnCCSI76E/DlsKMC9GP8m/f+Ma4kV 3WHqaQPePl4BEjFPNnodlh+HflpaTn+Ce18tAwSWln9hfSu2HCTOWzABUXLvADojNAoABT y5LzERqWvorVITH84w32WEwfv6L1/H3h5PK1zlHWMUDjxDugnukGmezj1lp/MFbE6X00eY TRZ+WWnsaVZ3gJXWtUH/kAFFwgkL6yYVfJwnczDWYQvVwEWn0nmDcRL2JlfbsA== 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 4QjQ4f1kZWzbm6; Fri, 16 Jun 2023 16:45:06 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 35GGj6Un072846; Fri, 16 Jun 2023 16:45:06 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 35GGj6jo072845; Fri, 16 Jun 2023 16:45:06 GMT (envelope-from git) Date: Fri, 16 Jun 2023 16:45:06 GMT Message-Id: <202306161645.35GGj6jo072845@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: 0a1a48148ccd - main - hwpmc(4): more detailed SYNOPSYS 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: 0a1a48148ccd561464d643c05597cec2ae9e88b8 Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by mhorne: URL: https://cgit.FreeBSD.org/src/commit/?id=0a1a48148ccd561464d643c05597cec2ae9e88b8 commit 0a1a48148ccd561464d643c05597cec2ae9e88b8 Author: Mitchell Horne AuthorDate: 2023-06-16 16:38:03 +0000 Commit: Mitchell Horne CommitDate: 2023-06-16 16:44:54 +0000 hwpmc(4): more detailed SYNOPSYS Include some boilerplate similar to other section 4 man pages, describing how to load the module at boot-time or include it in the kernel. Reviewed by: jkoshy, emaste MFC after: 1 week Sponsored by: The FreeBSD Foundation Differential Revision: https://reviews.freebsd.org/D40542 --- share/man/man4/hwpmc.4 | 18 +++++++++++++++++- 1 file changed, 17 insertions(+), 1 deletion(-) diff --git a/share/man/man4/hwpmc.4 b/share/man/man4/hwpmc.4 index de38041bf640..6c9e90b36c2d 100644 --- a/share/man/man4/hwpmc.4 +++ b/share/man/man4/hwpmc.4 @@ -35,11 +35,27 @@ .Nm hwpmc .Nd "Hardware Performance Monitoring Counter support" .Sh SYNOPSIS +The following option must be present in the kernel configuration file: +.Bd -ragged -offset indent .Cd "options HWPMC_HOOKS" -.Cd "device hwpmc" +.Ed .Pp Additionally, for i386 systems: +.Bd -ragged -offset indent .Cd "device apic" +.Ed +.Pp +To load the driver as a module at boot time, place the +following line in +.Xr rc.conf 5 : +.Bd -literal -offset indent +kld_list="${kld_list} hwpmc" +.Ed +.Pp +Alternatively, to compile this driver into the kernel: +.Bd -ragged -offset indent +.Cd "device hwpmc" +.Ed .Sh DESCRIPTION The .Nm