2005-04-17 06:20:36 +08:00
|
|
|
/*
|
|
|
|
* sysfs.h - definitions for the device driver filesystem
|
|
|
|
*
|
|
|
|
* Copyright (c) 2001,2002 Patrick Mochel
|
|
|
|
* Copyright (c) 2004 Silicon Graphics, Inc.
|
2007-09-20 16:31:38 +08:00
|
|
|
* Copyright (c) 2007 SUSE Linux Products GmbH
|
|
|
|
* Copyright (c) 2007 Tejun Heo <teheo@suse.de>
|
2005-04-17 06:20:36 +08:00
|
|
|
*
|
|
|
|
* Please see Documentation/filesystems/sysfs.txt for more information.
|
|
|
|
*/
|
|
|
|
|
|
|
|
#ifndef _SYSFS_H_
|
|
|
|
#define _SYSFS_H_
|
|
|
|
|
2006-08-15 13:43:17 +08:00
|
|
|
#include <linux/compiler.h>
|
2007-03-18 20:58:08 +08:00
|
|
|
#include <linux/errno.h>
|
2007-01-18 00:51:18 +08:00
|
|
|
#include <linux/list.h>
|
2010-02-12 07:21:53 +08:00
|
|
|
#include <linux/lockdep.h>
|
2010-08-11 22:01:02 +08:00
|
|
|
#include <linux/kobject_ns.h>
|
2011-07-27 07:09:06 +08:00
|
|
|
#include <linux/atomic.h>
|
2005-04-17 06:20:36 +08:00
|
|
|
|
|
|
|
struct kobject;
|
|
|
|
struct module;
|
2010-03-31 02:31:26 +08:00
|
|
|
enum kobj_ns_type;
|
2005-04-17 06:20:36 +08:00
|
|
|
|
|
|
|
struct attribute {
|
2007-09-20 15:05:10 +08:00
|
|
|
const char *name;
|
2011-07-24 11:10:46 +08:00
|
|
|
umode_t mode;
|
2010-02-12 07:21:53 +08:00
|
|
|
#ifdef CONFIG_DEBUG_LOCK_ALLOC
|
2012-05-15 01:30:03 +08:00
|
|
|
bool ignore_lockdep:1;
|
2010-02-12 07:21:53 +08:00
|
|
|
struct lock_class_key *key;
|
|
|
|
struct lock_class_key skey;
|
|
|
|
#endif
|
2005-04-17 06:20:36 +08:00
|
|
|
};
|
|
|
|
|
2010-02-12 20:35:32 +08:00
|
|
|
/**
|
|
|
|
* sysfs_attr_init - initialize a dynamically allocated sysfs attribute
|
|
|
|
* @attr: struct attribute to initialize
|
|
|
|
*
|
|
|
|
* Initialize a dynamically allocated struct attribute so we can
|
|
|
|
* make lockdep happy. This is a new requirement for attributes
|
|
|
|
* and initially this is only needed when lockdep is enabled.
|
|
|
|
* Lockdep gives a nice error when your attribute is added to
|
|
|
|
* sysfs if you don't have this.
|
|
|
|
*/
|
2010-02-12 07:21:53 +08:00
|
|
|
#ifdef CONFIG_DEBUG_LOCK_ALLOC
|
|
|
|
#define sysfs_attr_init(attr) \
|
|
|
|
do { \
|
|
|
|
static struct lock_class_key __key; \
|
|
|
|
\
|
|
|
|
(attr)->key = &__key; \
|
|
|
|
} while(0)
|
|
|
|
#else
|
|
|
|
#define sysfs_attr_init(attr) do {} while(0)
|
|
|
|
#endif
|
|
|
|
|
2005-04-17 06:20:36 +08:00
|
|
|
struct attribute_group {
|
2007-09-20 15:05:10 +08:00
|
|
|
const char *name;
|
2011-07-24 11:11:19 +08:00
|
|
|
umode_t (*is_visible)(struct kobject *,
|
2007-10-31 22:38:04 +08:00
|
|
|
struct attribute *, int);
|
2007-09-20 15:05:10 +08:00
|
|
|
struct attribute **attrs;
|
2005-04-17 06:20:36 +08:00
|
|
|
};
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Use these macros to make defining attributes easier. See include/linux/device.h
|
|
|
|
* for examples..
|
|
|
|
*/
|
|
|
|
|
|
|
|
#define __ATTR(_name,_mode,_show,_store) { \
|
2007-06-14 02:45:17 +08:00
|
|
|
.attr = {.name = __stringify(_name), .mode = _mode }, \
|
2005-04-17 06:20:36 +08:00
|
|
|
.show = _show, \
|
|
|
|
.store = _store, \
|
|
|
|
}
|
|
|
|
|
|
|
|
#define __ATTR_RO(_name) { \
|
2007-06-14 02:45:17 +08:00
|
|
|
.attr = { .name = __stringify(_name), .mode = 0444 }, \
|
|
|
|
.show = _name##_show, \
|
2005-04-17 06:20:36 +08:00
|
|
|
}
|
|
|
|
|
2013-07-15 07:05:51 +08:00
|
|
|
#define __ATTR_RW(_name) __ATTR(_name, 0644, _name##_show, _name##_store)
|
|
|
|
|
2005-04-17 06:20:36 +08:00
|
|
|
#define __ATTR_NULL { .attr = { .name = NULL } }
|
2012-05-15 01:30:03 +08:00
|
|
|
|
|
|
|
#ifdef CONFIG_DEBUG_LOCK_ALLOC
|
|
|
|
#define __ATTR_IGNORE_LOCKDEP(_name, _mode, _show, _store) { \
|
|
|
|
.attr = {.name = __stringify(_name), .mode = _mode, \
|
|
|
|
.ignore_lockdep = true }, \
|
|
|
|
.show = _show, \
|
|
|
|
.store = _store, \
|
|
|
|
}
|
|
|
|
#else
|
|
|
|
#define __ATTR_IGNORE_LOCKDEP __ATTR
|
|
|
|
#endif
|
2005-04-17 06:20:36 +08:00
|
|
|
|
2013-07-15 07:05:52 +08:00
|
|
|
#define ATTRIBUTE_GROUPS(name) \
|
|
|
|
static const struct attribute_group name##_group = { \
|
|
|
|
.attrs = name##_attrs, \
|
|
|
|
}; \
|
|
|
|
static const struct attribute_group *name##_groups[] = { \
|
|
|
|
&name##_group, \
|
|
|
|
NULL, \
|
|
|
|
}
|
|
|
|
|
2005-04-17 06:20:36 +08:00
|
|
|
#define attr_name(_attr) (_attr).attr.name
|
|
|
|
|
2010-05-13 09:28:57 +08:00
|
|
|
struct file;
|
2005-04-17 06:20:36 +08:00
|
|
|
struct vm_area_struct;
|
|
|
|
|
|
|
|
struct bin_attribute {
|
|
|
|
struct attribute attr;
|
|
|
|
size_t size;
|
|
|
|
void *private;
|
2010-05-13 09:28:57 +08:00
|
|
|
ssize_t (*read)(struct file *, struct kobject *, struct bin_attribute *,
|
2007-06-09 13:57:22 +08:00
|
|
|
char *, loff_t, size_t);
|
2010-05-13 09:28:57 +08:00
|
|
|
ssize_t (*write)(struct file *,struct kobject *, struct bin_attribute *,
|
2007-06-09 13:57:22 +08:00
|
|
|
char *, loff_t, size_t);
|
2010-05-13 09:28:57 +08:00
|
|
|
int (*mmap)(struct file *, struct kobject *, struct bin_attribute *attr,
|
2005-04-17 06:20:36 +08:00
|
|
|
struct vm_area_struct *vma);
|
|
|
|
};
|
|
|
|
|
2010-02-12 20:35:32 +08:00
|
|
|
/**
|
|
|
|
* sysfs_bin_attr_init - initialize a dynamically allocated bin_attribute
|
|
|
|
* @attr: struct bin_attribute to initialize
|
|
|
|
*
|
|
|
|
* Initialize a dynamically allocated struct bin_attribute so we
|
|
|
|
* can make lockdep happy. This is a new requirement for
|
|
|
|
* attributes and initially this is only needed when lockdep is
|
|
|
|
* enabled. Lockdep gives a nice error when your attribute is
|
|
|
|
* added to sysfs if you don't have this.
|
|
|
|
*/
|
2010-03-01 17:38:36 +08:00
|
|
|
#define sysfs_bin_attr_init(bin_attr) sysfs_attr_init(&(bin_attr)->attr)
|
2010-02-12 07:21:53 +08:00
|
|
|
|
2005-04-17 06:20:36 +08:00
|
|
|
struct sysfs_ops {
|
|
|
|
ssize_t (*show)(struct kobject *, struct attribute *,char *);
|
|
|
|
ssize_t (*store)(struct kobject *,struct attribute *,const char *, size_t);
|
2011-10-13 05:53:38 +08:00
|
|
|
const void *(*namespace)(struct kobject *, const struct attribute *);
|
2005-04-17 06:20:36 +08:00
|
|
|
};
|
|
|
|
|
2008-07-16 06:58:04 +08:00
|
|
|
struct sysfs_dirent;
|
|
|
|
|
2005-04-17 06:20:36 +08:00
|
|
|
#ifdef CONFIG_SYSFS
|
|
|
|
|
2007-09-20 15:05:10 +08:00
|
|
|
int sysfs_schedule_callback(struct kobject *kobj, void (*func)(void *),
|
|
|
|
void *data, struct module *owner);
|
2005-04-17 06:20:36 +08:00
|
|
|
|
2007-09-20 15:05:10 +08:00
|
|
|
int __must_check sysfs_create_dir(struct kobject *kobj);
|
|
|
|
void sysfs_remove_dir(struct kobject *kobj);
|
|
|
|
int __must_check sysfs_rename_dir(struct kobject *kobj, const char *new_name);
|
|
|
|
int __must_check sysfs_move_dir(struct kobject *kobj,
|
|
|
|
struct kobject *new_parent_kobj);
|
2005-04-19 12:57:32 +08:00
|
|
|
|
2007-09-20 15:05:10 +08:00
|
|
|
int __must_check sysfs_create_file(struct kobject *kobj,
|
|
|
|
const struct attribute *attr);
|
2010-01-05 19:48:01 +08:00
|
|
|
int __must_check sysfs_create_files(struct kobject *kobj,
|
|
|
|
const struct attribute **attr);
|
2010-07-02 22:54:05 +08:00
|
|
|
int __must_check sysfs_chmod_file(struct kobject *kobj,
|
2011-07-24 15:40:40 +08:00
|
|
|
const struct attribute *attr, umode_t mode);
|
2007-09-20 15:05:10 +08:00
|
|
|
void sysfs_remove_file(struct kobject *kobj, const struct attribute *attr);
|
2010-01-05 19:48:01 +08:00
|
|
|
void sysfs_remove_files(struct kobject *kobj, const struct attribute **attr);
|
2005-04-17 06:20:36 +08:00
|
|
|
|
2006-08-15 13:43:17 +08:00
|
|
|
int __must_check sysfs_create_bin_file(struct kobject *kobj,
|
2009-12-18 21:34:20 +08:00
|
|
|
const struct bin_attribute *attr);
|
|
|
|
void sysfs_remove_bin_file(struct kobject *kobj,
|
|
|
|
const struct bin_attribute *attr);
|
2005-04-17 06:20:36 +08:00
|
|
|
|
2007-09-20 15:05:10 +08:00
|
|
|
int __must_check sysfs_create_link(struct kobject *kobj, struct kobject *target,
|
|
|
|
const char *name);
|
2008-06-10 17:09:08 +08:00
|
|
|
int __must_check sysfs_create_link_nowarn(struct kobject *kobj,
|
|
|
|
struct kobject *target,
|
|
|
|
const char *name);
|
2007-09-20 15:05:10 +08:00
|
|
|
void sysfs_remove_link(struct kobject *kobj, const char *name);
|
|
|
|
|
2010-02-13 11:22:25 +08:00
|
|
|
int sysfs_rename_link(struct kobject *kobj, struct kobject *target,
|
|
|
|
const char *old_name, const char *new_name);
|
|
|
|
|
2010-03-31 02:31:28 +08:00
|
|
|
void sysfs_delete_link(struct kobject *dir, struct kobject *targ,
|
|
|
|
const char *name);
|
|
|
|
|
2007-09-20 15:05:10 +08:00
|
|
|
int __must_check sysfs_create_group(struct kobject *kobj,
|
|
|
|
const struct attribute_group *grp);
|
2008-03-21 09:47:52 +08:00
|
|
|
int sysfs_update_group(struct kobject *kobj,
|
|
|
|
const struct attribute_group *grp);
|
2007-09-20 15:05:10 +08:00
|
|
|
void sysfs_remove_group(struct kobject *kobj,
|
|
|
|
const struct attribute_group *grp);
|
2007-02-21 04:02:44 +08:00
|
|
|
int sysfs_add_file_to_group(struct kobject *kobj,
|
2007-09-20 15:05:10 +08:00
|
|
|
const struct attribute *attr, const char *group);
|
2007-02-21 04:02:44 +08:00
|
|
|
void sysfs_remove_file_from_group(struct kobject *kobj,
|
2007-09-20 15:05:10 +08:00
|
|
|
const struct attribute *attr, const char *group);
|
2010-09-26 05:34:22 +08:00
|
|
|
int sysfs_merge_group(struct kobject *kobj,
|
|
|
|
const struct attribute_group *grp);
|
|
|
|
void sysfs_unmerge_group(struct kobject *kobj,
|
|
|
|
const struct attribute_group *grp);
|
2013-01-26 04:51:13 +08:00
|
|
|
int sysfs_add_link_to_group(struct kobject *kobj, const char *group_name,
|
|
|
|
struct kobject *target, const char *link_name);
|
|
|
|
void sysfs_remove_link_from_group(struct kobject *kobj, const char *group_name,
|
|
|
|
const char *link_name);
|
2007-02-21 04:02:44 +08:00
|
|
|
|
2008-09-26 07:45:13 +08:00
|
|
|
void sysfs_notify(struct kobject *kobj, const char *dir, const char *attr);
|
2008-07-16 06:58:04 +08:00
|
|
|
void sysfs_notify_dirent(struct sysfs_dirent *sd);
|
|
|
|
struct sysfs_dirent *sysfs_get_dirent(struct sysfs_dirent *parent_sd,
|
2010-03-31 02:31:26 +08:00
|
|
|
const void *ns,
|
2008-07-16 06:58:04 +08:00
|
|
|
const unsigned char *name);
|
|
|
|
struct sysfs_dirent *sysfs_get(struct sysfs_dirent *sd);
|
|
|
|
void sysfs_put(struct sysfs_dirent *sd);
|
2010-03-31 02:31:26 +08:00
|
|
|
|
2008-07-16 06:58:04 +08:00
|
|
|
int __must_check sysfs_init(void);
|
2006-08-15 13:43:23 +08:00
|
|
|
|
2005-04-17 06:20:36 +08:00
|
|
|
#else /* CONFIG_SYSFS */
|
|
|
|
|
2007-03-16 03:50:34 +08:00
|
|
|
static inline int sysfs_schedule_callback(struct kobject *kobj,
|
2007-04-26 15:12:04 +08:00
|
|
|
void (*func)(void *), void *data, struct module *owner)
|
2007-03-16 03:50:34 +08:00
|
|
|
{
|
|
|
|
return -ENOSYS;
|
|
|
|
}
|
|
|
|
|
2007-09-20 15:05:10 +08:00
|
|
|
static inline int sysfs_create_dir(struct kobject *kobj)
|
2005-04-17 06:20:36 +08:00
|
|
|
{
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
|
2007-09-20 15:05:10 +08:00
|
|
|
static inline void sysfs_remove_dir(struct kobject *kobj)
|
2005-04-17 06:20:36 +08:00
|
|
|
{
|
|
|
|
}
|
|
|
|
|
2007-09-20 15:05:10 +08:00
|
|
|
static inline int sysfs_rename_dir(struct kobject *kobj, const char *new_name)
|
2005-04-17 06:20:36 +08:00
|
|
|
{
|
2008-07-04 09:05:28 +08:00
|
|
|
return 0;
|
2005-04-17 06:20:36 +08:00
|
|
|
}
|
|
|
|
|
2007-09-20 15:05:10 +08:00
|
|
|
static inline int sysfs_move_dir(struct kobject *kobj,
|
|
|
|
struct kobject *new_parent_kobj)
|
2006-11-21 00:07:51 +08:00
|
|
|
{
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
|
2007-09-20 15:05:10 +08:00
|
|
|
static inline int sysfs_create_file(struct kobject *kobj,
|
|
|
|
const struct attribute *attr)
|
2005-04-17 06:20:36 +08:00
|
|
|
{
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
|
2010-01-05 19:48:01 +08:00
|
|
|
static inline int sysfs_create_files(struct kobject *kobj,
|
|
|
|
const struct attribute **attr)
|
|
|
|
{
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
|
2007-09-20 15:05:10 +08:00
|
|
|
static inline int sysfs_chmod_file(struct kobject *kobj,
|
2011-07-24 15:40:40 +08:00
|
|
|
const struct attribute *attr, umode_t mode)
|
2005-04-19 12:57:32 +08:00
|
|
|
{
|
|
|
|
return 0;
|
|
|
|
}
|
2005-04-17 06:20:36 +08:00
|
|
|
|
2007-09-20 15:05:10 +08:00
|
|
|
static inline void sysfs_remove_file(struct kobject *kobj,
|
|
|
|
const struct attribute *attr)
|
2005-04-17 06:20:36 +08:00
|
|
|
{
|
|
|
|
}
|
|
|
|
|
2010-01-05 19:48:01 +08:00
|
|
|
static inline void sysfs_remove_files(struct kobject *kobj,
|
|
|
|
const struct attribute **attr)
|
|
|
|
{
|
|
|
|
}
|
|
|
|
|
2007-09-20 15:05:10 +08:00
|
|
|
static inline int sysfs_create_bin_file(struct kobject *kobj,
|
2009-12-18 21:34:20 +08:00
|
|
|
const struct bin_attribute *attr)
|
2005-04-17 06:20:36 +08:00
|
|
|
{
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
|
2008-02-20 09:39:02 +08:00
|
|
|
static inline void sysfs_remove_bin_file(struct kobject *kobj,
|
2009-12-18 21:34:20 +08:00
|
|
|
const struct bin_attribute *attr)
|
2005-04-17 06:20:36 +08:00
|
|
|
{
|
|
|
|
}
|
|
|
|
|
2007-09-20 15:05:10 +08:00
|
|
|
static inline int sysfs_create_link(struct kobject *kobj,
|
|
|
|
struct kobject *target, const char *name)
|
2005-04-17 06:20:36 +08:00
|
|
|
{
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
|
2008-06-10 17:09:08 +08:00
|
|
|
static inline int sysfs_create_link_nowarn(struct kobject *kobj,
|
|
|
|
struct kobject *target,
|
|
|
|
const char *name)
|
|
|
|
{
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
|
2007-09-20 15:05:10 +08:00
|
|
|
static inline void sysfs_remove_link(struct kobject *kobj, const char *name)
|
2005-04-17 06:20:36 +08:00
|
|
|
{
|
|
|
|
}
|
|
|
|
|
2010-02-13 11:22:25 +08:00
|
|
|
static inline int sysfs_rename_link(struct kobject *k, struct kobject *t,
|
|
|
|
const char *old_name, const char *new_name)
|
|
|
|
{
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
|
2010-03-31 02:31:28 +08:00
|
|
|
static inline void sysfs_delete_link(struct kobject *k, struct kobject *t,
|
|
|
|
const char *name)
|
|
|
|
{
|
|
|
|
}
|
|
|
|
|
2007-09-20 15:05:10 +08:00
|
|
|
static inline int sysfs_create_group(struct kobject *kobj,
|
|
|
|
const struct attribute_group *grp)
|
2005-04-17 06:20:36 +08:00
|
|
|
{
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
|
2008-05-01 00:01:17 +08:00
|
|
|
static inline int sysfs_update_group(struct kobject *kobj,
|
|
|
|
const struct attribute_group *grp)
|
|
|
|
{
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
|
2007-09-20 15:05:10 +08:00
|
|
|
static inline void sysfs_remove_group(struct kobject *kobj,
|
|
|
|
const struct attribute_group *grp)
|
2005-04-17 06:20:36 +08:00
|
|
|
{
|
|
|
|
}
|
|
|
|
|
2007-02-21 04:02:44 +08:00
|
|
|
static inline int sysfs_add_file_to_group(struct kobject *kobj,
|
|
|
|
const struct attribute *attr, const char *group)
|
|
|
|
{
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
|
|
|
|
static inline void sysfs_remove_file_from_group(struct kobject *kobj,
|
2007-03-01 20:40:21 +08:00
|
|
|
const struct attribute *attr, const char *group)
|
2007-02-21 04:02:44 +08:00
|
|
|
{
|
|
|
|
}
|
|
|
|
|
2010-09-26 05:34:22 +08:00
|
|
|
static inline int sysfs_merge_group(struct kobject *kobj,
|
|
|
|
const struct attribute_group *grp)
|
|
|
|
{
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
|
|
|
|
static inline void sysfs_unmerge_group(struct kobject *kobj,
|
|
|
|
const struct attribute_group *grp)
|
|
|
|
{
|
|
|
|
}
|
|
|
|
|
2013-01-26 04:51:13 +08:00
|
|
|
static inline int sysfs_add_link_to_group(struct kobject *kobj,
|
|
|
|
const char *group_name, struct kobject *target,
|
|
|
|
const char *link_name)
|
|
|
|
{
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
|
|
|
|
static inline void sysfs_remove_link_from_group(struct kobject *kobj,
|
|
|
|
const char *group_name, const char *link_name)
|
|
|
|
{
|
|
|
|
}
|
|
|
|
|
2008-09-26 07:45:13 +08:00
|
|
|
static inline void sysfs_notify(struct kobject *kobj, const char *dir,
|
|
|
|
const char *attr)
|
2006-03-20 14:53:53 +08:00
|
|
|
{
|
|
|
|
}
|
2008-07-16 06:58:04 +08:00
|
|
|
static inline void sysfs_notify_dirent(struct sysfs_dirent *sd)
|
|
|
|
{
|
|
|
|
}
|
|
|
|
static inline
|
|
|
|
struct sysfs_dirent *sysfs_get_dirent(struct sysfs_dirent *parent_sd,
|
2010-03-31 02:31:26 +08:00
|
|
|
const void *ns,
|
2008-07-16 06:58:04 +08:00
|
|
|
const unsigned char *name)
|
|
|
|
{
|
|
|
|
return NULL;
|
|
|
|
}
|
|
|
|
static inline struct sysfs_dirent *sysfs_get(struct sysfs_dirent *sd)
|
|
|
|
{
|
|
|
|
return NULL;
|
|
|
|
}
|
|
|
|
static inline void sysfs_put(struct sysfs_dirent *sd)
|
|
|
|
{
|
|
|
|
}
|
2006-03-20 14:53:53 +08:00
|
|
|
|
2006-08-15 13:43:23 +08:00
|
|
|
static inline int __must_check sysfs_init(void)
|
|
|
|
{
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
|
2005-04-17 06:20:36 +08:00
|
|
|
#endif /* CONFIG_SYSFS */
|
|
|
|
|
|
|
|
#endif /* _SYSFS_H_ */
|