[GitHub/mt8127/android_kernel_alcatel_ttab.git] / include / target / configfs_macros.h

/* -*- mode: c; c-basic-offset: 8; -*-
 * vim: noexpandtab sw=8 ts=8 sts=0:
 *
 * configfs_macros.h - extends macros for configfs
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public
 * License as published by the Free Software Foundation; either
 * version 2 of the License, or (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * General Public License for more details.
 *
 * You should have received a copy of the GNU General Public
 * License along with this program; if not, write to the
 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 * Boston, MA 021110-1307, USA.
 *
 * Based on sysfs:
 * 	sysfs is Copyright (C) 2001, 2002, 2003 Patrick Mochel
 *
 * Based on kobject.h:
 *      Copyright (c) 2002-2003	Patrick Mochel
 *      Copyright (c) 2002-2003	Open Source Development Labs
 *
 * configfs Copyright (C) 2005 Oracle.  All rights reserved.
 *
 * Added CONFIGFS_EATTR() macros from original configfs.h macros
 * Copright (C) 2008-2009 Nicholas A. Bellinger <nab@linux-iscsi.org>
 *
 * Please read Documentation/filesystems/configfs/configfs.txt before using
 * the configfs interface, ESPECIALLY the parts about reference counts and
 * item destructors.
 */

#ifndef _CONFIGFS_MACROS_H_
#define _CONFIGFS_MACROS_H_

#include <linux/configfs.h>

/*
 * Users often need to create attribute structures for their configurable
 * attributes, containing a configfs_attribute member and function pointers
 * for the show() and store() operations on that attribute. If they don't
 * need anything else on the extended attribute structure, they can use
 * this macro to define it.  The argument _name isends up as
 * 'struct _name_attribute, as well as names of to CONFIGFS_ATTR_OPS() below.
 * The argument _item is the name of the structure containing the
 * struct config_item or struct config_group structure members
 */
#define CONFIGFS_EATTR_STRUCT(_name, _item)				\
struct _name##_attribute {						\
	struct configfs_attribute attr;					\
	ssize_t (*show)(struct _item *, char *);			\
	ssize_t (*store)(struct _item *, const char *, size_t);		\
}

/*
 * With the extended attribute structure, users can use this macro
 * (similar to sysfs' __ATTR) to make defining attributes easier.
 * An example:
 * #define MYITEM_EATTR(_name, _mode, _show, _store)	\
 * struct myitem_attribute childless_attr_##_name =	\
 *         __CONFIGFS_EATTR(_name, _mode, _show, _store)
 */
#define __CONFIGFS_EATTR(_name, _mode, _show, _store)			\
{									\
	.attr	= {							\
			.ca_name = __stringify(_name),			\
			.ca_mode = _mode,				\
			.ca_owner = THIS_MODULE,			\
	},								\
	.show	= _show,						\
	.store	= _store,						\
}
/* Here is a readonly version, only requiring a show() operation */
#define __CONFIGFS_EATTR_RO(_name, _show)				\
{									\
	.attr	= {							\
			.ca_name = __stringify(_name),			\
			.ca_mode = 0444,				\
			.ca_owner = THIS_MODULE,			\
	},								\
	.show	= _show,						\
}

/*
 * With these extended attributes, the simple show_attribute() and
 * store_attribute() operations need to call the show() and store() of the
 * attributes.  This is a common pattern, so we provide a macro to define
 * them.  The argument _name is the name of the attribute defined by
 * CONFIGFS_ATTR_STRUCT(). The argument _item is the name of the structure
 * containing the struct config_item or struct config_group structure member.
 * The argument _item_member is the actual name of the struct config_* struct
 * in your _item structure.  Meaning  my_structure->some_config_group.
 *		                      ^^_item^^^^^  ^^_item_member^^^
 * This macro expects the attributes to be named "struct <name>_attribute".
 */
#define CONFIGFS_EATTR_OPS_TO_FUNC(_name, _item, _item_member)		\
static struct _item *to_##_name(struct config_item *ci)			\
{									\
	return (ci) ? container_of(to_config_group(ci), struct _item,	\
		_item_member) : NULL;					\
}

