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