From patchwork Fri Oct 20 14:00:06 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Github ODP bot X-Patchwork-Id: 116496 Delivered-To: patch@linaro.org Received: by 10.80.245.45 with SMTP id t42csp6240edm; Fri, 20 Oct 2017 07:00:31 -0700 (PDT) X-Google-Smtp-Source: ABhQp+QdEJPzif6BMP10RsGY1gLXA+tWUQLmEm2iZbk0NnJkMw60gi10omVGLS1sXxPQq3uzHOl5 X-Received: by 10.55.170.74 with SMTP id t71mr7070027qke.84.1508508030890; Fri, 20 Oct 2017 07:00:30 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1508508030; cv=none; d=google.com; s=arc-20160816; b=po4sjxqXgOPzDCuYnMwcVl1O6oU5gTZkT0VTABXyVOi3+lL++4IKv33/tP5blyd4xm m99OcRZ2SUI0Wawyxpm2zh9PefUi2EAZuQxWL2WU31d/jfvsIjX2eKsErx0uLJFlfcNm io5B/bKg/ZmnzKQe5ieUoRhUKSssIL/0LAKflMVq0A+KBeTjJezF5Lq1dFJUmZg4dwuo 4AykF2McEbpUfcsYixLbzMxQs7TdslHj370xOwKLzn8qvzYxaMxgbkNSDJ8obJYojuja jC45zi3T7Y2LBrFv3HVmLZ1YckASYQZWiWbXaGPeLq1YGtf/NPrZ+yMCxbOc6xgheRZL c0vA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=sender:errors-to:list-subscribe:list-help:list-post:list-archive :list-unsubscribe:list-id:precedence:subject:github-pr-num :references:in-reply-to:message-id:date:to:from:delivered-to :arc-authentication-results; bh=YZj30fm5d/z2awsTrEf4Ys9WIkOzO5pwZ1B4GSeFEnI=; b=Zg+RJ11SFxgeXVPKZFCRgzygpUXzi4jI8fn1Gq7CJXoGKPtdFm3+ykMrD2T+fqdUzz qO0qte1xy8KSLUNyjM6GiAemwP1wr0PHnSKt6Zee61E/55AdPCAK1BA6ODA1kZW99faH SxYsRTHXRb/CcQGVgTRPfl94db0l+DsGmvYilky5/rV+1qkwcv9LhjCuWXaPwywf8X81 h3emFA9Xjz+uLCDeADDaa0tDrm44I8dml9AvXPDC81Ea28ubplolVIhNctihYT+aZ9BW LK3ilRL0QkANgQ6vSI/jEC+cdGCDiVjiZBSPzv51NW2HlC6ukbgDArTYYE0WGwSp+ky6 zi2Q== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: domain of lng-odp-bounces@lists.linaro.org designates 54.197.127.237 as permitted sender) smtp.mailfrom=lng-odp-bounces@lists.linaro.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=yandex.ru Return-Path: Received: from lists.linaro.org (ec2-54-197-127-237.compute-1.amazonaws.com. [54.197.127.237]) by mx.google.com with ESMTP id j123si799739qkd.58.2017.10.20.07.00.30; Fri, 20 Oct 2017 07:00:30 -0700 (PDT) Received-SPF: pass (google.com: domain of lng-odp-bounces@lists.linaro.org designates 54.197.127.237 as permitted sender) client-ip=54.197.127.237; Authentication-Results: mx.google.com; spf=pass (google.com: domain of lng-odp-bounces@lists.linaro.org designates 54.197.127.237 as permitted sender) smtp.mailfrom=lng-odp-bounces@lists.linaro.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=yandex.ru Received: by lists.linaro.org (Postfix, from userid 109) id 3F0AA60C90; Fri, 20 Oct 2017 14:00:30 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on ip-10-142-244-252 X-Spam-Level: X-Spam-Status: No, score=-2.6 required=5.0 tests=BAYES_00,FREEMAIL_FROM, RCVD_IN_DNSWL_LOW,RCVD_IN_MSPIKE_H3,RCVD_IN_MSPIKE_WL,URIBL_BLOCKED autolearn=disabled version=3.4.0 Received: from [127.0.0.1] (localhost [127.0.0.1]) by lists.linaro.org (Postfix) with ESMTP id 0D1DE60CF7; Fri, 20 Oct 2017 14:00:23 +0000 (UTC) X-Original-To: lng-odp@lists.linaro.org Delivered-To: lng-odp@lists.linaro.org Received: by lists.linaro.org (Postfix, from userid 109) id 554F960B15; Fri, 20 Oct 2017 14:00:16 +0000 (UTC) Received: from forward105o.mail.yandex.net (forward105o.mail.yandex.net [37.140.190.183]) by lists.linaro.org (Postfix) with ESMTPS id 3158D60916 for ; Fri, 20 Oct 2017 14:00:14 +0000 (UTC) Received: from mxback14j.mail.yandex.net (mxback14j.mail.yandex.net [IPv6:2a02:6b8:0:1619::90]) by forward105o.mail.yandex.net (Yandex) with ESMTP id 4D64F444562B for ; Fri, 20 Oct 2017 17:00:12 +0300 (MSK) Received: from smtp2p.mail.yandex.net (smtp2p.mail.yandex.net [2a02:6b8:0:1472:2741:0:8b6:7]) by mxback14j.mail.yandex.net (nwsmtp/Yandex) with ESMTP id AXSeaAUbjD-0ChafJT6; Fri, 20 Oct 2017 17:00:12 +0300 Received: by smtp2p.mail.yandex.net (nwsmtp/Yandex) with ESMTPSA id oYJZ4Lhrtd-0BWeMiJE; Fri, 20 Oct 2017 17:00:11 +0300 (using TLSv1.2 with cipher ECDHE-RSA-AES128-SHA256 (128/128 bits)) (Client certificate not present) From: Github ODP bot To: lng-odp@lists.linaro.org Date: Fri, 20 Oct 2017 17:00:06 +0300 Message-Id: <1508508006-21197-2-git-send-email-odpbot@yandex.ru> X-Mailer: git-send-email 1.9.1 In-Reply-To: <1508508006-21197-1-git-send-email-odpbot@yandex.ru> References: <1508508006-21197-1-git-send-email-odpbot@yandex.ru> Github-pr-num: 247 Subject: [lng-odp] [PATCH API-NEXT v1 1/1] api: pktio: clarify odp_pktio_config() restrictions X-BeenThere: lng-odp@lists.linaro.org X-Mailman-Version: 2.1.16 Precedence: list List-Id: "The OpenDataPlane \(ODP\) List" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: lng-odp-bounces@lists.linaro.org Sender: "lng-odp" From: Bill Fischofer Add clarification that odp_pktio_config() cannot be used to configure options that are not supported, as indicated by odp_pktio_capability(). Signed-off-by: Bill Fischofer --- /** Email created from pull request 247 (Bill-Fischofer-Linaro:pktio-config-doc) ** https://github.com/Linaro/odp/pull/247 ** Patch: https://github.com/Linaro/odp/pull/247.patch ** Base sha: e3108af2f0b58c2ceca422b418439bba5de04b11 ** Merge commit sha: fc118350c5aa950e860cd53a6104b0571aa2e59b **/ include/odp/api/spec/packet_io.h | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/include/odp/api/spec/packet_io.h b/include/odp/api/spec/packet_io.h index 52af646a6..48dd76f28 100644 --- a/include/odp/api/spec/packet_io.h +++ b/include/odp/api/spec/packet_io.h @@ -605,7 +605,8 @@ unsigned odp_pktio_max_index(void); * interface setup sequence. Use odp_pktio_capability() to query configuration * capabilities. Use odp_pktio_config_init() to initialize * configuration options into their default values. Default values are used - * when 'config' pointer is NULL. + * when 'config' pointer is NULL. Attempting to configure options that are + * not supported, as indicated by odp_pktio_capability(), will be rejected. * * @param pktio Packet IO handle * @param config Packet IO interface configuration. Uses defaults