#define CONFIGFS_EATTR_OPS_SHOW(_name, _item)				\
static ssize_t _name##_attr_show(struct config_item *item,		\
				 struct configfs_attribute *attr,	\
				 char *page)				\
{									\
	struct _item *_item = to_##_name(item);				\
	struct _name##_attribute * _name##_attr =			\
		container_of(attr, struct _name##_attribute, attr);	\
	ssize_t ret = 0;						\
									\
	if (_name##_attr->show)						\
		ret = _name##_attr->show(_item, page);			\
	return ret;							\
}

#define CONFIGFS_EATTR_OPS_STORE(_name, _item)				\
static ssize_t _name##_attr_store(struct config_item *item,		\
				  struct configfs_attribute *attr,	\
				  const char *page, size_t count)	\
{									\
	struct _item *_item = to_##_name(item);				\
	struct _name##_attribute * _name##_attr =			\
		container_of(attr, struct _name##_attribute, attr);	\
	ssize_t ret = -EINVAL;						\
									\
	if (_name##_attr->store)					\
		ret = _name##_attr->store(_item, page, count);		\
	return ret;							\
}

#define CONFIGFS_EATTR_OPS(_name, _item, _item_member)			\
	CONFIGFS_EATTR_OPS_TO_FUNC(_name, _item, _item_member);		\
	CONFIGFS_EATTR_OPS_SHOW(_name, _item);				\
	CONFIGFS_EATTR_OPS_STORE(_name, _item);

#define CONFIGFS_EATTR_OPS_RO(_name, _item, _item_member)		\
	CONFIGFS_EATTR_OPS_TO_FUNC(_name, _item, _item_member);		\
	CONFIGFS_EATTR_OPS_SHOW(_name, _item);

#endif /* _CONFIGFS_MACROS_H_ */
Commit	Line	Data
c66ac9db NB	1	/* -- mode: c; c-basic-offset: 8; --
	2	* vim: noexpandtab sw=8 ts=8 sts=0:
	3	*
	4	* configfs_macros.h - extends macros for configfs
	5	*
	6	* This program is free software; you can redistribute it and/or
	7	* modify it under the terms of the GNU General Public
	8	* License as published by the Free Software Foundation; either
	9	* version 2 of the License, or (at your option) any later version.
	10	*
	11	* This program is distributed in the hope that it will be useful,
	12	* but WITHOUT ANY WARRANTY; without even the implied warranty of
	13	* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
	14	* General Public License for more details.
	15	*
	16	* You should have received a copy of the GNU General Public
	17	* License along with this program; if not, write to the
	18	* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
	19	* Boston, MA 021110-1307, USA.
	20	*
	21	* Based on sysfs:
	22	* sysfs is Copyright (C) 2001, 2002, 2003 Patrick Mochel
	23	*
	24	* Based on kobject.h:
	25	* Copyright (c) 2002-2003 Patrick Mochel
	26	* Copyright (c) 2002-2003 Open Source Development Labs
	27	*
	28	* configfs Copyright (C) 2005 Oracle. All rights reserved.
	29	*
	30	* Added CONFIGFS_EATTR() macros from original configfs.h macros
	31	* Copright (C) 2008-2009 Nicholas A. Bellinger <nab@linux-iscsi.org>
	32	*
395cf969 PB	33	* Please read Documentation/filesystems/configfs/configfs.txt before using
395cf969 PB	34	* the configfs interface, ESPECIALLY the parts about reference counts and
c66ac9db NB	35	* item destructors.
	36	*/
	37
	38	#ifndef _CONFIGFS_MACROS_H_
	39	#define _CONFIGFS_MACROS_H_
	40
	41	#include <linux/configfs.h>
	42
	43	/*
	44	* Users often need to create attribute structures for their configurable
	45	* attributes, containing a configfs_attribute member and function pointers
	46	* for the show() and store() operations on that attribute. If they don't
	47	* need anything else on the extended attribute structure, they can use
	48	* this macro to define it. The argument _name isends up as
	49	* 'struct _name_attribute, as well as names of to CONFIGFS_ATTR_OPS() below.
	50	* The argument _item is the name of the structure containing the
	51	* struct config_item or struct config_group structure members
	52	*/
	53	#define CONFIGFS_EATTR_STRUCT(_name, _item) \
	54	struct _name##_attribute { \
	55	struct configfs_attribute attr; \
	56	ssize_t (show)(struct _item , char *); \
	57	ssize_t (store)(struct _item , const char *, size_t); \
	58	}
	59
	60	/*
	61	* With the extended attribute structure, users can use this macro
	62	* (similar to sysfs' __ATTR) to make defining attributes easier.
	63	* An example:
	64	* #define MYITEM_EATTR(_name, _mode, _show, _store) \
	65	* struct myitem_attribute childless_attr_##_name = \
	66	* __CONFIGFS_EATTR(_name, _mode, _show, _store)
	67	*/
	68	#define __CONFIGFS_EATTR(_name, _mode, _show, _store) \
	69	{ \
	70	.attr = { \
	71	.ca_name = __stringify(_name), \
	72	.ca_mode = _mode, \
	73	.ca_owner = THIS_MODULE, \
	74	}, \
	75	.show = _show, \
	76	.store = _store, \
	77	}
	78	/* Here is a readonly version, only requiring a show() operation */
	79	#define __CONFIGFS_EATTR_RO(_name, _show) \
	80	{ \
	81	.attr = { \
	82	.ca_name = __stringify(_name), \
	83	.ca_mode = 0444, \
	84	.ca_owner = THIS_MODULE, \
	85	}, \
	86	.show = _show, \
	87	}
	88
	89	/*
	90	* With these extended attributes, the simple show_attribute() and
	91	* store_attribute() operations need to call the show() and store() of the
	92	* attributes. This is a common pattern, so we provide a macro to define
	93	* them. The argument _name is the name of the attribute defined by
	94	* CONFIGFS_ATTR_STRUCT(). The argument _item is the name of the structure
	95	* containing the struct config_item or struct config_group structure member.
	96	* The argument _item_member is the actual name of the struct config_* struct
	97	* in your _item structure. Meaning my_structure->some_config_group.
	98	* ^^_item^^^^^ ^^_item_member^^^
99	* This macro expects the attributes to be named "struct <name>_attribute".
100	*/
101	#define CONFIGFS_EATTR_OPS_TO_FUNC(_name, _item, _item_member) \
102	static struct _item to_##_name(struct config_item ci) \
103	{ \
104	return (ci) ? container_of(to_config_group(ci), struct _item, \
105	_item_member) : NULL; \
106	}
107
108	#define CONFIGFS_EATTR_OPS_SHOW(_name, _item) \
109	static ssize_t _name##_attr_show(struct config_item *item, \
110	struct configfs_attribute *attr, \
111	char *page) \
112	{ \
113	struct _item *_item = to_##_name(item); \
114	struct _name##_attribute * _name##_attr = \
115	container_of(attr, struct _name##_attribute, attr); \
116	ssize_t ret = 0; \
117	\
118	if (_name##_attr->show) \
119	ret = _name##_attr->show(_item, page); \
120	return ret; \
121	}
122
123	#define CONFIGFS_EATTR_OPS_STORE(_name, _item) \
124	static ssize_t _name##_attr_store(struct config_item *item, \
125	struct configfs_attribute *attr, \
126	const char *page, size_t count) \
127	{ \
128	struct _item *_item = to_##_name(item); \
129	struct _name##_attribute * _name##_attr = \
130	container_of(attr, struct _name##_attribute, attr); \
131	ssize_t ret = -EINVAL; \
132	\
133	if (_name##_attr->store) \
134	ret = _name##_attr->store(_item, page, count); \
135	return ret; \
136	}
137
138	#define CONFIGFS_EATTR_OPS(_name, _item, _item_member) \
139	CONFIGFS_EATTR_OPS_TO_FUNC(_name, _item, _item_member); \
140	CONFIGFS_EATTR_OPS_SHOW(_name, _item); \
141	CONFIGFS_EATTR_OPS_STORE(_name, _item);
142
143	#define CONFIGFS_EATTR_OPS_RO(_name, _item, _item_member) \
144	CONFIGFS_EATTR_OPS_TO_FUNC(_name, _item, _item_member); \
145	CONFIGFS_EATTR_OPS_SHOW(_name, _item);
146
147	#endif /* _CONFIGFS_MACROS_H_ */