2005-04-16 16:20:36 -06:00
|
|
|
/*
|
|
|
|
* sysfs.h - definitions for the device driver filesystem
|
|
|
|
*
|
|
|
|
* Copyright (c) 2001,2002 Patrick Mochel
|
|
|
|
* Copyright (c) 2004 Silicon Graphics, Inc.
|
2007-09-20 02:31:38 -06:00
|
|
|
* Copyright (c) 2007 SUSE Linux Products GmbH
|
|
|
|
* Copyright (c) 2007 Tejun Heo <teheo@suse.de>
|
2005-04-16 16:20:36 -06:00
|
|
|
*
|
|
|
|
* Please see Documentation/filesystems/sysfs.txt for more information.
|
|
|
|
*/
|
|
|
|
|
|
|
|
#ifndef _SYSFS_H_
|
|
|
|
#define _SYSFS_H_
|
|
|
|
|
2006-08-14 23:43:17 -06:00
|
|
|
#include <linux/compiler.h>
|
2007-03-18 06:58:08 -06:00
|
|
|
#include <linux/errno.h>
|
2007-01-17 09:51:18 -07:00
|
|
|
#include <linux/list.h>
|
2010-02-11 16:21:53 -07:00
|
|
|
#include <linux/lockdep.h>
|
2005-04-16 16:20:36 -06:00
|
|
|
#include <asm/atomic.h>
|
|
|
|
|
|
|
|
struct kobject;
|
|
|
|
struct module;
|
2010-03-30 12:31:26 -06:00
|
|
|
enum kobj_ns_type;
|
2005-04-16 16:20:36 -06:00
|
|
|
|
2007-06-13 12:45:17 -06:00
|
|
|
/* FIXME
|
2008-10-18 21:28:50 -06:00
|
|
|
* The *owner field is no longer used.
|
|
|
|
* x86 tree has been cleaned up. The owner
|
|
|
|
* attribute is still left for other arches.
|
2007-06-13 12:45:17 -06:00
|
|
|
*/
|
2005-04-16 16:20:36 -06:00
|
|
|
struct attribute {
|
2007-09-20 01:05:10 -06:00
|
|
|
const char *name;
|
|
|
|
struct module *owner;
|
2005-04-16 16:20:36 -06:00
|
|
|
mode_t mode;
|
2010-02-11 16:21:53 -07:00
|
|
|
#ifdef CONFIG_DEBUG_LOCK_ALLOC
|
|
|
|
struct lock_class_key *key;
|
|
|
|
struct lock_class_key skey;
|
|
|
|
#endif
|
2005-04-16 16:20:36 -06:00
|
|
|
};
|
|
|
|
|
2010-02-12 05:35:32 -07: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-11 16:21:53 -07: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-16 16:20:36 -06:00
|
|
|
struct attribute_group {
|
2007-09-20 01:05:10 -06:00
|
|
|
const char *name;
|
2008-03-20 19:47:52 -06:00
|
|
|
mode_t (*is_visible)(struct kobject *,
|
2007-10-31 08:38:04 -06:00
|
|
|
struct attribute *, int);
|
2007-09-20 01:05:10 -06:00
|
|
|
struct attribute **attrs;
|
2005-04-16 16:20:36 -06:00
|
|
|
};
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Use these macros to make defining attributes easier. See include/linux/device.h
|
|
|
|
* for examples..
|
|
|
|
*/
|
|
|
|
|
|
|
|
#define __ATTR(_name,_mode,_show,_store) { \
|
2007-06-13 12:45:17 -06:00
|
|
|
.attr = {.name = __stringify(_name), .mode = _mode }, \
|
2005-04-16 16:20:36 -06:00
|
|
|
.show = _show, \
|
|
|
|
.store = _store, \
|
|
|
|
}
|
|
|
|
|
|
|
|
#define __ATTR_RO(_name) { \
|
2007-06-13 12:45:17 -06:00
|
|
|
.attr = { .name = __stringify(_name), .mode = 0444 }, \
|
|
|
|
.show = _name##_show, \
|
2005-04-16 16:20:36 -06:00
|
|
|
}
|
|
|
|
|
|
|
|
#define __ATTR_NULL { .attr = { .name = NULL } }
|
|
|
|
|
|
|
|
#define attr_name(_attr) (_attr).attr.name
|
|
|
|
|
|
|
|
struct vm_area_struct;
|
|
|
|
|
|
|
|
struct bin_attribute {
|
|
|
|
struct attribute attr;
|
|
|
|
size_t size;
|
|
|
|
void *private;
|
2007-06-08 23:57:22 -06:00
|
|
|
ssize_t (*read)(struct kobject *, struct bin_attribute *,
|
|
|
|
char *, loff_t, size_t);
|
|
|
|
ssize_t (*write)(struct kobject *, struct bin_attribute *,
|
|
|
|
char *, loff_t, size_t);
|
2005-04-16 16:20:36 -06:00
|
|
|
int (*mmap)(struct kobject *, struct bin_attribute *attr,
|
|
|
|
struct vm_area_struct *vma);
|
|
|
|
};
|
|
|
|
|
2010-02-12 05:35:32 -07: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 02:38:36 -07:00
|
|
|
#define sysfs_bin_attr_init(bin_attr) sysfs_attr_init(&(bin_attr)->attr)
|
2010-02-11 16:21:53 -07:00
|
|
|
|
2005-04-16 16:20:36 -06:00
|
|
|
struct sysfs_ops {
|
|
|
|
ssize_t (*show)(struct kobject *, struct attribute *,char *);
|
|
|
|
ssize_t (*store)(struct kobject *,struct attribute *,const char *, size_t);
|
|
|
|
};
|
|
|
|
|
2008-07-15 16:58:04 -06:00
|
|
|
struct sysfs_dirent;
|
|
|
|
|
2005-04-16 16:20:36 -06:00
|
|
|
#ifdef CONFIG_SYSFS
|
|
|
|
|
2007-09-20 01:05:10 -06:00
|
|
|
int sysfs_schedule_callback(struct kobject *kobj, void (*func)(void *),
|
|
|
|
void *data, struct module *owner);
|
2005-04-16 16:20:36 -06:00
|
|
|
|
2007-09-20 01:05:10 -06: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-18 22:57:32 -06:00
|
|
|
|
2007-09-20 01:05:10 -06:00
|
|
|
int __must_check sysfs_create_file(struct kobject *kobj,
|
|
|
|
const struct attribute *attr);
|
2010-01-05 04:48:01 -07:00
|
|
|
int __must_check sysfs_create_files(struct kobject *kobj,
|
|
|
|
const struct attribute **attr);
|
2007-09-20 01:05:10 -06:00
|
|
|
int __must_check sysfs_chmod_file(struct kobject *kobj, struct attribute *attr,
|
|
|
|
mode_t mode);
|
|
|
|
void sysfs_remove_file(struct kobject *kobj, const struct attribute *attr);
|
2010-01-05 04:48:01 -07:00
|
|
|
void sysfs_remove_files(struct kobject *kobj, const struct attribute **attr);
|
2005-04-16 16:20:36 -06:00
|
|
|
|
2006-08-14 23:43:17 -06:00
|
|
|
int __must_check sysfs_create_bin_file(struct kobject *kobj,
|
2009-12-18 06:34:20 -07:00
|
|
|
const struct bin_attribute *attr);
|
|
|
|
void sysfs_remove_bin_file(struct kobject *kobj,
|
|
|
|
const struct bin_attribute *attr);
|
2005-04-16 16:20:36 -06:00
|
|
|
|
2007-09-20 01:05:10 -06:00
|
|
|
int __must_check sysfs_create_link(struct kobject *kobj, struct kobject *target,
|
|
|
|
const char *name);
|
2008-06-10 03:09:08 -06:00
|
|
|
int __must_check sysfs_create_link_nowarn(struct kobject *kobj,
|
|
|
|
struct kobject *target,
|
|
|
|
const char *name);
|
2007-09-20 01:05:10 -06:00
|
|
|
void sysfs_remove_link(struct kobject *kobj, const char *name);
|
|
|
|
|
2010-02-12 20:22:25 -07:00
|
|
|
int sysfs_rename_link(struct kobject *kobj, struct kobject *target,
|
|
|
|
const char *old_name, const char *new_name);
|
|
|
|
|
2010-03-30 12:31:28 -06:00
|
|
|
void sysfs_delete_link(struct kobject *dir, struct kobject *targ,
|
|
|
|
const char *name);
|
|
|
|
|
2007-09-20 01:05:10 -06:00
|
|
|
int __must_check sysfs_create_group(struct kobject *kobj,
|
|
|
|
const struct attribute_group *grp);
|
2008-03-20 19:47:52 -06:00
|
|
|
int sysfs_update_group(struct kobject *kobj,
|
|
|
|
const struct attribute_group *grp);
|
2007-09-20 01:05:10 -06:00
|
|
|
void sysfs_remove_group(struct kobject *kobj,
|
|
|
|
const struct attribute_group *grp);
|
2007-02-20 13:02:44 -07:00
|
|
|
int sysfs_add_file_to_group(struct kobject *kobj,
|
2007-09-20 01:05:10 -06:00
|
|
|
const struct attribute *attr, const char *group);
|
2007-02-20 13:02:44 -07:00
|
|
|
void sysfs_remove_file_from_group(struct kobject *kobj,
|
2007-09-20 01:05:10 -06:00
|
|
|
const struct attribute *attr, const char *group);
|
2007-02-20 13:02:44 -07:00
|
|
|
|
2008-09-25 17:45:13 -06:00
|
|
|
void sysfs_notify(struct kobject *kobj, const char *dir, const char *attr);
|
2008-07-15 16:58:04 -06:00
|
|
|
void sysfs_notify_dirent(struct sysfs_dirent *sd);
|
|
|
|
struct sysfs_dirent *sysfs_get_dirent(struct sysfs_dirent *parent_sd,
|
2010-03-30 12:31:26 -06:00
|
|
|
const void *ns,
|
2008-07-15 16:58:04 -06:00
|
|
|
const unsigned char *name);
|
|
|
|
struct sysfs_dirent *sysfs_get(struct sysfs_dirent *sd);
|
|
|
|
void sysfs_put(struct sysfs_dirent *sd);
|
2007-08-24 17:11:54 -06:00
|
|
|
void sysfs_printk_last_file(void);
|
2010-03-30 12:31:26 -06:00
|
|
|
|
|
|
|
void sysfs_exit_ns(enum kobj_ns_type type, const void *tag);
|
|
|
|
|
2008-07-15 16:58:04 -06:00
|
|
|
int __must_check sysfs_init(void);
|
2006-08-14 23:43:23 -06:00
|
|
|
|
2005-04-16 16:20:36 -06:00
|
|
|
#else /* CONFIG_SYSFS */
|
|
|
|
|
2007-03-15 13:50:34 -06:00
|
|
|
static inline int sysfs_schedule_callback(struct kobject *kobj,
|
2007-04-26 01:12:04 -06:00
|
|
|
void (*func)(void *), void *data, struct module *owner)
|
2007-03-15 13:50:34 -06:00
|
|
|
{
|
|
|
|
return -ENOSYS;
|
|
|
|
}
|
|
|
|
|
2007-09-20 01:05:10 -06:00
|
|
|
static inline int sysfs_create_dir(struct kobject *kobj)
|
2005-04-16 16:20:36 -06:00
|
|
|
{
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
|
2007-09-20 01:05:10 -06:00
|
|
|
static inline void sysfs_remove_dir(struct kobject *kobj)
|
2005-04-16 16:20:36 -06:00
|
|
|
{
|
|
|
|
}
|
|
|
|
|
2007-09-20 01:05:10 -06:00
|
|
|
static inline int sysfs_rename_dir(struct kobject *kobj, const char *new_name)
|
2005-04-16 16:20:36 -06:00
|
|
|
{
|
2008-07-03 19:05:28 -06:00
|
|
|
return 0;
|
2005-04-16 16:20:36 -06:00
|
|
|
}
|
|
|
|
|
2007-09-20 01:05:10 -06:00
|
|
|
static inline int sysfs_move_dir(struct kobject *kobj,
|
|
|
|
struct kobject *new_parent_kobj)
|
2006-11-20 09:07:51 -07:00
|
|
|
{
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
|
2007-09-20 01:05:10 -06:00
|
|
|
static inline int sysfs_create_file(struct kobject *kobj,
|
|
|
|
const struct attribute *attr)
|
2005-04-16 16:20:36 -06:00
|
|
|
{
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
|
2010-01-05 04:48:01 -07:00
|
|
|
static inline int sysfs_create_files(struct kobject *kobj,
|
|
|
|
const struct attribute **attr)
|
|
|
|
{
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
|
2007-09-20 01:05:10 -06:00
|
|
|
static inline int sysfs_chmod_file(struct kobject *kobj,
|
|
|
|
struct attribute *attr, mode_t mode)
|
2005-04-18 22:57:32 -06:00
|
|
|
{
|
|
|
|
return 0;
|
|
|
|
}
|
2005-04-16 16:20:36 -06:00
|
|
|
|
2007-09-20 01:05:10 -06:00
|
|
|
static inline void sysfs_remove_file(struct kobject *kobj,
|
|
|
|
const struct attribute *attr)
|
2005-04-16 16:20:36 -06:00
|
|
|
{
|
|
|
|
}
|
|
|
|
|
2010-01-05 04:48:01 -07:00
|
|
|
static inline void sysfs_remove_files(struct kobject *kobj,
|
|
|
|
const struct attribute **attr)
|
|
|
|
{
|
|
|
|
}
|
|
|
|
|
2007-09-20 01:05:10 -06:00
|
|
|
static inline int sysfs_create_bin_file(struct kobject *kobj,
|
2009-12-18 06:34:20 -07:00
|
|
|
const struct bin_attribute *attr)
|
2005-04-16 16:20:36 -06:00
|
|
|
{
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
|
2008-02-19 18:39:02 -07:00
|
|
|
static inline void sysfs_remove_bin_file(struct kobject *kobj,
|
2009-12-18 06:34:20 -07:00
|
|
|
const struct bin_attribute *attr)
|
2005-04-16 16:20:36 -06:00
|
|
|
{
|
|
|
|
}
|
|
|
|
|
2007-09-20 01:05:10 -06:00
|
|
|
static inline int sysfs_create_link(struct kobject *kobj,
|
|
|
|
struct kobject *target, const char *name)
|
2005-04-16 16:20:36 -06:00
|
|
|
{
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
|
2008-06-10 03:09:08 -06:00
|
|
|
static inline int sysfs_create_link_nowarn(struct kobject *kobj,
|
|
|
|
struct kobject *target,
|
|
|
|
const char *name)
|
|
|
|
{
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
|
2007-09-20 01:05:10 -06:00
|
|
|
static inline void sysfs_remove_link(struct kobject *kobj, const char *name)
|
2005-04-16 16:20:36 -06:00
|
|
|
{
|
|
|
|
}
|
|
|
|
|
2010-02-12 20:22:25 -07: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-30 12:31:28 -06:00
|
|
|
static inline void sysfs_delete_link(struct kobject *k, struct kobject *t,
|
|
|
|
const char *name)
|
|
|
|
{
|
|
|
|
}
|
|
|
|
|
2007-09-20 01:05:10 -06:00
|
|
|
static inline int sysfs_create_group(struct kobject *kobj,
|
|
|
|
const struct attribute_group *grp)
|
2005-04-16 16:20:36 -06:00
|
|
|
{
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
|
2008-04-30 10:01:17 -06:00
|
|
|
static inline int sysfs_update_group(struct kobject *kobj,
|
|
|
|
const struct attribute_group *grp)
|
|
|
|
{
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
|
2007-09-20 01:05:10 -06:00
|
|
|
static inline void sysfs_remove_group(struct kobject *kobj,
|
|
|
|
const struct attribute_group *grp)
|
2005-04-16 16:20:36 -06:00
|
|
|
{
|
|
|
|
}
|
|
|
|
|
2007-02-20 13:02:44 -07: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 05:40:21 -07:00
|
|
|
const struct attribute *attr, const char *group)
|
2007-02-20 13:02:44 -07:00
|
|
|
{
|
|
|
|
}
|
|
|
|
|
2008-09-25 17:45:13 -06:00
|
|
|
static inline void sysfs_notify(struct kobject *kobj, const char *dir,
|
|
|
|
const char *attr)
|
2006-03-19 23:53:53 -07:00
|
|
|
{
|
|
|
|
}
|
2008-07-15 16:58:04 -06: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-30 12:31:26 -06:00
|
|
|
const void *ns,
|
2008-07-15 16:58:04 -06: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-19 23:53:53 -07:00
|
|
|
|
2010-03-30 12:31:26 -06:00
|
|
|
static inline void sysfs_exit_ns(enum kobj_ns_type type, const void *tag)
|
|
|
|
{
|
|
|
|
}
|
|
|
|
|
2006-08-14 23:43:23 -06:00
|
|
|
static inline int __must_check sysfs_init(void)
|
|
|
|
{
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
|
2007-08-24 17:11:54 -06:00
|
|
|
static inline void sysfs_printk_last_file(void)
|
|
|
|
{
|
|
|
|
}
|
|
|
|
|
2005-04-16 16:20:36 -06:00
|
|
|
#endif /* CONFIG_SYSFS */
|
|
|
|
|
|
|
|
#endif /* _SYSFS_H_ */
|