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>
|
2005-04-17 06:20:36 +08:00
|
|
|
#include <asm/atomic.h>
|
|
|
|
|
|
|
|
struct kobject;
|
|
|
|
struct module;
|
|
|
|
|
2007-06-14 02:45:17 +08:00
|
|
|
/* FIXME
|
|
|
|
* The *owner field is no longer used, but leave around
|
|
|
|
* until the tree gets cleaned up fully.
|
|
|
|
*/
|
2005-04-17 06:20:36 +08:00
|
|
|
struct attribute {
|
2007-09-20 15:05:10 +08:00
|
|
|
const char *name;
|
|
|
|
struct module *owner;
|
2005-04-17 06:20:36 +08:00
|
|
|
mode_t mode;
|
|
|
|
};
|
|
|
|
|
|
|
|
struct attribute_group {
|
2007-09-20 15:05:10 +08:00
|
|
|
const char *name;
|
2008-03-21 09:47:52 +08:00
|
|
|
mode_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
|
|
|
}
|
|
|
|
|
|
|
|
#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-09 13:57:22 +08: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-17 06:20:36 +08:00
|
|
|
int (*mmap)(struct kobject *, struct bin_attribute *attr,
|
|
|
|
struct vm_area_struct *vma);
|
|
|
|
};
|
|
|
|
|
|
|
|
struct sysfs_ops {
|
|
|
|
ssize_t (*show)(struct kobject *, struct attribute *,char *);
|
|
|
|
ssize_t (*store)(struct kobject *,struct attribute *,const char *, size_t);
|
|
|
|
};
|
|
|
|
|
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);
|
|
|
|
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);
|
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,
|
2007-09-20 15:05:10 +08:00
|
|
|
struct bin_attribute *attr);
|
2006-07-11 14:05:25 +08:00
|
|
|
void sysfs_remove_bin_file(struct kobject *kobj, 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);
|
|
|
|
|
|
|
|
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);
|
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,
|
|
|
|
const unsigned char *name);
|
|
|
|
struct sysfs_dirent *sysfs_get(struct sysfs_dirent *sd);
|
|
|
|
void sysfs_put(struct sysfs_dirent *sd);
|
2007-08-25 07:11:54 +08:00
|
|
|
void sysfs_printk_last_file(void);
|
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;
|
|
|
|
}
|
|
|
|
|
2007-09-20 15:05:10 +08:00
|
|
|
static inline int sysfs_chmod_file(struct kobject *kobj,
|
|
|
|
struct attribute *attr, mode_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
|
|
|
{
|
|
|
|
}
|
|
|
|
|
2007-09-20 15:05:10 +08:00
|
|
|
static inline int sysfs_create_bin_file(struct kobject *kobj,
|
|
|
|
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,
|
|
|
|
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
|
|
|
{
|
|
|
|
}
|
|
|
|
|
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
|
|
|
{
|
|
|
|
}
|
|
|
|
|
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,
|
|
|
|
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;
|
|
|
|
}
|
|
|
|
|
2007-08-25 07:11:54 +08:00
|
|
|
static inline void sysfs_printk_last_file(void)
|
|
|
|
{
|
|
|
|
}
|
|
|
|
|
2005-04-17 06:20:36 +08:00
|
|
|
#endif /* CONFIG_SYSFS */
|
|
|
|
|
|
|
|
#endif /* _SYSFS_H_ */
|