From nobody Tue Jul 18 07:59:00 2023 X-Original-To: dev-commits-src-all@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 4R4rtr5gGmz4nrFk; Tue, 18 Jul 2023 07:59:00 +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 4R4rtr5BGGz4GVq; Tue, 18 Jul 2023 07:59:00 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1689667140; 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=DTB1jF7Qt1rXn/jvvtzVErHIvQ0IVbcLLoBgWQu47Gk=; b=VBQnCqkfg4t9Kv6cE3B5dFfPzqjVUVKxJe4nOAKUY4ucn8qUukYHyetubXjIbkj4WCsr2x xHfbaELm9MoRcYTlEK9xUB8CpBqJbL1aHAyIy4IBqb7hMx4XqpLblajLcKKzUCYP32KCyo 6m+UjU3713GoZ18vvIIFCT/JtO03oiQk36HuW7D+bQ92IpdQUBpTCCmPy31MZh+IpHqTb9 nQkluM7c++aMob0p/kPcqYy0HVWolQ2UvhTYMulLeGbDvz79vU3oJ3nMxUqDpY1bjqL2Ob iEQUg+Cf9EXp2VpX/lpXeYWTP0d8eYoCSnmEab2gpkOkU6oSCgmg3JQ6FJ0bKA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1689667140; 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=DTB1jF7Qt1rXn/jvvtzVErHIvQ0IVbcLLoBgWQu47Gk=; b=M9P8pfemlYdGixzZ4P2SZuvHfKCGSKO828o/PFBbETk1szZSeJPycnMkbWildlTMjdOBgo yPGMggS/hGlb1Vy91D9I4CnFWKlnRE8JFuupX+tU/EzQBtQhIGfLzOqRdtOA/jD/zPs1Zd 3ryYTEeYCinwdD1d7PXWRKSM3vNgMqNokRlMzZnqKRbVX3immLsxssOioE6EIqWIL1GUwK AJJtMZLUjJ/wQXq0qt5LnHcCuYJGZGnUrVyLnZTyi8Zgzk4YNnDZ0qhWpFyAZj9lXqUiL3 SHUFSfQXkSVWF7NUnEq+tSxb/NC4FfYcpEO3BJnciYN1F8PFy4Vb6wkgR9fnWQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1689667140; a=rsa-sha256; cv=none; b=j2zb+PIOhz4MkrG54Xq0pLAUuy/GwVpFns/6XnKyUy5BGxyUNYzzt/0r5Dy8v5so9fjhYa JCbD4DYgrp+0IpQGV+fJKNWgeJfbxV99uSQO80UhjbDEooB2W71lWpJQbRCxSiX5q/vnJk MefqacDhF7vohwXQnkAJjz0A1hL3Ti8pZ4Z/oCbZjTbsjqMrS7O0n1P3kS4i8duRbT8bVx xDRUND5zU3zrB+AxaBzgC2w7+4w8wv7g1ccN0nJNQ1EXSC3MIln6ifZ3Y4bd+jNmHkdzvE uVm/tXiY0mMj3CyW/nxAhBCvkTZTElJWGl1hyobLN471gtx1ZHvFbsgH8hE/cQ== 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 4R4rtr4HwNzxLJ; Tue, 18 Jul 2023 07:59:00 +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 36I7x0vo087170; Tue, 18 Jul 2023 07:59:00 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.17.1/8.17.1/Submit) id 36I7x0jF087169; Tue, 18 Jul 2023 07:59:00 GMT (envelope-from git) Date: Tue, 18 Jul 2023 07:59:00 GMT Message-Id: <202307180759.36I7x0jF087169@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org From: Eugene Grosbein Subject: git: c9d956e36438 - stable/13 - syslog.3: MFC: document ident[N] format List-Id: Commit messages for all branches of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-src-all@freebsd.org X-BeenThere: dev-commits-src-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: eugen X-Git-Repository: src X-Git-Refname: refs/heads/stable/13 X-Git-Reftype: branch X-Git-Commit: c9d956e36438460fc912cde33576db810c7122bd Auto-Submitted: auto-generated The branch stable/13 has been updated by eugen: URL: https://cgit.FreeBSD.org/src/commit/?id=c9d956e36438460fc912cde33576db810c7122bd commit c9d956e36438460fc912cde33576db810c7122bd Author: Eugene Grosbein AuthorDate: 2023-07-03 12:35:37 +0000 Commit: Eugene Grosbein CommitDate: 2023-07-18 07:57:54 +0000 syslog.3: MFC: document ident[N] format When libc switched to generation of logs as per RFC 5424, that change broke application ability to insert specific process id using ident[N] format, the feature existed for decades. Some processes rely on it (including logger and syslogd). Later the regression was fixed but the feature remained undocumented. This change documents it. (cherry picked from commit 5aee3e14d4914c7c99bce80da17b3100cb1f4490) --- lib/libc/gen/syslog.3 | 7 ++++++- usr.bin/logger/logger.1 | 9 ++++++++- 2 files changed, 14 insertions(+), 2 deletions(-) diff --git a/lib/libc/gen/syslog.3 b/lib/libc/gen/syslog.3 index 2cb2c0d198b3..73e62997e828 100644 --- a/lib/libc/gen/syslog.3 +++ b/lib/libc/gen/syslog.3 @@ -28,7 +28,7 @@ .\" @(#)syslog.3 8.1 (Berkeley) 6/4/93 .\" $FreeBSD$ .\" -.Dd November 25, 2018 +.Dd July 3, 2023 .Dt SYSLOG 3 .Os .Sh NAME @@ -131,6 +131,11 @@ The .Fa ident argument is a string that will be prepended to every message. +It may be formatted as +.Fa ident[N] +in which case decimal number +.Fa N +replaces the process id within messages. The .Fa logopt argument diff --git a/usr.bin/logger/logger.1 b/usr.bin/logger/logger.1 index 7a64320cfe49..a2774b9e3500 100644 --- a/usr.bin/logger/logger.1 +++ b/usr.bin/logger/logger.1 @@ -28,7 +28,7 @@ .\" @(#)logger.1 8.1 (Berkeley) 6/6/93 .\" $FreeBSD$ .\" -.Dd December 5, 2017 +.Dd July 3, 2023 .Dt LOGGER 1 .Os .Sh NAME @@ -73,6 +73,9 @@ tries to send the message to all addresses. .It Fl i Log the process id of the logger process with each line. +This flag is ignored and the process id is always logged. +See also +.Fl t . .It Fl s Log the message to standard error, as well as the system log. .It Fl f Ar file @@ -152,6 +155,10 @@ and Mark every line in the log with the specified .Ar tag rather than the default of current login name. +Use +.Fl t Ar tag[N] +to insert specific decimal process id instead of id of +.Nm . .It Ar message Write the message to log; if not specified, and the .Fl f