From patchwork Tue Feb 7 23:04:22 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stephen Hemminger X-Patchwork-Id: 123387 X-Patchwork-Delegate: thomas@monjalon.net Return-Path: X-Original-To: patchwork@inbox.dpdk.org Delivered-To: patchwork@inbox.dpdk.org Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id 35B3A41C34; Wed, 8 Feb 2023 00:04:51 +0100 (CET) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id BE07B42670; Wed, 8 Feb 2023 00:04:46 +0100 (CET) Received: from mail-pj1-f45.google.com (mail-pj1-f45.google.com [209.85.216.45]) by mails.dpdk.org (Postfix) with ESMTP id 7931B40DDB for ; Wed, 8 Feb 2023 00:04:43 +0100 (CET) Received: by mail-pj1-f45.google.com with SMTP id pj3so16585283pjb.1 for ; Tue, 07 Feb 2023 15:04:43 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=networkplumber-org.20210112.gappssmtp.com; s=20210112; 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=yqxpGzyhnbg0vLuxvbJa55A/oxbok2U1f3+mHeGfhNc=; b=Byf0F6MSZTcyUrXFrwAsBh48ArMHaX3W+zJCVTDeq+sW2M4coOEU7bPITi7H1fOqdW AfH1jW23A5HZUVp1qwYi1jqypz+KuPbxbngjZKOdsfMlqjeXIeC7jou3t30ibivr2Wfe EG1iWIgaxKd6o0tmN6SCMV4QlCwEjjA6YXk9bNu7X770SIbbeMmFpm1ZGIssJbzbTDct kXwKcvU89eW6NBoHzETrIOmO0fCXk5V5UW1QoAAMZkq3MiaKXK9BWYD5iycoM/6zOr8E CaE4kmjm0XM7leJM+iv9mlLUsD6P4asM0nKcd1XtQUCIsEYTZFoOVETw1Tp14GuWDQMy F/cg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; 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=yqxpGzyhnbg0vLuxvbJa55A/oxbok2U1f3+mHeGfhNc=; b=6v/O9hIxQOeRrg1Ejg2rO2ie7HovHAQ7q5bdMGVlMRdyXpcNcflKQeP+izlHEESYnM +cBSdgqAbNhcSPAiBEw334UGFeTv15mrMGyw+igZgNDkynf/1iy9QYQUThTOqe94uxRs 2BeV7eRb/DrJoxx1zwa71+68hlajY1CdtZ/2N+m6J/XQ8c4x/wy8OX5gmqKiptpX4TLw DQDjCwDMr8rtKynxRIb//H6ysRdC+zYJRXjjHHh8e0KDG/n/aOlf/t1ROmupZtjxtTNg Af26u5wH/erzKYU1drU0DcdIPISNYRRS3gtffKSO52ibuMckQyrq/GpR/0c0TRsr8gGk 2kJA== X-Gm-Message-State: AO0yUKVyIucZCZQAyNyC+rLizMZ/2H2NGozikK7UKkZuGd2q8yXrpt9Q qqD2jKTJDAXMNYjKTv5+eRSchftc5r9C4YYaG8w= X-Google-Smtp-Source: AK7set+Zzs4gEVrZ2g0kptqcSbMT8n+TEFJ+h0HzjQG6yDYpAq7co2OF17ct48li2kPIB5XM4ULd9Q== X-Received: by 2002:a05:6a20:ba4:b0:c2:f930:45e8 with SMTP id i36-20020a056a200ba400b000c2f93045e8mr873744pzh.46.1675811082344; Tue, 07 Feb 2023 15:04:42 -0800 (PST) Received: from hermes.local (204-195-120-218.wavecable.com. [204.195.120.218]) by smtp.gmail.com with ESMTPSA id gq17-20020a17090b105100b0020dc318a43esm71189pjb.25.2023.02.07.15.04.41 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 07 Feb 2023 15:04:41 -0800 (PST) From: Stephen Hemminger To: dev@dpdk.org Cc: Stephen Hemminger Subject: [RFC v2 01/17] doc: document intention to deprecate RTE_LOGTYPE_USER* Date: Tue, 7 Feb 2023 15:04:22 -0800 Message-Id: <20230207230438.1617331-2-stephen@networkplumber.org> X-Mailer: git-send-email 2.39.1 In-Reply-To: <20230207230438.1617331-1-stephen@networkplumber.org> References: <20230207204151.1503491-1-stephen@networkplumber.org> <20230207230438.1617331-1-stephen@networkplumber.org> MIME-Version: 1.0 X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org These static log types should be deprecated in next stable release. Also, remove use of USER1 from example of doing mlockall. Signed-off-by: Stephen Hemminger --- doc/guides/prog_guide/writing_efficient_code.rst | 3 +-- doc/guides/rel_notes/deprecation.rst | 4 ++++ 2 files changed, 5 insertions(+), 2 deletions(-) diff --git a/doc/guides/prog_guide/writing_efficient_code.rst b/doc/guides/prog_guide/writing_efficient_code.rst index e6c26efdd3a3..250e06bd734f 100644 --- a/doc/guides/prog_guide/writing_efficient_code.rst +++ b/doc/guides/prog_guide/writing_efficient_code.rst @@ -89,8 +89,7 @@ To avoid these you could pre-load, and lock them into memory with the ``mlockall .. code-block:: c if (mlockall(MCL_CURRENT | MCL_FUTURE)) { - RTE_LOG(NOTICE, USER1, "mlockall() failed with error \"%s\"\n", - strerror(errno)); + perror("mlockall"); } Communication Between lcores diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst index ac9aa7630b61..935e68134d0e 100644 --- a/doc/guides/rel_notes/deprecation.rst +++ b/doc/guides/rel_notes/deprecation.rst @@ -136,3 +136,7 @@ Deprecation Notices Its removal has been postponed to let potential users report interest in maintaining it. In the absence of such interest, this library will be removed in DPDK 23.11. + +* rte_log: The pre-defined RTE_LOGTYPE_USER* macros are planned to be + deprecated starting with the 23.07 release. Applications should use the + dynamic log types available with RTE_LOG_REGISTER instead.