From patchwork Fri Nov 28 11:34:28 2014 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Leif Lindholm X-Patchwork-Id: 5403011 Return-Path: X-Original-To: patchwork-linux-arm@patchwork.kernel.org Delivered-To: patchwork-parsemail@patchwork1.web.kernel.org Received: from mail.kernel.org (mail.kernel.org [198.145.19.201]) by patchwork1.web.kernel.org (Postfix) with ESMTP id 9815D9F443 for ; Fri, 28 Nov 2014 11:37:27 +0000 (UTC) Received: from mail.kernel.org (localhost [127.0.0.1]) by mail.kernel.org (Postfix) with ESMTP id 6646E20138 for ; Fri, 28 Nov 2014 11:37:26 +0000 (UTC) Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.9]) (using TLSv1.2 with cipher DHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id 2F3C32012D for ; Fri, 28 Nov 2014 11:37:25 +0000 (UTC) Received: from localhost ([127.0.0.1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.80.1 #2 (Red Hat Linux)) id 1XuJpF-00015E-Vp; Fri, 28 Nov 2014 11:35:01 +0000 Received: from mail-wg0-f51.google.com ([74.125.82.51]) by bombadil.infradead.org with esmtps (Exim 4.80.1 #2 (Red Hat Linux)) id 1XuJp9-0000uU-E0 for linux-arm-kernel@lists.infradead.org; Fri, 28 Nov 2014 11:34:57 +0000 Received: by mail-wg0-f51.google.com with SMTP id k14so8503073wgh.24 for ; Fri, 28 Nov 2014 03:34:32 -0800 (PST) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:date:from:to:cc:subject:message-id:references :mime-version:content-type:content-disposition:in-reply-to :user-agent; bh=AiA3sblLs46uB/3L4QjWhN9PYzi+skYdRDifFu6ZBGg=; b=WwgJn+6QJfVqXqoccQwE8oUabCzEPtB+PgWR72cGglQZyjsRW568ZDoBGU2Igs9N9w Mu0wMj3oph2IyiXGzRJJrUe58V9VXerczCHRwyN7H7At0w+ZWgA0J/CLjmC7F6deGsKe gH6152flry2WtnTcKA75SdGnyiXtTlnbC0rzK8kkOIsbpIp/NIl4l9Exd+Mnnlu9+QqR agyqezk8uvBblq+2awnjJIG4bsf5hZiq5KRqdLqIsXb1dGBjZWOJ14v7cs4hj8YBo4Eg N+D5TJOr70hnlxjiWwCopmvgL7pdVXUUFcDo/KcjEAXiNtliWTeVB5JDVSBO8Go0KvaH AH3g== X-Gm-Message-State: ALoCoQnG6YsH5483zlQCb34/3vOEWzQdtnxH/EME7bGuEgwU8Z9A8I513lMT40/xK/I64/sJ85QO X-Received: by 10.180.211.79 with SMTP id na15mr53329302wic.36.1417174472022; Fri, 28 Nov 2014 03:34:32 -0800 (PST) Received: from bivouac.eciton.net (bivouac.eciton.net. [2a00:1098:0:86:1000:23:0:2]) by mx.google.com with ESMTPSA id wb9sm1313098wic.20.2014.11.28.03.34.30 for (version=TLSv1.2 cipher=RC4-SHA bits=128/128); Fri, 28 Nov 2014 03:34:31 -0800 (PST) Date: Fri, 28 Nov 2014 11:34:28 +0000 From: Leif Lindholm To: Grant Likely Subject: Re: [PATCH v3 2/3] of: add optional options parameter to of_find_node_by_path() Message-ID: <20141128113428.GM2361@bivouac.eciton.net> References: <1417110967-16284-1-git-send-email-leif.lindholm@linaro.org> <1417110967-16284-3-git-send-email-leif.lindholm@linaro.org> <20141128004403.08D90C40A7F@trevor.secretlab.ca> MIME-Version: 1.0 Content-Disposition: inline In-Reply-To: <20141128004403.08D90C40A7F@trevor.secretlab.ca> User-Agent: Mutt/1.5.21 (2010-09-15) X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20141128_033455_797219_3214BCB2 X-CRM114-Status: GOOD ( 34.63 ) X-Spam-Score: -0.7 (/) Cc: mark.rutland@arm.com, devicetree@vger.kernel.org, andrew@lunn.ch, s.hauer@pengutronix.de, linux-kernel@vger.kernel.org, robh+dt@kernel.org, ijc@debian.org, plagnioj@jcrosoft.com, linux-arm-kernel@lists.infradead.org X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.18-1 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+patchwork-linux-arm=patchwork.kernel.org@lists.infradead.org X-Spam-Status: No, score=-2.6 required=5.0 tests=BAYES_00, RCVD_IN_DNSWL_LOW, T_RP_MATCHES_RCVD, UNPARSEABLE_RELAY autolearn=unavailable version=3.3.1 X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on mail.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP On Fri, Nov 28, 2014 at 12:44:03AM +0000, Grant Likely wrote: > On Thu, 27 Nov 2014 17:56:06 +0000 > , Leif Lindholm > wrote: > > Update of_find_node_by_path(): > > 1) Rename function to of_find_node_opts_by_path(), adding an optional > > pointer argument. Provide a static inline wrapper version of > > of_find_node_by_path() which calls the new function with NULL as > > the optional argument. > > 2) Ignore any part of the path beyond and including the ':' separator. > > 3) Set the new provided pointer argument to the beginning of the string > > following the ':' separator. > > 4: Add tests. > > > > Signed-off-by: Leif Lindholm > > --- > > drivers/of/base.c | 21 +++++++++++++++++---- > > drivers/of/selftest.c | 12 ++++++++++++ > > include/linux/of.h | 14 +++++++++++++- > > 3 files changed, 42 insertions(+), 5 deletions(-) > > > > diff --git a/drivers/of/base.c b/drivers/of/base.c > > index 3823edf..7f0e5f7 100644 > > --- a/drivers/of/base.c > > +++ b/drivers/of/base.c > > @@ -699,10 +699,15 @@ static struct device_node *__of_find_node_by_path(struct device_node *parent, > > { > > struct device_node *child; > > int len = strchrnul(path, '/') - path; > > + int term; > > > > if (!len) > > return NULL; > > > > + term = strchrnul(path, ':') - path; > > + if (term < len) > > + len = term; > > + > > __for_each_child_of_node(parent, child) { > > const char *name = strrchr(child->full_name, '/'); > > if (WARN(!name, "malformed device_node %s\n", child->full_name)) > > @@ -715,11 +720,14 @@ static struct device_node *__of_find_node_by_path(struct device_node *parent, > > } > > > > /** > > - * of_find_node_by_path - Find a node matching a full OF path > > + * of_find_node_opts_by_path - Find a node matching a full OF path > > * @path: Either the full path to match, or if the path does not > > * start with '/', the name of a property of the /aliases > > * node (an alias). In the case of an alias, the node > > * matching the alias' value will be returned. > > + * @opts: Address of a pointer into which to store the start of > > + * an options string appended to the end of the path with > > + * a ':' separator. > > * > > * Valid paths: > > * /foo/bar Full path > > @@ -729,19 +737,24 @@ static struct device_node *__of_find_node_by_path(struct device_node *parent, > > * Returns a node pointer with refcount incremented, use > > * of_node_put() on it when done. > > */ > > -struct device_node *of_find_node_by_path(const char *path) > > +struct device_node *of_find_node_opts_by_path(const char *path, const char **opts) > > { > > struct device_node *np = NULL; > > struct property *pp; > > unsigned long flags; > > + char *separator; > > > > if (strcmp(path, "/") == 0) > > return of_node_get(of_allnodes); > > > > + separator = strchr(path, ':'); > > + if (separator && opts) > > + *opts = separator + 1; > > + > > What about when there are no opts? Do we require the caller to make sure > opts is NULL before calling the function (which sounds like a good > source of bugs) or do we clear it on successful return? > > I think if opts is passed in, but there are no options, then it should > set *opts = NULL. Yeah, oops. > There should be test cases for this also. Must set opts to NULL on > successful return, and (I think) should leave opts alone on an > unsuccessful search. I would actually argue for always nuking the opts - since that could (theoretically) prevent something working by accident in spite of error conditions. How about the below? / Leif From 2e1a44e539967d96366d074ae158092900e0c822 Mon Sep 17 00:00:00 2001 From: Leif Lindholm Date: Thu, 27 Nov 2014 09:24:31 +0000 Subject: [PATCH] of: add optional options parameter to of_find_node_by_path() Update of_find_node_by_path(): 1) Rename function to of_find_node_opts_by_path(), adding an optional pointer argument. Provide a static inline wrapper version of of_find_node_by_path() which calls the new function with NULL as the optional argument. 2) Ignore any part of the path beyond and including the ':' separator. 3) Set the new provided pointer argument to the beginning of the string following the ':' separator. 4: Add tests. Signed-off-by: Leif Lindholm --- drivers/of/base.c | 21 +++++++++++++++++---- drivers/of/selftest.c | 17 +++++++++++++++++ include/linux/of.h | 14 +++++++++++++- 3 files changed, 47 insertions(+), 5 deletions(-) diff --git a/drivers/of/base.c b/drivers/of/base.c index 3823edf..99f0fd9 100644 --- a/drivers/of/base.c +++ b/drivers/of/base.c @@ -699,10 +699,15 @@ static struct device_node *__of_find_node_by_path(struct device_node *parent, { struct device_node *child; int len = strchrnul(path, '/') - path; + int term; if (!len) return NULL; + term = strchrnul(path, ':') - path; + if (term < len) + len = term; + __for_each_child_of_node(parent, child) { const char *name = strrchr(child->full_name, '/'); if (WARN(!name, "malformed device_node %s\n", child->full_name)) @@ -715,11 +720,14 @@ static struct device_node *__of_find_node_by_path(struct device_node *parent, } /** - * of_find_node_by_path - Find a node matching a full OF path + * of_find_node_opts_by_path - Find a node matching a full OF path * @path: Either the full path to match, or if the path does not * start with '/', the name of a property of the /aliases * node (an alias). In the case of an alias, the node * matching the alias' value will be returned. + * @opts: Address of a pointer into which to store the start of + * an options string appended to the end of the path with + * a ':' separator. * * Valid paths: * /foo/bar Full path @@ -729,19 +737,24 @@ static struct device_node *__of_find_node_by_path(struct device_node *parent, * Returns a node pointer with refcount incremented, use * of_node_put() on it when done. */ -struct device_node *of_find_node_by_path(const char *path) +struct device_node *of_find_node_opts_by_path(const char *path, const char **opts) { struct device_node *np = NULL; struct property *pp; unsigned long flags; + char *separator; if (strcmp(path, "/") == 0) return of_node_get(of_allnodes); + separator = strchr(path, ':'); + if (opts) + *opts = separator ? separator + 1 : NULL; + /* The path could begin with an alias */ if (*path != '/') { char *p = strchrnul(path, '/'); - int len = p - path; + int len = separator ? separator - path : p - path; /* of_aliases must not be NULL */ if (!of_aliases) @@ -770,7 +783,7 @@ struct device_node *of_find_node_by_path(const char *path) raw_spin_unlock_irqrestore(&devtree_lock, flags); return np; } -EXPORT_SYMBOL(of_find_node_by_path); +EXPORT_SYMBOL(of_find_node_opts_by_path); /** * of_find_node_by_name - Find a node by its "name" property diff --git a/drivers/of/selftest.c b/drivers/of/selftest.c index e2d79af..721b2a4 100644 --- a/drivers/of/selftest.c +++ b/drivers/of/selftest.c @@ -43,6 +43,7 @@ static bool selftest_live_tree; static void __init of_selftest_find_node_by_name(void) { struct device_node *np; + const char *options; np = of_find_node_by_path("/testcase-data"); selftest(np && !strcmp("/testcase-data", np->full_name), @@ -83,6 +84,22 @@ static void __init of_selftest_find_node_by_name(void) np = of_find_node_by_path("testcase-alias/missing-path"); selftest(!np, "non-existent alias with relative path returned node %s\n", np->full_name); of_node_put(np); + + np = of_find_node_opts_by_path("/testcase-data:testoption", &options); + selftest(np && !strcmp("testoption", options), + "option path test failed\n"); + of_node_put(np); + + np = of_find_node_opts_by_path("testcase-alias:testaliasoption", + &options); + selftest(np && !strcmp("testaliasoption", options), + "option alias path test failed\n"); + of_node_put(np); + + options = "testoption"; + np = of_find_node_opts_by_path("testcase-alias", &options); + selftest(np && !options, "option clearing test failed\n"); + of_node_put(np); } static void __init of_selftest_dynamic(void) diff --git a/include/linux/of.h b/include/linux/of.h index 29f0adc..a36be70 100644 --- a/include/linux/of.h +++ b/include/linux/of.h @@ -228,7 +228,13 @@ extern struct device_node *of_find_matching_node_and_match( const struct of_device_id *matches, const struct of_device_id **match); -extern struct device_node *of_find_node_by_path(const char *path); +extern struct device_node *of_find_node_opts_by_path(const char *path, + const char **opts); +static inline struct device_node *of_find_node_by_path(const char *path) +{ + return of_find_node_opts_by_path(path, NULL); +} + extern struct device_node *of_find_node_by_phandle(phandle handle); extern struct device_node *of_get_parent(const struct device_node *node); extern struct device_node *of_get_next_parent(struct device_node *node); @@ -385,6 +391,12 @@ static inline struct device_node *of_find_node_by_path(const char *path) return NULL; } +static inline struct device_node *of_find_node_opts_by_path(const char *path, + const char **opts) +{ + return NULL; +} + static inline struct device_node *of_get_parent(const struct device_node *node) { return NULL;