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 7CD4445BD8; Fri, 25 Oct 2024 22:26:49 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 7011A4065E; Fri, 25 Oct 2024 22:26:43 +0200 (CEST) Received: from mail-lj1-f169.google.com (mail-lj1-f169.google.com [209.85.208.169]) by mails.dpdk.org (Postfix) with ESMTP id 9050940667 for ; Fri, 25 Oct 2024 22:26:41 +0200 (CEST) Received: by mail-lj1-f169.google.com with SMTP id 38308e7fff4ca-2fb584a8f81so24291531fa.3 for ; Fri, 25 Oct 2024 13:26:41 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1729888000; x=1730492800; 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=wHIqUG0DjSOla05iFU54rlA0gMTcJ6//J532BCpt+so=; b=lc4oYjpGG8XHxCZEe4R5ER8pwyvF6jS2eRCSI6HpCotmHDO8n6xzml4Lwu+G+Dv8mv C+rPW2ONM/CtmCOkZm+DLS4WXZuurEFyVWubRhbo8L7yDAMaEUw2SBstx0N4diaxl8OJ 0yXh+22KOLTWWDQvabI6sMC/jhN+P5r7pK0mCValndZyon1WXw0I5sip35mf3w8eSmKF S363MNTdNAbljKI7t/Nfzb3mCh0b++L8At/j07evP28IUVLn5DYanhbIPGD5LTg896g4 /sVTzxvzoJ8VWlNomvfHWjRVMhLI3kvBqPWY6xhTzNGHmPVh/szIufQPfoNkwARSbZF3 ou2A== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1729888000; x=1730492800; 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=wHIqUG0DjSOla05iFU54rlA0gMTcJ6//J532BCpt+so=; b=WO9jsGfpJupT8tWFlVvXc+x+aW62K/6/Lna/vQmQI6eOePpatrWsP63pxz2JAsh5+z Lto08rLwkxZQ2LiD1ytM9r7aP1/NWDMRDjr7Gcg6nQ3w2omqxhFbc//OOByUkDfKBCma lHoCrQV+3QuwJreFt3yjDyP7eq3RPdqllmyHq0xI4epEyXgoEAakE37CEErN3wTDQulT 9oNoDD2qtNJcdDme9YjCjrYmRBnq4Zk5OSgQNdCvO9qtb7jmTPr2u3gcZRsp93/041fi CFPXgtygn+0ER2HWwThibY0bFJR1PePruxBCvwpgsl7aCXVAi3yiNlyQwDRO+DYLqSi6 Vckg== X-Gm-Message-State: AOJu0Yzt3z1NjvNfRJO10gLdxjmujibqeewjpY0pBpwgFdbIoWF74TBO oUs6QTvBP9/rVktS+lrvtHvNZ9+p4xU3CTacNPY4uEauOkcscb9Hra2roji8 X-Google-Smtp-Source: AGHT+IERNxJcfIzZ+kDQ2uMPS/G0IrZEi1rHZyYMky9PrVxfx2SiKBaQlqQ1ylG7eG9dO06PBmZHaQ== X-Received: by 2002:a2e:4609:0:b0:2fb:5168:1a0c with SMTP id 38308e7fff4ca-2fcbdfc706cmr2887241fa.19.1729888000098; Fri, 25 Oct 2024 13:26:40 -0700 (PDT) Received: from sovereign.. (broadband-109-173-43-194.ip.moscow.rt.ru. [109.173.43.194]) by smtp.gmail.com with ESMTPSA id 38308e7fff4ca-2fcb453e341sm3101941fa.55.2024.10.25.13.26.36 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 25 Oct 2024 13:26:38 -0700 (PDT) From: Dmitry Kozlyuk To: dev@dpdk.org Cc: Anatoly Burakov , Lewis Donzis , Dmitry Kozlyuk Subject: [PATCH v2 2/2] doc: add instruction for including hugepages in core dump Date: Fri, 25 Oct 2024 23:26:15 +0300 Message-Id: <20241025202615.2581513-3-dmitry.kozliuk@gmail.com> X-Mailer: git-send-email 2.38.4 In-Reply-To: <20241025202615.2581513-1-dmitry.kozliuk@gmail.com> References: <20241023231859.1323727-1-kozlyuk@bifit.com> <20241025202615.2581513-1-dmitry.kozliuk@gmail.com> 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 Linux excludes hugepages from core dump by default. Describe the means to override this behavior as well as implications of doing so. Only mapped hugepages will be included in core dump, because Linux EAL explicitly excludes reserved regions. Signed-off-by: Dmitry Kozlyuk --- doc/guides/linux_gsg/build_sample_apps.rst | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/doc/guides/linux_gsg/build_sample_apps.rst b/doc/guides/linux_gsg/build_sample_apps.rst index 4f99617233..86d8712e69 100644 --- a/doc/guides/linux_gsg/build_sample_apps.rst +++ b/doc/guides/linux_gsg/build_sample_apps.rst @@ -180,6 +180,24 @@ Similarly, on a four socket system, to allocate 1 GB memory on each of sockets 0 No memory will be reserved on any CPU socket that is not explicitly referenced, for example, socket 3 in this case. If the DPDK cannot allocate enough memory on each socket, the EAL initialization fails. +Whether hugepages are included in core dump is controlled by ``/proc//coredump_filter``. +It is ``33`` (hexadecimal) by default, which means that hugepages are exclued from core dump. +This setting is per-process and is inherited. Refer to ``core(5)`` for details. +To include mapped hugepages in core dump, set bit 6 (``0x40``) in the parent process or shell +before running a DPDK application: + +.. code-block:: shell + + echo 0x73 > /proc/self/coredump_filter + ./rte-app ... + +.. note:: + + Including hugepages in core dump file increases its size, + which may fill the storage or overload the transport. + Hugepages typically hold data processed by the application, + like network packets, which may contain sensitive information. + Additional Sample Applications ------------------------------ -- 2.38.4