From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <dev-bounces@dpdk.org>
Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124])
	by inbox.dpdk.org (Postfix) with ESMTP id A908D42993;
	Thu, 20 Apr 2023 08:49:38 +0200 (CEST)
Received: from mails.dpdk.org (localhost [127.0.0.1])
	by mails.dpdk.org (Postfix) with ESMTP id 947F240A4B;
	Thu, 20 Apr 2023 08:49:38 +0200 (CEST)
Received: from mga05.intel.com (mga05.intel.com [192.55.52.43])
 by mails.dpdk.org (Postfix) with ESMTP id 9694F40687
 for <dev@dpdk.org>; Thu, 20 Apr 2023 08:49:36 +0200 (CEST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple;
 d=intel.com; i=@intel.com; q=dns/txt; s=Intel;
 t=1681973376; x=1713509376;
 h=from:to:cc:subject:date:message-id:mime-version:
 content-transfer-encoding;
 bh=IQU4txM3Y6BR46RcB/OJwpmo0RwgVr4L7YsMOCB0m7I=;
 b=jjm2+CQFqVlniqjTtWID9kOLpVpq/QXgOOzoGkTzWaVLlB7Pz/h+b6F9
 k5KOV4unMiRF3i/Ti8Hn+AYvdg6EsHngSNkhjBGhjYVaE+IlvaSalLsPu
 dExQVBGrUyNgZobBUIQYG+u9gPn4ORIywMzC8sI/AzqdUBWza0b1G+Ywi
 OVxFfkgu87i16fBJ0z/N0O2jwlsjEmJNneijavhZ5Sy+eFA3m/C7RvJEo
 C6aTxISyDsRzajMKn1XKrmzYDuTKJqW9cM3nyTGriLdb/KOKQstJFtZ0A
 JBNP6jGaX2l76FE6cMdlbyyNCUbS+2vUqrA7zTe5tg8Otkj1P40mbmcQD Q==;
X-IronPort-AV: E=McAfee;i="6600,9927,10685"; a="431926244"
X-IronPort-AV: E=Sophos;i="5.99,211,1677571200"; d="scan'208";a="431926244"
Received: from fmsmga008.fm.intel.com ([10.253.24.58])
 by fmsmga105.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384;
 19 Apr 2023 23:49:35 -0700
X-ExtLoop1: 1
X-IronPort-AV: E=McAfee;i="6600,9927,10685"; a="756385213"
X-IronPort-AV: E=Sophos;i="5.99,211,1677571200"; d="scan'208";a="756385213"
Received: from unknown (HELO localhost.localdomain) ([10.239.252.253])
 by fmsmga008-auth.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384;
 19 Apr 2023 23:49:33 -0700
From: Mingjin Ye <mingjinx.ye@intel.com>
To: dev@dpdk.org
Cc: yidingx.zhou@intel.com, Mingjin Ye <mingjinx.ye@intel.com>,
 Qiming Yang <qiming.yang@intel.com>, Wenjun Wu <wenjun1.wu@intel.com>
Subject: [PATCH] doc: add PMD known issue
Date: Thu, 20 Apr 2023 06:43:36 +0000
Message-Id: <20230420064336.141247-1-mingjinx.ye@intel.com>
X-Mailer: git-send-email 2.25.1
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 <dev.dpdk.org>
List-Unsubscribe: <https://mails.dpdk.org/options/dev>,
 <mailto:dev-request@dpdk.org?subject=unsubscribe>
List-Archive: <http://mails.dpdk.org/archives/dev/>
List-Post: <mailto:dev@dpdk.org>
List-Help: <mailto:dev-request@dpdk.org?subject=help>
List-Subscribe: <https://mails.dpdk.org/listinfo/dev>,
 <mailto:dev-request@dpdk.org?subject=subscribe>
Errors-To: dev-bounces@dpdk.org

Add a known issue: ASLR feature causes core dump.

Signed-off-by: Mingjin Ye <mingjinx.ye@intel.com>
---
 doc/guides/nics/ixgbe.rst | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/doc/guides/nics/ixgbe.rst b/doc/guides/nics/ixgbe.rst
index b1d77ab7ab..459d0d8380 100644
--- a/doc/guides/nics/ixgbe.rst
+++ b/doc/guides/nics/ixgbe.rst
@@ -461,3 +461,18 @@ show bypass config
 Show the bypass configuration for a bypass enabled NIC using the lowest port on the NIC::
 
    testpmd> show bypass config (port_id)
+
+ASLR feature causes core dump
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Core dump may occur when we start secondary processes on the vf port.
+Mainstream Linux distributions have the ASLR feature enabled by default,
+and the text segment of the process memory space is randomized.
+The secondary process calls the function address shared by the primary
+process, resulting in a core dump.
+
+   .. Note::
+
+	  Support for ASLR features varies by distribution. Redhat and
+	  Centos series distributions work fine. Ubuntu distributions
+	  will core dump, other Linux distributions are unknown.
-- 
2.25.1