From patchwork Mon Jan 22 12: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: 125404 Delivered-To: patch@linaro.org Received: by 10.46.66.141 with SMTP id h13csp1118272ljf; Mon, 22 Jan 2018 04:05:09 -0800 (PST) X-Google-Smtp-Source: AH8x2259iSQ6J/8/2RzQb4677wxRahIlnhmW71IpubWrCAn4zXJtJkBmWpOaa90XhhwCh0Yzo8W5 X-Received: by 10.200.30.141 with SMTP id c13mr1562894qtm.156.1516622709171; Mon, 22 Jan 2018 04:05:09 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1516622709; cv=none; d=google.com; s=arc-20160816; b=ezuci00qiwvsUTmEYj/JtWIq8XD9dtzGcAzD6LaToM0mLF/XC8D7GzETqYszg1CbCk LG6QZiX2lwTVq4OdTtOrrV++rVhyDwFpame/JiM3lXMI6XchGq6imt0FJhdM1mcMnNWV vCdfCD1UpB/nkktsD5WynVVOwEWRyMQOSSZcyQqSc++KW+0vUyCSd4vtY8aD2mf07hs1 DfrxJ0znGRrIdldwFeYlUL9Bt8XuN1d2U6+R3Z5Mr8WTVHvbsb0HwvzOPoPObmIE1CCJ c38PXsmtdxToqVU43et1ISwxmJ+wkKJV5EASQK343MlCBCnBbeQqn6RIubvS0cpO/7kL Z2gw== 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=ZgBBjxgmExGIcaS9GdgEk7ojOqKoGe7+Z1Wkaw7GttE=; b=PZ1wwMJW7xXqU+v9Ug6A7AjcuNvl3fCE5MOQNnK1sTy0Dh0R3U8PiPQB4bObTI+r+4 f6JVzxwCOfTtNcslQQCWBYi6X2fm7Drirht6Gp032kksRH8oyZqMC4QQo9OznlSS69qE 7kGUhpr3DQxNxTUDL6zN3ZQCc6bWWJfHS5iMS1kYvvFYP/V8u0Ls7aMbfi5653rT/G2O lMbzXpSmvmfPxzhx6Mt6pf1hm7NbdKc8vr7QFruC+dzuU2k2hNXYDP1YVqz6xy1SySAb 6UyeZWHbRsJALJI012Dq/imrlul+VokF/Jymie8s7aZ2K8zefD0cYPQecWLbe1W0Ot5y I9sQ== 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 o14si3418031qke.428.2018.01.22.04.05.08; Mon, 22 Jan 2018 04:05:09 -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 C64156152B; Mon, 22 Jan 2018 12:05:08 +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 4B9446179E; Mon, 22 Jan 2018 12:01:54 +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 3DF0C616F3; Mon, 22 Jan 2018 12:01:30 +0000 (UTC) Received: from forward100j.mail.yandex.net (forward100j.mail.yandex.net [5.45.198.240]) by lists.linaro.org (Postfix) with ESMTPS id B0A05616F3 for ; Mon, 22 Jan 2018 12:00:25 +0000 (UTC) Received: from mxback2j.mail.yandex.net (mxback2j.mail.yandex.net [IPv6:2a02:6b8:0:1619::10b]) by forward100j.mail.yandex.net (Yandex) with ESMTP id 4B61A5D821E6 for ; Mon, 22 Jan 2018 15:00:24 +0300 (MSK) Received: from smtp4o.mail.yandex.net (smtp4o.mail.yandex.net [2a02:6b8:0:1a2d::28]) by mxback2j.mail.yandex.net (nwsmtp/Yandex) with ESMTP id zUjpca5uXF-0OmefSGh; Mon, 22 Jan 2018 15:00:24 +0300 Received: by smtp4o.mail.yandex.net (nwsmtp/Yandex) with ESMTPSA id WD5CZQ6bpO-0NQOTh4e; Mon, 22 Jan 2018 15: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 15:00:17 +0300 Message-Id: <1516622419-10351-5-git-send-email-odpbot@yandex.ru> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1516622419-10351-1-git-send-email-odpbot@yandex.ru> References: <1516622419-10351-1-git-send-email-odpbot@yandex.ru> Github-pr-num: 392 Subject: [lng-odp] [PATCH API-NEXT v3 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: 5fba303faf04d29b616f687ce1f721400b2c6f9c ** Merge commit sha: c91d727cb8abe5b21a4fb430ee09541af51b40e4 **/ 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