From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id AE5CE459FA; Sat, 28 Sep 2024 00:16:12 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 50F6140BA4; Sat, 28 Sep 2024 00:13:55 +0200 (CEST) Received: from mail-wr1-f52.google.com (mail-wr1-f52.google.com [209.85.221.52]) by mails.dpdk.org (Postfix) with ESMTP id 05EC74025D for ; Fri, 27 Sep 2024 18:09:04 +0200 (CEST) Received: by mail-wr1-f52.google.com with SMTP id ffacd0b85a97d-37cd5016d98so1003506f8f.1 for ; Fri, 27 Sep 2024 09:09:04 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=pantheon.tech; s=google; t=1727453343; x=1728058143; 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=BTxLDbHbdrm5IfgO6I5GrfuybUYKSDQivK8QvKtm9x0=; b=cHj1Ru4e9tGZXyFzUjv6ma34o4RU0qqEioOpnp1o0eyYzGp98KKiMDh+AYnLM5GFYu PWHJC+8ppTNfTGfuUKqQ2tKLdaGh81ImXBrJVtl9z79wWCZ3GPTS0kArsZ92Q9cbL+Gs k6CQH7v75hNu6BgV8SsScbmR0hKSUqhYIgqSyqB/cmuXh/JixkPK/752Eyu5quer0I5g hGx15l/L/JfOtQehNJvzuHqmLvECTdeVN8qZ+M5of0CYkxnCbtaibm5n/dUwKjwI7feG EcTXvpgL5Xs7khKKovZTgt5HwmoXhuijVY6dfADkeIbZD/x+FGeaUFCOPNMh7ZDVw3Av wg1Q== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1727453343; x=1728058143; 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=BTxLDbHbdrm5IfgO6I5GrfuybUYKSDQivK8QvKtm9x0=; b=OOZ4bbdq6UDsgMyeBgjEiForiibQZfr7d6fyviHl53u/W32sI2QsAC2ovgCj402vXc Pcj6tKJWJCeN3MVbzvDU45hZWkbR+v8zlnNc5YlLvYwQwfUpgi0BX0fF2QJUKcibGVG3 5HYhlIhEVpFXsji0F90YKizfXT8J1EVOKaKUZmdxBYbS/rhA697HhCR2A105P3xqtBnX FXwJd/uKZ3dpQDSVtCWZB9EIjWTe18AGHGx37CPddifRqS/UjOyNHkeS4ajOlZwWv0pO jIPTxsDZlZbEncD8xKdaN30MW2B87SxhI18305KO+w0fTfVWYyiSfTj9TI/gKf9JARbT aRHA== X-Gm-Message-State: AOJu0Yzj63Zf3D9wniqJy4y0aX5/a0/pveYuK6JvLkDBQBdvQJL3wufj X1gQK0+HRBehBZysFPLKB2wTfmkxP1V0OW+IjTLWgXl4Uys/XAXRazu89MZXeOfLOmvDNlcl9XR 98M0= X-Google-Smtp-Source: AGHT+IH6G5WI/3Q3lj85KvllRbaTLdTKEBaoD0U3vuDU8eW0rar8NxDzs4s0uONOfr36CySLQT77og== X-Received: by 2002:a05:6000:d8f:b0:37c:ced2:843b with SMTP id ffacd0b85a97d-37cd5ab75fcmr2868720f8f.20.1727453342898; Fri, 27 Sep 2024 09:09:02 -0700 (PDT) Received: from fedora.. ([185.242.191.25]) by smtp.gmail.com with ESMTPSA id ffacd0b85a97d-37cd564bf8bsm2943471f8f.20.2024.09.27.09.09.02 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 27 Sep 2024 09:09:02 -0700 (PDT) From: =?UTF-8?q?Tom=C3=A1=C5=A1=20=C4=8Eurovec?= To: dev@dpdk.org, Luca.Vizzarro@arm.com, probb@iol.unh.edu, npratte@iol.unh.edu, dmarx@iol.unh.edu Cc: =?UTF-8?q?Tom=C3=A1=C5=A1=20=C4=8Eurovec?= Subject: [PATCH 6/7] doc: update argument options for external DPDK build Date: Fri, 27 Sep 2024 18:08:53 +0200 Message-ID: <20240927160854.279253-7-tomas.durovec@pantheon.tech> X-Mailer: git-send-email 2.46.1 In-Reply-To: <20240927160854.279253-1-tomas.durovec@pantheon.tech> References: <20240927160854.279253-1-tomas.durovec@pantheon.tech> MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-Mailman-Approved-At: Sat, 28 Sep 2024 00:13:29 +0200 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 By adding support for external build, we extend the argument documentation for supported options. Signed-off-by: Tomáš Ďurovec --- doc/guides/tools/dts.rst | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/doc/guides/tools/dts.rst b/doc/guides/tools/dts.rst index 65cce9e5ed..20d4d18b18 100644 --- a/doc/guides/tools/dts.rst +++ b/doc/guides/tools/dts.rst @@ -236,12 +236,14 @@ DTS is run with ``main.py`` located in the ``dts`` directory after entering Poet -t SECONDS, --timeout SECONDS [DTS_TIMEOUT] The default timeout for all DTS operations except for compiling DPDK. (default: 15) -v, --verbose [DTS_VERBOSE] Specify to enable verbose output, logging all messages to the console. (default: False) - -s, --skip-setup [DTS_SKIP_SETUP] Specify to skip all setup steps on SUT and TG nodes. (default: False) + --dpdk-tree DIR_PATH [DTS_DPDK_TREE] Path to DPDK source code tree to test. (default: None) --tarball FILE_PATH, --snapshot FILE_PATH [DTS_DPDK_TARBALL] Path to DPDK source code tarball to test. (default: None) --revision ID, --rev ID, --git-ref ID [DTS_DPDK_REVISION_ID] Git revision ID to test. Could be commit, tag, tree ID etc. To test local changes, first commit them, then use their commit ID. (default: None) + --remote-source [DTS_REMOTE_SOURCE] Set when the DPDK source tree or tarball is located on the SUT node. (default: False) + --build-dir DIR_NAME [DTS_BUILD_DIR] A directory name, which would be located in the `dpdk tree` or `tarball`. (default: None) --compile-timeout SECONDS [DTS_COMPILE_TIMEOUT] The timeout for compiling DPDK. (default: 1200) --test-suite TEST_SUITE [TEST_CASES ...] @@ -257,8 +259,9 @@ DTS is run with ``main.py`` located in the ``dts`` directory after entering Poet The brackets contain the names of environment variables that set the same thing. -The minimum DTS needs is a config file and a DPDK tarball or git ref ID. -You may pass those to DTS using the command line arguments or use the default paths. +The minimum DTS needs is a config file and a pre-built DPDK or DPDK +sources location which can be specified in said config file or on the +command line or environment variables. Example command for running DTS with the template configuration and DPDK tag v23.11: -- 2.46.1