From mboxrd@z Thu Jan 1 00:00:00 1970 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) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=from:to:cc:subject:date:message-id:in-reply-to:references; bh=BUFLnOKRCay6coxN8/Zz+vNU4PJAhghfoPTDXDPVRMA=; b=dQynDerHfRAMY3DF6mYOUS/7zpkOKvJ3US/JunWnJ6t4KEZBP8CvBRBrkh+8oYC/RV 0AlW2GU7Vvi2T2QjJDP+ic4TTWSEZabZnvlRXQ5r4b36FqSb9ZP5m6t/bQe2uvoWpA5R 6Unl4gvgnvtRCblisUKsicSwlJI31uCBLojZejtR3QimnPFaqc4H83b+r2zYla31woLw LukJwYA5cAK21VKG0J4fK5Go2usMX8KHvcFidELicrYKmQDOUyaxBxabZGbH1dtAdqQ2 EgJPWroowJDwm7j+jazCCqd0uGEtp1fqWOgD2jjN6cC5b9PjtwD97IwBAgpvtC0mUN3P qQOA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references; bh=BUFLnOKRCay6coxN8/Zz+vNU4PJAhghfoPTDXDPVRMA=; b=EIZ1/CmaXA5irepi/ym2K8qxeAFbAmDyAkkT9BcI27DQyUwD+HOWTMBrHHVmv63703 1Vhxjp0yeetlxTBijtkes248WzwB8CU8vLazZ5J3m7cDRH3MOLv5C4Qk/3Z5qgxbUCmY /w9hPc1Yl/wBzKxj+zVqklbhVK/U1lEJr788Qse6Zgf+aUJmlCQlbpEVGhkXryoaw1Ll ruJov1/xV5KQbs/CkN8LeCKfSNTbVpNi3pBrAjicBL5qyIYIRBFBxaBP6zMk9TEotPmB 7ZkTKU98mzef9sxTcoOkeemNqvjCW5CesE17aOSFNuwyxV+XH/4HdB0wb4znMbmUI2mn 0p0Q== X-Gm-Message-State: AOPr4FXIky9bw5zeLhYzs7hEQ2rexy5AJD/cFtETWkQaZFKhTCr6YisIb66eeDcOkLOZCg== X-Received: by 10.66.182.161 with SMTP id ef1mr4621647pac.40.1463514197213; Tue, 17 May 2016 12:43:17 -0700 (PDT) Received: from localhost.localdomain ([50.242.71.57]) by smtp.gmail.com with ESMTPSA id nz6sm6631613pab.39.2016.05.17.12.43.16 (version=TLS1_2 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Tue, 17 May 2016 12:43:16 -0700 (PDT) From: Alex Wang To: dev@dpdk.org Cc: ferruh.yigit@intel.com, Alex Wang Date: Sat, 14 May 2016 11:22:55 -0700 Message-Id: <1463250175-3024-2-git-send-email-ee07b291@gmail.com> X-Mailer: git-send-email 2.1.4 In-Reply-To: <1463250175-3024-1-git-send-email-ee07b291@gmail.com> References: <1463250175-3024-1-git-send-email-ee07b291@gmail.com> Subject: [dpdk-dev] [PATCH 2/2] rte_kni: Add documentation for the mempool capacity. X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: patches and discussions about DPDK List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 17 May 2016 19:43:19 -0000 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