1170ab110SJoe Hershberger /* 2170ab110SJoe Hershberger * (C) Copyright 2012 3170ab110SJoe Hershberger * Joe Hershberger, National Instruments, joe.hershberger@ni.com 4170ab110SJoe Hershberger * 51a459660SWolfgang Denk * SPDX-License-Identifier: GPL-2.0+ 6170ab110SJoe Hershberger */ 7170ab110SJoe Hershberger 8170ab110SJoe Hershberger #ifndef __ENV_ATTR_H__ 9170ab110SJoe Hershberger #define __ENV_ATTR_H__ 10170ab110SJoe Hershberger 11170ab110SJoe Hershberger #define ENV_ATTR_LIST_DELIM ',' 12170ab110SJoe Hershberger #define ENV_ATTR_SEP ':' 13170ab110SJoe Hershberger 14170ab110SJoe Hershberger /* 15170ab110SJoe Hershberger * env_attr_walk takes as input an "attr_list" that takes the form: 16170ab110SJoe Hershberger * attributes = [^,:\s]* 17170ab110SJoe Hershberger * entry = name[:attributes] 18170ab110SJoe Hershberger * list = entry[,list] 19*cca98fd6SJoe Hershberger * It will call the "callback" function with the "name" and "attributes" 20170ab110SJoe Hershberger * The callback may return a non-0 to abort the list walk. 21170ab110SJoe Hershberger * This return value will be passed through to the caller. 22170ab110SJoe Hershberger * 0 is returned on success. 23170ab110SJoe Hershberger */ 24*cca98fd6SJoe Hershberger int env_attr_walk(const char *attr_list, 25*cca98fd6SJoe Hershberger int (*callback)(const char *name, const char *attributes, void *priv), 26*cca98fd6SJoe Hershberger void *priv); 27170ab110SJoe Hershberger 28170ab110SJoe Hershberger /* 29170ab110SJoe Hershberger * env_attr_lookup takes as input an "attr_list" with the same form as above. 30170ab110SJoe Hershberger * It also takes as input a "name" to look for. 31170ab110SJoe Hershberger * If the name is found in the list, it's value is copied into "attributes". 32170ab110SJoe Hershberger * There is no protection on attributes being too small for the value. 33170ab110SJoe Hershberger * It returns -1 if attributes is NULL, 1 if "name" is not found, 2 if 34170ab110SJoe Hershberger * "attr_list" is NULL. 35170ab110SJoe Hershberger * Returns 0 on success. 36170ab110SJoe Hershberger */ 37*cca98fd6SJoe Hershberger int env_attr_lookup(const char *attr_list, const char *name, char *attributes); 38170ab110SJoe Hershberger 39170ab110SJoe Hershberger #endif /* __ENV_ATTR_H__ */ 40