log/syslog: document that this package no longer works after macOS 12.0

Per https://developer.apple.com/documentation/os/logging, Apple's syslog
no longer uses the legacy syslog and Apple System Logger (ASL) APIs
as of macOS 12.X (Monterey), 13.X (Ventura) and thus this package no
longer works and no longer listens on a UNIX domain socket, but it instead
uses Apple Unified Logging (AUL). With this package being frozen though,
the best that we can do is document this limitation.

Fixes #59229

Change-Id: Idd008d546705dfc751b170eddaf3c450e96c1dd6
Reviewed-on: https://go-review.googlesource.com/c/go/+/732640
Auto-Submit: Emmanuel Odeke <emmanuel@orijtech.com>
Reviewed-by: Michael Pratt <mpratt@google.com>
LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com>
Reviewed-by: David Chase <drchase@google.com>
This commit is contained in:
Emmanuel T Odeke
2025-12-25 02:35:27 -05:00
committed by Gopher Robot
parent 370513491a
commit 01b795bc4c

View File

@@ -22,3 +22,8 @@ package syslog
// see https://golang.org/issue/1108.
// BUG(akumar): This package is not implemented on Plan 9.
// BUG(odeke-em): As of Darwin's macOS 12.X (Monterey), Apple's syslog daemon no
// longer listens on a UNIX domain socket and instead now uses their proprietary
// Apple Unified Logging (AUL) system, hence this package will no longer work.
// Please see https://developer.apple.com/documentation/os/logging.