From patchwork Mon Jan 22 10:00:17 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Github ODP bot X-Patchwork-Id: 125377 Delivered-To: patch@linaro.org Received: by 10.46.66.141 with SMTP id h13csp1069104ljf; Mon, 22 Jan 2018 02:05:54 -0800 (PST) X-Google-Smtp-Source: AH8x225O+UbwJFDzKdpgRYLkiA7hnGGrhyY7y2ONRdkQZZJYA3WDJFivAHkgk9KmK9wlBr5CNsbt X-Received: by 10.237.43.225 with SMTP id e88mr9232875qtd.142.1516615554338; Mon, 22 Jan 2018 02:05:54 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1516615554; cv=none; d=google.com; s=arc-20160816; b=p3sUi+RxH1eAj2OXmppjyODsZkXdQaeus0L0WKHGOydfGVqRUxpoQTspT3tllSwMt3 unr2R1L6vBL5UpZlk7TXKnio/cke6Mh5887vq2FSGZvdGaxCFkNRn5ZVmyk/RMhPXYC5 NqV1yO4ldt7Y0pt+8HhSyRkRIWhMMfSNJ0+5t8FWusSsZ096c5GvJxdUJFs2oEOZyl1E d98gi94p+oZU80QENNwuMbueK61tvr/QEhmChILwJxGa4UKBDafGYNwjvfgMeKxHs3hH 9+ToXTwygnS40CioiwMPprAazz22PHG740UgFSS7zArNtQ3iRpXV+Jv/t19E45RB7fRE kcOw== 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=JgkETsG0OciRK64xYPeextC9K+jS2Q9VJQwSHMDO7UE=; b=nC087/YF+GYHTn7tWjXcF3ZUXIgElq02T2aWJjo8fRnNKeZwFcKx4hln1vx/LwzQ3k jKXBsSJCFmyhBQPZRg/3H+zayFnVH6yqKaA1Qfsgq940rlb0UNm0gH7mv1+350oMILoA +fOZ9Ukp/Tz6tADgpdl+xHOkVgZfwD1V2exXb1xKq/IbgLcwMLUanEBInz+ny4lI60OK qIL5HcJz6saagkFddiiQ7hA7SyrBtsT/yxdT5PrJB28jXG7Z47iLHdCZQdiKGNYxMxZL tNnLF+VdUbB1v0s+MrdNDlFmCgB1D19stjZuHMLrJYyfYVY0+xJSMB+fHmeIgKeniJf8 MS4A== 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 t1si15255281qkh.262.2018.01.22.02.05.54; Mon, 22 Jan 2018 02:05:54 -0800 (PST) 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 F24B362785; Mon, 22 Jan 2018 10:05:53 +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_H2 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 C063E62779; Mon, 22 Jan 2018 10:01:03 +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 61EB4614E3; Mon, 22 Jan 2018 10:00:34 +0000 (UTC) Received: from forward104p.mail.yandex.net (forward104p.mail.yandex.net [77.88.28.107]) by lists.linaro.org (Postfix) with ESMTPS id 7E484608FA for ; Mon, 22 Jan 2018 10:00:24 +0000 (UTC) Received: from mxback12g.mail.yandex.net (mxback12g.mail.yandex.net [IPv6:2a02:6b8:0:1472:2741:0:8b7:91]) by forward104p.mail.yandex.net (Yandex) with ESMTP id 6F58B183318 for ; Mon, 22 Jan 2018 13:00:23 +0300 (MSK) Received: from smtp3p.mail.yandex.net (smtp3p.mail.yandex.net [2a02:6b8:0:1472:2741:0:8b6:8]) by mxback12g.mail.yandex.net (nwsmtp/Yandex) with ESMTP id X5FMkGll9N-0NX0t9J4; Mon, 22 Jan 2018 13:00:23 +0300 Received: by smtp3p.mail.yandex.net (nwsmtp/Yandex) with ESMTPSA id uZYuxzgHNY-0NHeIhNd; Mon, 22 Jan 2018 13:00:23 +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: Mon, 22 Jan 2018 13:00:17 +0300 Message-Id: <1516615219-32202-5-git-send-email-odpbot@yandex.ru> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1516615219-32202-1-git-send-email-odpbot@yandex.ru> References: <1516615219-32202-1-git-send-email-odpbot@yandex.ru> Github-pr-num: 392 Subject: [lng-odp] [PATCH API-NEXT v2 4/6] api: packet: initialize user ptr to NULL 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: Petri Savolainen Require that implementation initializes the pointer value to NULL. Application can use the pointer more robustly when it can tell if the pointer has been set previously or not. Signed-off-by: Petri Savolainen --- /** Email created from pull request 392 (psavol:next-user-ptr-init-rebase) ** https://github.com/Linaro/odp/pull/392 ** Patch: https://github.com/Linaro/odp/pull/392.patch ** Base sha: f925f103c90591776f73863d30159357b08bf71e ** Merge commit sha: 81c268611ef9755e8347f532022e22148f7d2a09 **/ include/odp/api/spec/packet.h | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) diff --git a/include/odp/api/spec/packet.h b/include/odp/api/spec/packet.h index a1111325e..3222ff5c2 100644 --- a/include/odp/api/spec/packet.h +++ b/include/odp/api/spec/packet.h @@ -1341,7 +1341,10 @@ int odp_packet_input_index(odp_packet_t pkt); /** * User context pointer * - * Return previously stored user context pointer. + * Return previously stored user context pointer. If not otherwise documented, + * the pointer value is maintained over packet manipulating operations. + * Implementation initializes the pointer value to NULL during new packet + * creation (e.g. alloc and packet input) and reset. * * @param pkt Packet handle * @@ -1357,10 +1360,10 @@ void *odp_packet_user_ptr(odp_packet_t pkt); * value of type intptr_t. ODP may use the pointer for data prefetching, but * must ignore any invalid addresses. * - * @param pkt Packet handle - * @param ctx User context pointer + * @param pkt Packet handle + * @param user_ptr User context pointer */ -void odp_packet_user_ptr_set(odp_packet_t pkt, const void *ctx); +void odp_packet_user_ptr_set(odp_packet_t pkt, const void *user_ptr); /** * User area address