From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mga12.intel.com (mga12.intel.com [192.55.52.136]) by dpdk.org (Postfix) with ESMTP id 4FFD7DE3 for ; Fri, 25 May 2018 15:41:07 +0200 (CEST) X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from orsmga004.jf.intel.com ([10.7.209.38]) by fmsmga106.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 25 May 2018 06:41:06 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.49,440,1520924400"; d="scan'208";a="202431350" Received: from irvmail001.ir.intel.com ([163.33.26.43]) by orsmga004.jf.intel.com with ESMTP; 25 May 2018 06:41:04 -0700 Received: from sivswdev01.ir.intel.com (sivswdev01.ir.intel.com [10.237.217.45]) by irvmail001.ir.intel.com (8.14.3/8.13.6/MailSET/Hub) with ESMTP id w4PDf4l5007947; Fri, 25 May 2018 14:41:04 +0100 Received: from sivswdev01.ir.intel.com (localhost [127.0.0.1]) by sivswdev01.ir.intel.com with ESMTP id w4PDf4Hk024732; Fri, 25 May 2018 14:41:04 +0100 Received: (from aburakov@localhost) by sivswdev01.ir.intel.com with LOCAL id w4PDf4X8024728; Fri, 25 May 2018 14:41:04 +0100 From: Anatoly Burakov To: dev@dpdk.org Cc: John McNamara , Marko Kovacevic , thomas@monjalon.net Date: Fri, 25 May 2018 14:41:03 +0100 Message-Id: <28f51d457b24022cc9b9695688e3a962567a233b.1527255643.git.anatoly.burakov@intel.com> X-Mailer: git-send-email 1.7.0.7 In-Reply-To: <68f449f31b079aad4707cf6c9db8d1042861381d.1527255643.git.anatoly.burakov@intel.com> References: <68f449f31b079aad4707cf6c9db8d1042861381d.1527255643.git.anatoly.burakov@intel.com> In-Reply-To: <68f449f31b079aad4707cf6c9db8d1042861381d.1527255643.git.anatoly.burakov@intel.com> References: <68f449f31b079aad4707cf6c9db8d1042861381d.1527255643.git.anatoly.burakov@intel.com> Subject: [dpdk-dev] [PATCH 2/2] doc: update release notes with info about memory changes X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 25 May 2018 13:41:08 -0000 Signed-off-by: Anatoly Burakov --- doc/guides/rel_notes/release_18_05.rst | 34 ++++++++++++++++++++++++++++++++++ 1 file changed, 34 insertions(+) diff --git a/doc/guides/rel_notes/release_18_05.rst b/doc/guides/rel_notes/release_18_05.rst index 40eec3a..84b7434 100644 --- a/doc/guides/rel_notes/release_18_05.rst +++ b/doc/guides/rel_notes/release_18_05.rst @@ -41,6 +41,40 @@ New Features Also, make sure to start the actual text at the margin. ========================================================= +* **Reworked memory subsystem.** + + Memory subsystem has been reworked to support new functionality. + + On Linux, support for reserving/unreserving hugepage memory at runtime was + added, so applications no longer need to pre-reserve memory at startup. Due to + reorganized internal workings of memory subsystem, any memory allocated + through ``rte_malloc()`` or ``rte_memzone_reserve()`` is no longer guaranteed + to be IOVA-contiguous. + + This functionality has introduced the following changes: + + * ``rte_eal_get_physmem_layout()`` was removed + * A new flag for memzone reservation (``RTE_MEMZONE_IOVA_CONTIG``) was added + to ensure reserved memory will be IOVA-contiguous, for use with device + drivers and other cases requiring such memory + * New callbacks for memory allocation/deallocation events, allowing user (or + drivers) to be notified of new memory being allocated or deallocated + * New callbacks for validating memory allocations above specified limit, + allowing user to permit or deny memory allocations + * A new command-line switch ``--legacy-mem`` to enable EAL behavior similar to + how older versions of DPDK worked (memory segments that are IOVA-contiguous, + but hugepages are reserved at startup only, and can never be released) + * A new command-line switch ``--single-file-segments`` to put all memory + segments within a segment list in a single file + * A set of convenience function calls to look up and iterate over allocated + memory segments + * ``-m`` and ``--socket-mem`` command-line arguments now carry an additional + meaning and mark pre-reserved hugepages as "unfree-able", thereby acting as + a mechanism guaranteeing minimum availability of hugepage memory to the + application + + Reserving/unreserving memory at runtime is not currently supported on FreeBSD. + * **Added bucket mempool driver.** Added bucket mempool driver which provides a way to allocate contiguous -- 2.7.4