blob: e0846cccb1e5c8dd80cfe78f1198c8019a45cdc8 [file] [log] [blame]
Tom Rini83d290c2018-05-06 17:58:06 -04001/* SPDX-License-Identifier: GPL-2.0+ */
Joe Hershberger170ab112012-12-11 22:16:24 -06002/*
3 * (C) Copyright 2012
4 * Joe Hershberger, National Instruments, joe.hershberger@ni.com
Joe Hershberger170ab112012-12-11 22:16:24 -06005 */
6
7#ifndef __ENV_ATTR_H__
8#define __ENV_ATTR_H__
9
10#define ENV_ATTR_LIST_DELIM ','
11#define ENV_ATTR_SEP ':'
12
13/*
14 * env_attr_walk takes as input an "attr_list" that takes the form:
15 * attributes = [^,:\s]*
16 * entry = name[:attributes]
17 * list = entry[,list]
Joe Hershbergercca98fd2015-05-20 14:27:19 -050018 * It will call the "callback" function with the "name" and "attributes"
Joe Hershberger170ab112012-12-11 22:16:24 -060019 * The callback may return a non-0 to abort the list walk.
20 * This return value will be passed through to the caller.
21 * 0 is returned on success.
22 */
Joe Hershbergercca98fd2015-05-20 14:27:19 -050023int env_attr_walk(const char *attr_list,
24 int (*callback)(const char *name, const char *attributes, void *priv),
25 void *priv);
Joe Hershberger170ab112012-12-11 22:16:24 -060026
27/*
28 * env_attr_lookup takes as input an "attr_list" with the same form as above.
29 * It also takes as input a "name" to look for.
30 * If the name is found in the list, it's value is copied into "attributes".
31 * There is no protection on attributes being too small for the value.
32 * It returns -1 if attributes is NULL, 1 if "name" is not found, 2 if
33 * "attr_list" is NULL.
34 * Returns 0 on success.
35 */
Joe Hershbergercca98fd2015-05-20 14:27:19 -050036int env_attr_lookup(const char *attr_list, const char *name, char *attributes);
Joe Hershberger170ab112012-12-11 22:16:24 -060037
38#endif /* __ENV_ATTR_H__ */