From nobody Mon Jan 06 23:46:37 2025 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 4YRrRy3L4qz5kQdY; Mon, 06 Jan 2025 23:46:38 +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 "R11" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4YRrRy0nt8z44Q2; Mon, 6 Jan 2025 23:46:38 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1736207198; 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=GcQPyx1NC3NITlHdFkbnO/SCfG/AoW110B1Hu1g0VH0=; b=Fbp1C5+VDIDfBq2yp5VxKnOkCRekX35s/A3dhXky8R9BsBWxqL5FYPt0bwFYRIfpM+nW5e hGU/DzM9VymBZlfWeo8XczHycsKDd53zr5CUB5Vwhgi+yPdJ9QebvUPzc+lcKIBJSxTViq 9MQVIkRRS/nMXGfTh9TtHS76tJiz95VTKxCP0CiK1VsO5M7Ubdgc58bkcYW2lVE0DSler3 P7tXO8J38knx/0Lv0MaXFWJqqBmjDHkuOvU6zI+JIaLcjQs134y7WLZFgzfXF1puy/Tk4p KL8twZatj5lI4DK6CvBKaCGpWvCfz/GO+7gOINfk2VsNkEHKWjYGyhGEVZ9bKw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1736207198; 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=GcQPyx1NC3NITlHdFkbnO/SCfG/AoW110B1Hu1g0VH0=; b=SeoLfWkARXnpP8+nhxiV5PZ9LFdvRxCWtLkN7Px4HuIB46S7R1eADFSq4yHz/cdE+eck5z rl5h8J/Y50dLMbAb/+6rVAYMfP8cO9ANLvgrCJHyb5RZCHy3KbX9OY4VoITFrsdiGruYSw dkfJeVnLkrvx4a5IWOTZpvUwY0t1lIBmzZOua1SDG76Lb9cuKrDVCWK5UdpxTlgvBx3P0m TauatWrPQlubZG05nnq7nQzAmgf2W8iGC0IGVc2VDu/Oc0AvRDL09My0jtKt035Tz7T/Ow /iAUWWhmxjaqBpCmIG/3hDH3iAuT+fBt4DBMV81bMGw+m30zOC+4GMaXdZ9D2Q== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1736207198; a=rsa-sha256; cv=none; b=WX+iFuI1PkNdnCYHSyq7rVK2xbZVasw+zPonSntrACs4Q+GMrpF/rB+OMxwrINOsmvxALt D5bc771WB4B4uqpJsjOh6FupXfd1KRBPQRVgZovMPwCxErpfmdgWahYuAaLyZdJFeTTQ32 84a3kJmhAH1dmN37e+3YVFGaH3Fj8CeTjXTMj/0ARvkBIgT54agsfxs6XAJVZA3ZLxFbLz 1SFafp6KuiUV63YtM/Z0LZ2odj2z+vM0DGmjkwVo1SoEqi92hWxiX5rhDaXMQgz8DyajN3 RPqDwX5ruRI+0epyHB63J/gcvWj/Bpy+FVvp4D+lqj1nrSywqDONbVUF5rVXAA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none 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 4YRrRy06ynzmCw; Mon, 06 Jan 2025 23:46:38 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 506Nkbuj045278; Mon, 6 Jan 2025 23:46:37 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 506NkbV6045275; Mon, 6 Jan 2025 23:46:37 GMT (envelope-from git) Date: Mon, 6 Jan 2025 23:46:37 GMT Message-Id: <202501062346.506NkbV6045275@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Warner Losh Subject: git: cfd8866818ab - main - cdefs.h: Add warning about defining __BSD_VISIBLE and friends 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: X-BeenThere: dev-commits-src-main@freebsd.org Sender: owner-dev-commits-src-main@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: imp X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: cfd8866818abb68fbfbffb925298c0b457cb32b5 Auto-Submitted: auto-generated The branch main has been updated by imp: URL: https://cgit.FreeBSD.org/src/commit/?id=cfd8866818abb68fbfbffb925298c0b457cb32b5 commit cfd8866818abb68fbfbffb925298c0b457cb32b5 Author: Warner Losh AuthorDate: 2025-01-06 23:45:51 +0000 Commit: Warner Losh CommitDate: 2025-01-06 23:46:06 +0000 cdefs.h: Add warning about defining __BSD_VISIBLE and friends Undefined things happen if users define these macros, be more explicit about documenting that. Sponsored by: Netflix --- share/man/man9/cdefs.9 | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/share/man/man9/cdefs.9 b/share/man/man9/cdefs.9 index 2e6f1b440efb..4efce132d393 100644 --- a/share/man/man9/cdefs.9 +++ b/share/man/man9/cdefs.9 @@ -401,7 +401,8 @@ are also included. These macros are set by .Nm to control the visibility of different standards. -Users should not use these, but they are documented here for developers. +Users must not define these, and doing so will produced undefined results. +They are documented here for developers working on system's header files. .Bl -column "---------------" .It Dv __XSI_VISIBLE Ta Restricts the visibility of XOPEN Single Unix Standard version. Possible values are 500, 600, 700 or 800, corresponding to Issue 5, 6, 7, or 8