From mboxrd@z Thu Jan 1 00:00:00 1970 From: Alex Wang Subject: [PATCH 2/2] rte_kni: Add documentation for the mempool capacity. Date: Sat, 14 May 2016 11:22:55 -0700 Message-ID: <1463250175-3024-2-git-send-email-ee07b291@gmail.com> References: <1463250175-3024-1-git-send-email-ee07b291@gmail.com> Cc: ferruh.yigit@intel.com, Alex Wang To: dev@dpdk.org Return-path: Received: from mail-pa0-f66.google.com (mail-pa0-f66.google.com [209.85.220.66]) by dpdk.org (Postfix) with ESMTP id C3B868D4D for ; Tue, 17 May 2016 21:43:18 +0200 (CEST) Received: by mail-pa0-f66.google.com with SMTP id gh9so2702393pac.0 for ; Tue, 17 May 2016 12:43:18 -0700 (PDT) In-Reply-To: <1463250175-3024-1-git-send-email-ee07b291@gmail.com> List-Id: patches and discussions about DPDK List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org Sender: "dev" From: Alex Wang Function like 'rte_kni_rx_burst()' keeps allocating 'MAX_MBUF_BURST_NUM' mbufs to kni fifo queue unless the queue's capacity ('KNI_FIFO_COUNT_MAX') is reached. So, if the mempool is under-provisioned, user may run into "Out of Memory" logs from KNI code. This commit documents the need to provision mempool capacity of couple thousand elements for each KNI interface. Signed-off-by: Alex Wang --- lib/librte_kni/rte_kni.h | 3 +++ 1 file changed, 3 insertions(+) diff --git a/lib/librte_kni/rte_kni.h b/lib/librte_kni/rte_kni.h index 25fa45e..05d2d39 100644 --- a/lib/librte_kni/rte_kni.h +++ b/lib/librte_kni/rte_kni.h @@ -113,6 +113,9 @@ extern void rte_kni_init(unsigned int max_kni_ifaces); * The rte_kni_alloc shall not be called before rte_kni_init() has been * called. rte_kni_alloc is thread safe. * + * The mempool should have capacity of couple thousand elements for each + * KNI interface allocated. + * * @param pktmbuf_pool * The mempool for allocting mbufs for packets. * @param conf -- 2.1.4