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 D1A2F42E8F; Sun, 16 Jul 2023 20:11:27 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 5B05C4114A; Sun, 16 Jul 2023 20:11:27 +0200 (CEST) Received: from mail-pl1-f177.google.com (mail-pl1-f177.google.com [209.85.214.177]) by mails.dpdk.org (Postfix) with ESMTP id D40E34113F for ; Sun, 16 Jul 2023 20:11:26 +0200 (CEST) Received: by mail-pl1-f177.google.com with SMTP id d9443c01a7336-1b8b318c5a7so29606515ad.3 for ; Sun, 16 Jul 2023 11:11:26 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=networkplumber-org.20221208.gappssmtp.com; s=20221208; t=1689531085; x=1692123085; 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=LU5t8mtEhJ5XAahT09EiXEkhYzKlnAAn3Rz6HHOGgM4=; b=KXdvEmDC06oG3lmdzcIUTVYI9ISfeAJEZkI6pb6Mm49MO5P1LsVAbC9miVv0TeJ9kn wk6pcNGV0+idTOwZCEAAF64vMewtOQewbFUSvdHrzVkax7xXWSPKjdQ6zCrISH2HFqN0 1FhyIvRvAcLgBcVoNCPWM1N69kBTfsEJ8toSG3dP67P056P1nYiAsa1IUMXcAYzwb11M ToHISWZDenTO6qTYq1QiqcVcjvgxHIfnIZlCS0pHymXOWH3EF+UqfftopjYAb69PufzN Ufrcy6yuBhWyOcruq8jutAgtC6Fu1Z53Tn2a4BHE9XgGYbSQSvNK6rZeKh1/CY/fnawu Xn3Q== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1689531085; x=1692123085; 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=LU5t8mtEhJ5XAahT09EiXEkhYzKlnAAn3Rz6HHOGgM4=; b=dZ9qV4keIZPJMLH6l5JNP2umQ4UEBPOA32iSDAiWNl9y+BkaR+FlkIAFAwfgl1oyvj A6W471sXDC6L4kFms8Vb7Qzh8u2mSQZM7M+NYxWoVZz5j3bPa80liFhaRVHQxNttff8y an+FFo6V/6ZCfvHFMV3rSDfqXxuiPSsMay/4L9ktMcRnYwnWJQ77HaxCL+hn4RS1xcK8 Dkg7t12Yv67joJR2mhjKIde2+OSR0LA2C+RG0NU4VpH6Rnhl/IFLyFavQhnQf2+67GUb 1jhS/TBGvrFnlQ5hPKnKUE5AEpCcV6/cO2IhdrYNxtrph7RKkgxyIm+JVtrV00DpdkR6 N1lg== X-Gm-Message-State: ABy/qLZeHfS+cSwbO2X/rFRKHFAodR2NEwcWpDjIIUmDvDh0Ck5jLFmO wuFBK5TQW3CQ1GG0lQuUIq8OtJ1rZOnLmoJ/2jClmQ== X-Google-Smtp-Source: APBJJlGBPq7p83Adixmz5un4PFjVNZH8dE02ZDAQFECsWAdcDKyQ+O71buqg/6phipHw4CuPHb8vmQ== X-Received: by 2002:a17:903:2310:b0:1b8:91ad:79e2 with SMTP id d16-20020a170903231000b001b891ad79e2mr11782575plh.3.1689531085507; Sun, 16 Jul 2023 11:11:25 -0700 (PDT) Received: from hermes.local (204-195-127-207.wavecable.com. [204.195.127.207]) by smtp.gmail.com with ESMTPSA id u2-20020a170902a60200b001b9da42cd7dsm11178028plq.279.2023.07.16.11.11.24 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 16 Jul 2023 11:11:24 -0700 (PDT) From: Stephen Hemminger To: dev@dpdk.org Cc: Muhammad Jawad Hussain , Stephen Hemminger Subject: [PATCH] doc: fix description of runtime directories Date: Sun, 16 Jul 2023 11:11:14 -0700 Message-Id: <20230716181114.63452-1-stephen@networkplumber.org> X-Mailer: git-send-email 2.39.2 In-Reply-To: <20221103132926.445627-2-juraj.linkes@pantheon.tech> References: <20221103132926.445627-2-juraj.linkes@pantheon.tech> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit 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 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 | 13 ++++++++----- 1 file changed, 8 insertions(+), 5 deletions(-) diff --git a/doc/guides/prog_guide/multi_proc_support.rst b/doc/guides/prog_guide/multi_proc_support.rst index 815e8bdc4332..cdebfa8d05bb 100644 --- a/doc/guides/prog_guide/multi_proc_support.rst +++ b/doc/guides/prog_guide/multi_proc_support.rst @@ -107,15 +107,18 @@ 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 using 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.39.2