From: Alex Wang Date: Sat, 21 May 2016 07:58:36 +0000 (-0700) Subject: kni: describe mempool capacity requirement X-Git-Tag: spdx-start~6759 X-Git-Url: http://git.droids-corp.org/?a=commitdiff_plain;h=460860100017a96117564c5b59c9f241083f7f8a;p=dpdk.git kni: describe mempool capacity requirement 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 more than "2 x KNI_FIFO_COUNT_MAX" for each KNI interface. Signed-off-by: Alex Wang Acked-by: Ferruh Yigit Acked-by: John McNamara --- diff --git a/lib/librte_kni/rte_kni.h b/lib/librte_kni/rte_kni.h index b724fa272e..7363e6cf50 100644 --- a/lib/librte_kni/rte_kni.h +++ b/lib/librte_kni/rte_kni.h @@ -113,6 +113,9 @@ 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 more than "2 x KNI_FIFO_COUNT_MAX" + * elements for each KNI interface allocated. + * * @param pktmbuf_pool * The mempool for allocting mbufs for packets. * @param conf