From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <dev-bounces@dpdk.org>
Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124])
	by inbox.dpdk.org (Postfix) with ESMTP id 377F6459D7;
	Thu, 19 Sep 2024 17:08:28 +0200 (CEST)
Received: from mails.dpdk.org (localhost [127.0.0.1])
	by mails.dpdk.org (Postfix) with ESMTP id 408DC433C6;
	Thu, 19 Sep 2024 17:06:39 +0200 (CEST)
Received: from mail-pf1-f172.google.com (mail-pf1-f172.google.com
 [209.85.210.172])
 by mails.dpdk.org (Postfix) with ESMTP id DAF1F433AA
 for <dev@dpdk.org>; Thu, 19 Sep 2024 17:06:32 +0200 (CEST)
Received: by mail-pf1-f172.google.com with SMTP id
 d2e1a72fcca58-71970655611so857560b3a.0
 for <dev@dpdk.org>; Thu, 19 Sep 2024 08:06:32 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
 d=networkplumber-org.20230601.gappssmtp.com; s=20230601; t=1726758392;
 x=1727363192; darn=dpdk.org; 
 h=content-transfer-encoding:mime-version:references:in-reply-to
 :message-id:date:subject:cc:to:from:from:to:cc:subject:date
 :message-id:reply-to;
 bh=eXb26X7jxB/SNGPRhZgiOkGKBh+kkWqNz3DeeBMolMA=;
 b=Lr8AkBdxq/1qeoH1ABz6yfDUIIkdhc5LgjRpH9AXMVmUCBlvZbIz8fcuqtr9wqe8qr
 uB/FvOtxDqG1Gj11GZpoKJjNcpAC7UX7e5BcXUJZzE/8XQ7Sjxnik6FPXnnQa26UNWFT
 CO8SQRwYcqssBGH27CA4sEG3iIFG0gnziD0umK3eZF4MmwBdcaER2eF4JSLclF3x8rvq
 BqoGb1AW/76JI98rGJ78XiIEcEmQfrM1/Uvgbfzeig7qv0hz8iAcQzQXf4JRPUfQpi+9
 Ii4Adv6S9FX1vq9KU4DkdHzvuFTx9sZ1rDDrczbJUG9uukTzVNpDzaWYtMT8ezkc12Eo
 Ad6w==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
 d=1e100.net; s=20230601; t=1726758392; x=1727363192;
 h=content-transfer-encoding:mime-version:references:in-reply-to
 :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc
 :subject:date:message-id:reply-to;
 bh=eXb26X7jxB/SNGPRhZgiOkGKBh+kkWqNz3DeeBMolMA=;
 b=gILUMB2Fe80Oa0wvG3h5el6VRq9tve6L4w48CnvEBqIdZFNNhgSbmfVGf/AH1YKfbC
 vMOFXH+5jVC5axo0Drjg5DpvMalSTgpuLcfN8BYhr6gJQLdCgZtKcyAt0QVHAsyQwhtA
 ssKgJJhDUpELEm3Od6tI1PtXv5fKj4lbT+frhAkHt1vPTOvfILz4NeLo2ED3Wy/ooNV6
 YsXLvCmHWU4VccV4rKhctnax54trRJOTEo4Kktqd1KJrviSJpglUupn2ApG/x9+3re7N
 /LZz49HOvCfmCq1ubtCq03Ew51pF1/Xf6ceZZcotFedL6+fddmM84616ha+ObD1PXEMi
 3w7Q==
X-Gm-Message-State: AOJu0YyqeqiyQBIg97WnqboLYA0MOT1fm3fimwy85qCZUA41mfwQuUsf
 csEiH7XDqQQrOpSm9a+gn+Je7oCNzbK9vSrd0JV6X+T4o0p1t0Fk/iORLc9daIQOqUilUvKCigF
 D
