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 C23424301F for ; Thu, 10 Aug 2023 02:12:29 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id BC1B840DD8; Thu, 10 Aug 2023 02:12:29 +0200 (CEST) Received: from NAM04-DM6-obe.outbound.protection.outlook.com (mail-dm6nam04on2063.outbound.protection.outlook.com [40.107.102.63]) by mails.dpdk.org (Postfix) with ESMTP id E5694406B6 for ; Thu, 10 Aug 2023 02:12:28 +0200 (CEST) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=jLbihV0mKtT3FjMrI+6C5r8Bl9hxFiMtBCOVrilFbkwiU0nanT2M7/g+HOr1PtmPTZAHjRcGggRXxgkm0P84sVEQW+9FXRBTutjGihOwqhET/vFvO3q/aefY0jdcforxW0RJBPhk9ophdQtvdvzrb7HfX41KxZZAtEw/VwY8jy6W9JRm/mX0FQ3QgvUDgvr7WguFLk9u0IN78iSJJNRa8UFVsg2VqvNo8Dffn5HVUvOvGtp/lS47UDqSN38YR+6Ufcif8oX+z4J/vcUSy4GP/ja9L60K2ksopnPxy+g7PLnlFMosfS/wKTbOOZ4y4qXW5CpkeJy6FwzSTXqI2in5Fg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=F9bH0A+C/cefXib8a9dOB6JK+CchnU5GrKBaiHY3uz4=; b=TRHWEaaDpyfgg+E0xbKgKlo9x7p+v+r8c+ymwrYRXqX6Zp+Z21KC62rgoUaCOcmVMdoXmNwX3oyc/mmSCuZIfV/4eeoTZdndseLedIqn3j2EJUSbSS82wzVUGtOS9fcaRLk6FRI0WLh4nLHJ32bug0ppU5Kv+YwWdMp/Ixdf4ZdkT8wEILaVpJT1DKynI/QfxPkMf+ozpYxGODU7YTPeSMW3LUVY1JB9Nrv45JmcT1T+nyqjwnDUz3gS78i0KKhVGvLfjekIu2M/MhZFtWmr3qbWTM9r1l78pho6+k6ih+RiTe0ER8RWno4M4B/DgQVy9QVDajw6ASEek8QeR3R6ag== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 216.228.117.160) smtp.rcpttodomain=networkplumber.org smtp.mailfrom=nvidia.com; dmarc=pass (p=reject sp=reject pct=100) action=none header.from=nvidia.com; dkim=none (message not signed); arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=Nvidia.com; s=selector2; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=F9bH0A+C/cefXib8a9dOB6JK+CchnU5GrKBaiHY3uz4=; b=JKVEFdbSzMZya9HE/vjER6c2jYLbIPhrUEogtq+84iJA3NSVEmAPVqaSinvZbR9DQUp3fnB2inzgAKgdAr/LM51e9tLeSoLHHAveehlsjVt3NSgFybn/da29xXEvaYButE5MONJZ3pgC1n2dgretRQ90ElZGnzITmXpYBG2aE+LmWvr+WdTHCh9A3T2Q7wqGBLNBu9YrlrP7wrXqq30nh/YJiWKo0uhp0/6cgzf+Jq8D9ycLQAoj/YoWJ6YEhRqUpgIcpfdPEj8TkFxbS2L1HwLRwdgJnaXfuF9lbq0xPkUFtT/ij1QIk6NwFYEVHUy9PgaTzHeofikR0Av1bFZpdA== Received: from PH7PR17CA0045.namprd17.prod.outlook.com (2603:10b6:510:323::10) by PH0PR12MB8125.namprd12.prod.outlook.com (2603:10b6:510:293::6) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6652.30; Thu, 10 Aug 2023 00:12:27 +0000 Received: from SA2PEPF000015C9.namprd03.prod.outlook.com (2603:10b6:510:323:cafe::2c) by PH7PR17CA0045.outlook.office365.com (2603:10b6:510:323::10) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6652.28 via Frontend Transport; Thu, 10 Aug 2023 00:12:27 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 216.228.117.160) smtp.mailfrom=nvidia.com; dkim=none (message not signed) header.d=none;dmarc=pass action=none header.from=nvidia.com; Received-SPF: Pass (protection.outlook.com: domain of nvidia.com designates 216.228.117.160 as permitted sender) receiver=protection.outlook.com; client-ip=216.228.117.160; helo=mail.nvidia.com; pr=C Received: from mail.nvidia.com (216.228.117.160) by SA2PEPF000015C9.mail.protection.outlook.com (10.167.241.199) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6652.20 via Frontend Transport; Thu, 10 Aug 2023 00:12:26 +0000 Received: from rnnvmail201.nvidia.com (10.129.68.8) by mail.nvidia.com (10.129.200.66) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.5; Wed, 9 Aug 2023 17:12:14 -0700 Received: from nvidia.com (10.126.231.37) by rnnvmail201.nvidia.com (10.129.68.8) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.37; Wed, 9 Aug 2023 17:12:13 -0700 From: Xueming Li To: Stephen Hemminger CC: dpdk stable Subject: patch 'doc: fix description of runtime directories' has been queued to stable release 22.11.3 Date: Thu, 10 Aug 2023 08:10:37 +0800 Message-ID: <20230810001045.2662-17-xuemingl@nvidia.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20230810001045.2662-1-xuemingl@nvidia.com> References: <20230625063544.11183-1-xuemingl@nvidia.com> <20230810001045.2662-1-xuemingl@nvidia.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Content-Type: text/plain X-Originating-IP: [10.126.231.37] X-ClientProxiedBy: rnnvmail202.nvidia.com (10.129.68.7) To rnnvmail201.nvidia.com (10.129.68.8) X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: SA2PEPF000015C9:EE_|PH0PR12MB8125:EE_ X-MS-Office365-Filtering-Correlation-Id: 601ef06a-c3ea-40c5-8d5d-08db99367ad7 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: 3GT0p7EuUizTSnEIrancsa1SyWmHKhyYvjGmLT/5FNp+b0w3Ng6LjghvXwTK5pMO91gr4j7GMR3DKYOGYA22jDim9/p1VYfKsue5StkOTsyGNrakhIwbCmDfPMfB8+w6CP2DpjkRCAtTk19k30wSomSpJNQYTjdME+vuYtzFb3+dHjHKRE+Ih6rclS87ePJkLzPmAQtgCKMvTMcItHXysgAacLIYt7kmwRrzEeC7HfJxQ8bovSo+7XgNqUIbkA0K9SH52qggaGJORaJmGRJQpbu7E1usWpB02p4VMqfhbabLFjuWlaA1QA+bthCzxekGwHJpoLhtAQey7xIaFf9MpeHDvbdkN0+ld6LDHzuX2vfd9W9miA2540d+gBUoojxQoRCx+Bfp4piQpI+ikWGV+klK0mC3S372iW48AZVdzXDxEQXOi2dvkzaiBYzXZfaxi7QlGCtqvQgVBjyMEXQ8L/pOaLpLEQ19iU5xa9fn2v8PRUQhv4nmC9RySNdaWJvdV4cFfpzSh5mdDTjfKizjEq4Vux33HsfDOcXLI7y/bsLTMTOUAycB05Bl++2vrjomFJ6BtJ0cBdnT48CFaM4JzqfUuv5fucg/hvyOYR/J6qK7bdZTgVHMwuIplJ9tSOVGW9ms8o8eWBd1LfMksY5epZUZjPt9n2KthWnuTcAauHokjFmcJ7tVOIU2wPKF0QuYM4Q4aESSF5IwYYig6j0N0jsLln3Cof27b0Q1oys6l7eSk7HpCZk0FTp5sCii8HWrj7aX+xI6BzGw9TFD88ZCvA== X-Forefront-Antispam-Report: CIP:216.228.117.160; CTRY:US; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:mail.nvidia.com; PTR:dc6edge1.nvidia.com; CAT:NONE; SFS:(13230028)(4636009)(376002)(396003)(39860400002)(136003)(346002)(1800799006)(186006)(82310400008)(451199021)(36840700001)(40470700004)(46966006)(7696005)(2616005)(966005)(336012)(2906002)(86362001)(16526019)(6286002)(41300700001)(1076003)(26005)(6666004)(426003)(53546011)(478600001)(83380400001)(47076005)(40460700003)(70206006)(70586007)(7636003)(55016003)(40480700001)(8676002)(8936002)(36860700001)(4326008)(82740400003)(6916009)(316002)(356005)(36756003)(5660300002); DIR:OUT; SFP:1101; X-OriginatorOrg: Nvidia.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 10 Aug 2023 00:12:26.9881 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 601ef06a-c3ea-40c5-8d5d-08db99367ad7 X-MS-Exchange-CrossTenant-Id: 43083d15-7273-40c1-b7db-39efd9ccc17a X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=43083d15-7273-40c1-b7db-39efd9ccc17a; Ip=[216.228.117.160]; Helo=[mail.nvidia.com] X-MS-Exchange-CrossTenant-AuthSource: SA2PEPF000015C9.namprd03.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: PH0PR12MB8125 X-BeenThere: stable@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: patches for DPDK stable branches List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: stable-bounces@dpdk.org Hi, FYI, your patch has been queued to stable release 22.11.3 Note it hasn't been pushed to http://dpdk.org/browse/dpdk-stable yet. It will be pushed if I get no objections before 08/11/23. So please shout if anyone has objections. Also note that after the patch there's a diff of the upstream commit vs the patch applied to the branch. This will indicate if there was any rebasing needed to apply to the stable branch. If there were code changes for rebasing (ie: not only metadata diffs), please double check that the rebase was correctly done. Queued patches are on a temporary branch at: https://git.dpdk.org/dpdk-stable/log/?h=22.11-staging This queued commit can be viewed at: https://git.dpdk.org/dpdk-stable/commit/?h=22.11-staging&id=eba2c364844c6c434045ead9c1e7e46446556a1f Thanks. Xueming Li --- >From eba2c364844c6c434045ead9c1e7e46446556a1f Mon Sep 17 00:00:00 2001 From: Stephen Hemminger Date: Sun, 16 Jul 2023 11:11:14 -0700 Subject: [PATCH] doc: fix description of runtime directories Cc: Xueming Li [ upstream commit b301f2d3ac0cf66907599a3e855abadd10881960 ] The documentation was never updated when the DPDK EAL was modified to follow standard runtime conventions. Fixes: 1835a22f342f ("support systemd service convention for runtime directory") Signed-off-by: Stephen Hemminger --- doc/guides/prog_guide/multi_proc_support.rst | 14 +++++++++----- 1 file changed, 9 insertions(+), 5 deletions(-) diff --git a/doc/guides/prog_guide/multi_proc_support.rst b/doc/guides/prog_guide/multi_proc_support.rst index 815e8bdc43..df234548a7 100644 --- a/doc/guides/prog_guide/multi_proc_support.rst +++ b/doc/guides/prog_guide/multi_proc_support.rst @@ -107,15 +107,19 @@ Running Multiple Independent DPDK Applications ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ In addition to the above scenarios involving multiple DPDK processes working together, -it is possible to run multiple DPDK processes side-by-side, +it is possible to run multiple DPDK processes concurrently, where those processes are all working independently. Support for this usage scenario is provided using the ``--file-prefix`` parameter to the EAL. -By default, the EAL creates hugepage files on each hugetlbfs filesystem using the rtemap_X filename, +The EAL puts shared runtime files in a directory based on standard conventions. +If ``$RUNTIME_DIRECTORY`` is defined in the environment, +it is used (as ``$RUNTIME_DIRECTORY/dpdk``). +Otherwise, if DPDK is run as root user, it uses ``/var/run/dpdk`` +or if run as non-root user then the ``/tmp/dpdk`` (or ``$XDG_RUNTIME_DIRECTORY/dpdk``) is used. +Hugepage files on each hugetlbfs filesystem use the ``rtemap_X`` filename, where X is in the range 0 to the maximum number of hugepages -1. -Similarly, it creates shared configuration files, memory mapped in each process, using the /var/run/.rte_config filename, -when run as root (or $HOME/.rte_config when run as a non-root user; -if filesystem and device permissions are set up to allow this). +Similarly, it creates shared configuration files, memory mapped in each process, +using the ``.rte_config`` filename. The rte part of the filenames of each of the above is configurable using the file-prefix parameter. In addition to specifying the file-prefix parameter, -- 2.25.1 --- Diff of the applied patch vs upstream commit (please double-check if non-empty: --- --- - 2023-08-09 21:51:21.204922300 +0800 +++ 0120-doc-fix-description-of-runtime-directories.patch 2023-08-09 21:51:18.294352000 +0800 @@ -1 +1 @@ -From b301f2d3ac0cf66907599a3e855abadd10881960 Mon Sep 17 00:00:00 2001 +From eba2c364844c6c434045ead9c1e7e46446556a1f Mon Sep 17 00:00:00 2001 @@ -4,0 +5,3 @@ +Cc: Xueming Li + +[ upstream commit b301f2d3ac0cf66907599a3e855abadd10881960 ] @@ -10 +12,0 @@ -Cc: stable@dpdk.org