From patchwork Fri Oct 20 21:41:16 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stephen Hemminger X-Patchwork-Id: 133115 X-Patchwork-Delegate: david.marchand@redhat.com 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 E03FE431BE; Fri, 20 Oct 2023 23:42:57 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 98D4742E16; Fri, 20 Oct 2023 23:41:49 +0200 (CEST) Received: from mail-pf1-f178.google.com (mail-pf1-f178.google.com [209.85.210.178]) by mails.dpdk.org (Postfix) with ESMTP id 83EE2427E4 for ; Fri, 20 Oct 2023 23:41:42 +0200 (CEST) Received: by mail-pf1-f178.google.com with SMTP id d2e1a72fcca58-6b77ab73c6fso1026720b3a.1 for ; Fri, 20 Oct 2023 14:41:42 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=networkplumber-org.20230601.gappssmtp.com; s=20230601; t=1697838101; x=1698442901; 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=f1Q49a5mYI0KVC99ifZ+45FtBz2av18ZQ7+jKyK2slg=; b=qPm9W+Z6fiOP1JDCKi+KT6TGUYcGY0Pz/i8+hil1rcQ4JBml8azrz2CbWeocvvasX0 O9DkzoKWRJREa97IxIqZ82ALcIoLazfHzk7b5jQ6oLOp6zsCgDuME4Z6I9SG1d7A/0Qe /3vIWFbeQMd4PYq8CNGH1ifU5O8KF6i4HztNTCglFwRErUADIrFEWmqT+ybDB0qVkvy0 wpxbWOMZXClslwig/VS6uyY9TvNosqsiqUryMqim/6jD35/cXk3Tgka5T9ifMlSVec21 6mVJCdhrgeKgoiGv8henzv2OwR+bj1qQKoS+lrY71CkWVu7T2SmSrsHW+IBf+IMqHYc8 7UVQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1697838101; x=1698442901; 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=f1Q49a5mYI0KVC99ifZ+45FtBz2av18ZQ7+jKyK2slg=; b=LshvVQtKQl3LEu6h8m0oiIWoyFp32bNu+xUY33DOGyJQdF6P1I7+PHeWEWJV9QsXe7 QCraokliF2xRfvw6hotr4fQRTdptMupXbG+dMpsTZjT4PQ4/5WUm0nic8BgYIDNYBh2n tfBlq0tvQkI/bTS9SAv50BhChg2GYqIxSgKao2QIGHYiMYS4d06i0fh79NFOw7cC9aN/ Sz4KlL1fxXfcBTFyJ7s6KEI5EyHp70+PvuUAt6m3/fR04VtYftqYxHfYW5rcKU5W3Xqh tmzAnoOIorWuH2nwurx6QC9uc5Y549/78yOw06753kf/ejCXqTsmDASqRSFf5veAq/2P E9vA== X-Gm-Message-State: AOJu0YwZyhlJJiAT+t/nI1JM0xzuCswaDYlQ3gnN6RLbF6A8acinUhR3 D82SI2grNf5WDJzO0+VK/SDIc/K9zWa8Ac0qwRJctQ== X-Google-Smtp-Source: AGHT+IFHjBxoClZ0mqlFAru7bLhvPpInZVvqgs46QOxZOkOeQYkEZq06A7vtf6T/GGDTSB1c50wMQg== X-Received: by 2002:a05:6a00:1817:b0:68e:3616:604a with SMTP id y23-20020a056a00181700b0068e3616604amr4667889pfa.8.1697838101496; Fri, 20 Oct 2023 14:41:41 -0700 (PDT) Received: from hermes.local (204-195-126-68.wavecable.com. [204.195.126.68]) by smtp.gmail.com with ESMTPSA id 19-20020a631753000000b005894450b404sm1886543pgx.63.2023.10.20.14.41.40 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 20 Oct 2023 14:41:40 -0700 (PDT) From: Stephen Hemminger To: dev@dpdk.org Cc: Stephen Hemminger Subject: [PATCH v2 11/14] eal: mark rte_power API's stable Date: Fri, 20 Oct 2023 14:41:16 -0700 Message-Id: <20231020214119.255491-12-stephen@networkplumber.org> X-Mailer: git-send-email 2.39.2 In-Reply-To: <20231020214119.255491-1-stephen@networkplumber.org> References: <20230809164312.308093-1-stephen@networkplumber.org> <20231020214119.255491-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 were added back in 2020. Signed-off-by: Stephen Hemminger --- lib/eal/include/generic/rte_power_intrinsics.h | 16 ---------------- lib/eal/version.map | 12 ++++-------- 2 files changed, 4 insertions(+), 24 deletions(-) diff --git a/lib/eal/include/generic/rte_power_intrinsics.h b/lib/eal/include/generic/rte_power_intrinsics.h index f981df7d75a1..922c32c83fdb 100644 --- a/lib/eal/include/generic/rte_power_intrinsics.h +++ b/lib/eal/include/generic/rte_power_intrinsics.h @@ -54,9 +54,6 @@ struct rte_power_monitor_cond { }; /** - * @warning - * @b EXPERIMENTAL: this API may change without prior notice. - * * Monitor specific address for changes. This will cause the CPU to enter an * architecture-defined optimized power state until either the specified * memory address is written to, a certain TSC timestamp is reached, or other @@ -84,14 +81,10 @@ struct rte_power_monitor_cond { * -EINVAL on invalid parameters * -ENOTSUP if unsupported */ -__rte_experimental int rte_power_monitor(const struct rte_power_monitor_cond *pmc, const uint64_t tsc_timestamp); /** - * @warning - * @b EXPERIMENTAL: this API may change without prior notice. - * * Wake up a specific lcore that is in a power optimized state and is monitoring * an address. * @@ -104,13 +97,9 @@ int rte_power_monitor(const struct rte_power_monitor_cond *pmc, * @param lcore_id * Lcore ID of a sleeping thread. */ -__rte_experimental int rte_power_monitor_wakeup(const unsigned int lcore_id); /** - * @warning - * @b EXPERIMENTAL: this API may change without prior notice. - * * Enter an architecture-defined optimized power state until a certain TSC * timestamp is reached. * @@ -126,13 +115,9 @@ int rte_power_monitor_wakeup(const unsigned int lcore_id); * -EINVAL on invalid parameters * -ENOTSUP if unsupported */ -__rte_experimental int rte_power_pause(const uint64_t tsc_timestamp); /** - * @warning - * @b EXPERIMENTAL: this API may change without prior notice - * * Monitor a set of addresses for changes. This will cause the CPU to enter an * architecture-defined optimized power state until either one of the specified * memory addresses is written to, a certain TSC timestamp is reached, or other @@ -160,7 +145,6 @@ int rte_power_pause(const uint64_t tsc_timestamp); * -EINVAL on invalid parameters * -ENOTSUP if unsupported */ -__rte_experimental int rte_power_monitor_multi(const struct rte_power_monitor_cond pmc[], const uint32_t num, const uint64_t tsc_timestamp); diff --git a/lib/eal/version.map b/lib/eal/version.map index 0dbd8b0573dd..3d4f6b5f79e6 100644 --- a/lib/eal/version.map +++ b/lib/eal/version.map @@ -233,6 +233,10 @@ DPDK_24 { rte_mp_request_async; rte_mp_request_sync; rte_mp_sendmsg; + rte_power_monitor; # WINDOWS_NO_EXPORT + rte_power_monitor_wakeup; # WINDOWS_NO_EXPORT + rte_power_pause; # WINDOWS_NO_EXPORT + rte_power_monitor_multi; # WINDOWS_NO_EXPORT rte_rand; rte_rand_max; rte_realloc; @@ -378,11 +382,6 @@ EXPERIMENTAL { rte_vect_get_max_simd_bitwidth; rte_vect_set_max_simd_bitwidth; - # added in 21.02 - rte_power_monitor; # WINDOWS_NO_EXPORT - rte_power_monitor_wakeup; # WINDOWS_NO_EXPORT - rte_power_pause; # WINDOWS_NO_EXPORT - # added in 21.05 rte_version_minor; rte_version_month; @@ -391,9 +390,6 @@ EXPERIMENTAL { rte_version_suffix; rte_version_year; - # added in 21.08 - rte_power_monitor_multi; # WINDOWS_NO_EXPORT - # added in 21.11 # added in 23.03