X-Google-Smtp-Source: AGHT+IEMWb/K/eBNR97Yw/x64E2OiuTf6GnvB73mZSw3X9gU/6X3MYNV4hRerf/4Kh/OPGoUWnVGEw==
X-Received: by 2002:a05:6a00:3e29:b0:70d:2b95:d9c0 with SMTP id
 d2e1a72fcca58-71926090ecdmr40615621b3a.14.1726758391812; 
 Thu, 19 Sep 2024 08:06:31 -0700 (PDT)
Received: from hermes.local (204-195-96-226.wavecable.com. [204.195.96.226])
 by smtp.gmail.com with ESMTPSA id
 d2e1a72fcca58-71944adfd3dsm8620841b3a.92.2024.09.19.08.06.31
 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);
 Thu, 19 Sep 2024 08:06:31 -0700 (PDT)
From: Stephen Hemminger <stephen@networkplumber.org>
To: dev@dpdk.org
Cc: Stephen Hemminger <stephen@networkplumber.org>,
 =?UTF-8?q?Morten=20Br=C3=B8rup?= <mb@smartsharesystems.com>,
 Bruce Richardson <bruce.richardson@intel.com>,
 Chengwen Feng <fengchengwen@huawei.com>
Subject: [PATCH v25 15/15] doc: add release note about log library
Date: Thu, 19 Sep 2024 08:04:21 -0700
Message-ID: <20240919150609.5281-16-stephen@networkplumber.org>
X-Mailer: git-send-email 2.45.2
In-Reply-To: <20240919150609.5281-1-stephen@networkplumber.org>
References: <20200814173441.23086-1-stephen@networkplumber.org>
 <20240919150609.5281-1-stephen@networkplumber.org>
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
X-BeenThere: dev@dpdk.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: DPDK patches and discussions <dev.dpdk.org>
List-Unsubscribe: <https://mails.dpdk.org/options/dev>,
 <mailto:dev-request@dpdk.org?subject=unsubscribe>
List-Archive: <http://mails.dpdk.org/archives/dev/>
List-Post: <mailto:dev@dpdk.org>
List-Help: <mailto:dev-request@dpdk.org?subject=help>
List-Subscribe: <https://mails.dpdk.org/listinfo/dev>,
 <mailto:dev-request@dpdk.org?subject=subscribe>
Errors-To: dev-bounces@dpdk.org

Significant enough to add some documentation.

Signed-off-by: Stephen Hemminger <stephen@networkplumber.org>
Acked-by: Morten Brørup <mb@smartsharesystems.com>
Acked-by: Bruce Richardson <bruce.richardson@intel.com>
Acked-by: Chengwen Feng <fengchengwen@huawei.com>
---
 doc/guides/rel_notes/release_24_11.rst | 27 ++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/doc/guides/rel_notes/release_24_11.rst b/doc/guides/rel_notes/release_24_11.rst
index 0ff70d9057..d6fb6c137b 100644
--- a/doc/guides/rel_notes/release_24_11.rst
+++ b/doc/guides/rel_notes/release_24_11.rst
@@ -55,6 +55,33 @@ New Features
      Also, make sure to start the actual text at the margin.
      =======================================================
 
+* **Enhancements to logging library.**
+
+  * Syslog related changes
+
+    * The meaning of the *--syslog* option has changed.
+      Use of syslog is controlled by the *--syslog* option.
+      The default is now *auto* which uses syslog only if stderr
+      is not a terminal device.
+
+    * The syslog facility is now set to **LOG_USER** if stderr is a terminal
+      and **LOG_DAEMON** otherwise.
+
+    * Syslog is now supported on FreeBSD (but not on Windows).
+
+  * The log is initialized earlier in startup so all messages go through
+    the library.
+
+  * Added a new option to timestamp log messages, which is useful for
+    debugging delays in application and driver startup.
+
+  * Log messages are now in color if going to a terminal (similar to dmesg).
+    The default format shows timestamp in green, subsystem in yellow,
+    and the message is bold, boldface or normal depending on severity.
+
+  * If the application is a systemd service and the log output is being
+    sent of standard error then DPDK will switch to journal native protocol.
+
 
 Removed Items
 -------------
-- 
2.45.2