From nobody Thu Oct 01 06:12:02 2026 X-Original-To: dev-commits-src-branches@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 4hwM4y47NZz6v4jn for ; Thu, 01 Oct 2026 06:12: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 "YR2" (not verified)) by mx1.freebsd.org (Postfix) with ESMTPS id 4hwM4y3NzCz4KfP for ; Thu, 01 Oct 2026 06:12:02 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1790835122; 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=UL4Xlb+dA5xHIVYkCv4pFTSHiSBkt2mGxeb4hJQ/8yA=; b=Cn9To9F69iBzv/ssPAUj8fvgoo1VLhQMsHljWXNKXL9JAiSAau9bPlFmuBrfzTXoSqUQh6 ihIV0J5PcUDn/mJkRCwEXJYRVeoMiZwFdvsqNWuWsiHVgPlhv0vkLp16qu2MA1crGenITr ORgW1vchNMlarjln/wsFa4XzuAAIVSOj+ZEI5jxiAxigGY/yTPd7zWl7mS8P/Q52JVakKm JOpTpdT5kCsehrgK5/rQMQ2+R6C1EU0jTwh8kAn89JHvHz2xBjixv+3/ma7gCiAiZrPbH6 LNM3OyN8EjWOcZJN7tRmp986Y6JprV19yE9AZPTFMA40impj6zNjw7HE1E57Kw== ARC-Seal: i=1; a=rsa-sha256; d=freebsd.org; s=dkim; cv=none; t=1790835122; b=mwNCo9zvYYgrWtzretD5mwmO3DptQj9277KOrYPS43iZTNON25xNyw+n7YoPFEm/agV5pa 47MjQ77JfcRFf65gKXXqxE8e04c4K6dbf54CPJcLkfpoyeWDeaQtfO7lsj2DpoXgDJQIeK UyMBUTt671HUsyY7tkMgq4QhAwO+YwqMUjC57jOmDNmLWDXKknVBlCE6CCvxyS8Q2Abnso xT3YMVZF7VpedAi15snexFNO23w4ixwA2fI3BI3x4aLBmJf/cx6Tnn7QYT32jLXmNV5PAA BYcYHJkIZqVgQ6Hd5Wt9HOifNBo5t+NXylUFqUIpMBrZM0gtJK/zfu2fFlm30A== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1790835122; 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=UL4Xlb+dA5xHIVYkCv4pFTSHiSBkt2mGxeb4hJQ/8yA=; b=GtLjTwNIjc3P16vbKUTuCs/JrYKvio+wyuxEthnp7ILKRnqnHVP7DP+shZdl1ZmFGgvH/j jUEvG6D8YGOk7lazcSnNu2vlQJLVJy7SHWWVkOPuhc27StyCZkmmjbz3zmjSfUAs/LzgU8 bKrOMTG1wCfIH1/oAB+zPBOQV3iVJGwZh83Cq0n6p1uv+5KTTNZZB0lKcRX4PrO0wdpxBM j7TuqCsS2OS1hiqtrmw7Ean9JDCvvstJnqyR0mcHuS7oCH4sksUMfAJXvzXWESsZ9V1eKS 7amdou6STtG/m7rTlJI9YpDD9VsQvUwgtjpdrJg3pGZtHlLtvzCkDI1rlvveiA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) by mxrelay.nyi.freebsd.org (Postfix) with ESMTP id 4hwM4y2SGBzJMF for ; Thu, 01 Oct 2026 06:12:02 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 4557b by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Thu, 01 Oct 2026 06:12:02 +0000 To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org From: Enji Cooper Subject: git: 220e946f3f33 - stable/14 - asmc.4: clean up/modernize manpage List-Id: Commits to the stable branches of the FreeBSD src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-branches List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-branches@freebsd.org Sender: owner-dev-commits-src-branches@FreeBSD.org List-Id: List-Post: List-Help: List-Subscribe: List-Unsubscribe: List-Owner: Precedence: list MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: ngie X-Git-Repository: src X-Git-Refname: refs/heads/stable/14 X-Git-Reftype: branch X-Git-Commit: 220e946f3f333239798a3b231406d121720899b9 Auto-Submitted: auto-generated Date: Thu, 01 Oct 2026 06:12:02 +0000 Message-Id: <6abdf9b2.4557b.3f3620b4@gitrepo.freebsd.org> The branch stable/14 has been updated by ngie: URL: https://cgit.FreeBSD.org/src/commit/?id=220e946f3f333239798a3b231406d121720899b9 commit 220e946f3f333239798a3b231406d121720899b9 Author: Enji Cooper AuthorDate: 2026-09-06 22:22:50 +0000 Commit: Enji Cooper CommitDate: 2026-10-01 06:11:57 +0000 asmc.4: clean up/modernize manpage - sysutils/ataidle is no more: it was superseded by camcontrol(8). - Sort the models table alphabetically. - Use the SPDX License ID instead of the longhand licensing tort in the manpage header. - Note that the driver has been heavily modified in 15.1 and later to support additional platforms and functionality. - Trim down SYNOPSIS. MFC after: 2 weeks Differential Revision: https://reviews.freebsd.org/D59470 (cherry picked from commit 7a039603a49db09fa574b4365ba36c92b7658868) --- share/man/man4/asmc.4 | 116 ++++++++++++++++++++------------------------------ 1 file changed, 46 insertions(+), 70 deletions(-) diff --git a/share/man/man4/asmc.4 b/share/man/man4/asmc.4 index 9216f48498fd..0e86690c36b2 100644 --- a/share/man/man4/asmc.4 +++ b/share/man/man4/asmc.4 @@ -1,70 +1,26 @@ .\" .\" Copyright (c) 2007, 2008, 2009 Rui Paulo -.\" All rights reserved. +.\" Copyright (c) 2026 Enji Cooper .\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. +.\" SPDX-License-Identifier: BSD-2-Clause .\" -.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR -.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED -.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE -.\" DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, -.\" INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES -.\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR -.\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) -.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, -.\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN -.\" ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE -.\" POSSIBILITY OF SUCH DAMAGE. -.\" -.Dd April 2, 2019 +.Dd September 6, 2026 .Dt ASMC 4 .Os .Sh NAME .Nm asmc -.Nd device driver for the Apple System Management Controller (SMC) +.Nd Apple System Management Controller driver .Sh SYNOPSIS To compile this driver into the kernel, place the following line in your kernel configuration file: .Bd -ragged -offset indent -.Cd "device asmc" -.Ed -.Pp -Alternatively, to load the driver as a -module at boot time, place the following line in -.Xr loader.conf 5 : -.Bd -literal -offset indent -asmc_load="YES" -.Ed +.Cd device asmc .Sh DESCRIPTION The .Nm driver controls the Apple System Management Controller (SMC for short) found on Intel Apple systems. .Pp -The SMC is known to be found on the following systems: -.Pp -.Bl -bullet -offset indent -compact -.It -MacBook -.It -MacBook Pro -.It -Intel MacMini -.It -Mac Pro -.It -MacBook Air -.It -Intel iMac -.El -.Pp With this driver, you can configure your keyboard backlight brightness, check temperatures of several sensors, check the speed of the internal fans and check the status of the Sudden Motion Sensor. @@ -74,10 +30,8 @@ Variables related to the SMC control and inspection are exported via under the device tree .Va dev.asmc . .Sh KEYBOARD BACKLIGHT -On -.Tn MacBook Pro -systems, you can control the keyboard brightness by writing a value to -the +The keyboard brightness on all laptop models, e.g., MacBook Pro, can be +controlled by writing a value to the .Va dev.asmc.%d.light.control sysctl MIB or with .Xr backlight 8 @@ -157,39 +111,56 @@ all relate to the SMS. .Pp The most interesting usage of this device is to park the disk heads when the laptop is moved harshly. -First, you need to install -.Xr ataidle 8 Pq Pa ports/sysutils/ataidle -and then configure +Configure .Xr devd 8 -the following way: +the following way to automatically park your hard drives using +.Xr camcontrol 8 : .Bd -literal -offset indent notify 0 { match "system" "ACPI"; match "subsystem" "asmc"; - action "/usr/local/sbin/ataidle -s X Y"; + action "/sbin/camcontrol idle X"; }; .Ed .Pp -Do not forget to change the +Do not forget to change .Ar X -and -.Ar Y -values in the command above. +in the command example to match the target hard drive, e.g., +.Pa ada0 . .Pp Also, please note that parking the disk heads too many times can dramatically reduce your hard drive's life span. -Do not rely solely on -the SMS to protect your hard drive: good care and common sense can -increase your hard drive's life. +Do not rely solely on the SMS to protect your hard drive: good care and +common sense can increase your hard drive's life. +.Sh HARDWARE +The +.Nm +driver supports the Apple SMC on the following systems: +.Pp +.Bl -bullet -offset indent -compact +.It +iMac +.It +MacBook +.It +MacBook Air +.It +MacBook Pro +.It +Mac Mini +.It +Mac Pro +.El .Sh FILES -.Bl -tag -width ".Pa /dev/backlight/asmc0" -compact +.Bl -tag -width "/dev/backlight/asmc0" -compact .It Pa /dev/backlight/asmc0 Keyboard .Xr backlight 8 device node. .Sh SEE ALSO -.Xr ataidle 8 Pq Pa ports/sysutils/ataidle , +.Xr apple_bce 4 , .Xr backlight 8 , +.Xr camcontrol 8 , .Xr devd 8 , .Xr sysctl 8 .Sh HISTORY @@ -197,9 +168,14 @@ The .Nm driver first appeared in .Fx 8.0 . +The driver was heavily modified in +.Fx 15.1 +to support additional Apple SMC functionality and platforms. .Sh AUTHORS .An Rui Paulo Aq Mt rpaulo@FreeBSD.org -(Google Summer of Code project) +wrote +.Nm +as a 2007 Google Summer of Code project. .Sh BUGS -Support for the latest models was never tested and is most likely not -fully working. +This driver also supports ARM64 Mac models (in theory), but this has not +been tested yet.