2005-04-17 05:20:36 +07:00
|
|
|
/*
|
|
|
|
* sysfs.h - definitions for the device driver filesystem
|
|
|
|
*
|
|
|
|
* Copyright (c) 2001,2002 Patrick Mochel
|
|
|
|
* Copyright (c) 2004 Silicon Graphics, Inc.
|
2007-09-20 15:31:38 +07:00
|
|
|
* Copyright (c) 2007 SUSE Linux Products GmbH
|
|
|
|
* Copyright (c) 2007 Tejun Heo <teheo@suse.de>
|
2005-04-17 05:20:36 +07:00
|
|
|
*
|
|
|
|
* Please see Documentation/filesystems/sysfs.txt for more information.
|
|
|
|
*/
|
|
|
|
|
|
|
|
#ifndef _SYSFS_H_
|
|
|
|
#define _SYSFS_H_
|
|
|
|
|
2006-08-15 12:43:17 +07:00
|
|
|
#include <linux/compiler.h>
|
2007-03-18 19:58:08 +07:00
|
|
|
#include <linux/errno.h>
|
2007-01-17 23:51:18 +07:00
|
|
|
#include <linux/list.h>
|
2005-04-17 05:20:36 +07:00
|
|
|
#include <asm/atomic.h>
|
|
|
|
|
|
|
|
struct kobject;
|
|
|
|
struct module;
|
|
|
|
|
2007-06-14 01:45:17 +07:00
|
|
|
/* FIXME
|
2008-10-19 10:28:50 +07: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-14 01:45:17 +07:00
|
|
|
*/
|
2005-04-17 05:20:36 +07:00
|
|
|
struct attribute {
|
2007-09-20 14:05:10 +07:00
|
|
|
const char *name;
|
|
|
|
struct module *owner;
|
2005-04-17 05:20:36 +07:00
|
|
|
mode_t mode;
|
|
|
|
};
|
|
|
|
|
|
|
|
struct attribute_group {
|
2007-09-20 14:05:10 +07:00
|
|
|
const char *name;
|
2008-03-21 08:47:52 +07:00
|
|
|
mode_t (*is_visible)(struct kobject *,
|
2007-10-31 21:38:04 +07:00
|
|
|
struct attribute *, int);
|
2007-09-20 14:05:10 +07:00
|
|
|
struct attribute **attrs;
|
2005-04-17 05:20:36 +07: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 01:45:17 +07:00
|
|
|
.attr = {.name = __stringify(_name), .mode = _mode }, \
|
2005-04-17 05:20:36 +07:00
|
|
|
.show = _show, \
|
|
|
|
.store = _store, \
|
|
|
|
}
|
|
|
|
|
|
|
|
#define __ATTR_RO(_name) { \
|
2007-06-14 01:45:17 +07:00
|
|
|
.attr = { .name = __stringify(_name), .mode = 0444 }, \
|
|
|
|
.show = _name##_show, \
|
2005-04-17 05:20:36 +07: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 12:57:22 +07: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 05:20:36 +07: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 05:58:04 +07:00
|
|
|
struct sysfs_dirent;
|
|
|
|
|
2005-04-17 05:20:36 +07:00
|
|
|
#ifdef CONFIG_SYSFS
|
|
|
|
|
2007-09-20 14:05:10 +07:00
|
|
|
int sysfs_schedule_callback(struct kobject *kobj, void (*func)(void *),
|
|
|
|
void *data, struct module *owner);
|
2005-04-17 05:20:36 +07:00
|
|
|
|
2007-09-20 14:05:10 +07: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 11:57:32 +07:00
|
|
|
|
2007-09-20 14:05:10 +07: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 05:20:36 +07:00
|
|
|
|
2006-08-15 12:43:17 +07:00
|
|
|
int __must_check sysfs_create_bin_file(struct kobject *kobj,
|
2007-09-20 14:05:10 +07:00
|
|
|
struct bin_attribute *attr);
|
2006-07-11 13:05:25 +07:00
|
|
|
void sysfs_remove_bin_file(struct kobject *kobj, struct bin_attribute *attr);
|
2005-04-17 05:20:36 +07:00
|
|
|
|
2007-09-20 14:05:10 +07:00
|
|
|
int __must_check sysfs_create_link(struct kobject *kobj, struct kobject *target,
|
|
|
|
const char *name);
|
2008-06-10 16:09:08 +07:00
|
|
|
int __must_check sysfs_create_link_nowarn(struct kobject *kobj,
|
|
|
|
struct kobject *target,
|
|
|
|
const char *name);
|
2007-09-20 14:05:10 +07: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 08:47:52 +07:00
|
|
|
int sysfs_update_group(struct kobject *kobj,
|
|
|
|
const struct attribute_group *grp);
|
2007-09-20 14:05:10 +07:00
|
|
|
void sysfs_remove_group(struct kobject *kobj,
|
|
|
|
const struct attribute_group *grp);
|
2007-02-21 03:02:44 +07:00
|
|
|
int sysfs_add_file_to_group(struct kobject *kobj,
|
2007-09-20 14:05:10 +07:00
|
|
|
const struct attribute *attr, const char *group);
|
2007-02-21 03:02:44 +07:00
|
|
|
void sysfs_remove_file_from_group(struct kobject *kobj,
|
2007-09-20 14:05:10 +07:00
|
|
|
const struct attribute *attr, const char *group);
|
2007-02-21 03:02:44 +07:00
|
|
|
|
2008-09-26 06:45:13 +07:00
|
|
|
void sysfs_notify(struct kobject *kobj, const char *dir, const char *attr);
|
2008-07-16 05:58:04 +07: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 06:11:54 +07:00
|
|
|
void sysfs_printk_last_file(void);
|
2008-07-16 05:58:04 +07:00
|
|
|
int __must_check sysfs_init(void);
|
2006-08-15 12:43:23 +07:00
|
|
|
|
2005-04-17 05:20:36 +07:00
|
|
|
#else /* CONFIG_SYSFS */
|
|
|
|
|
2007-03-16 02:50:34 +07:00
|
|
|
static inline int sysfs_schedule_callback(struct kobject *kobj,
|
2007-04-26 14:12:04 +07:00
|
|
|
void (*func)(void *), void *data, struct module *owner)
|
2007-03-16 02:50:34 +07:00
|
|
|
{
|
|
|
|
return -ENOSYS;
|
|
|
|
}
|
|
|
|
|
2007-09-20 14:05:10 +07:00
|
|
|
static inline int sysfs_create_dir(struct kobject *kobj)
|
2005-04-17 05:20:36 +07:00
|
|
|
{
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
|
2007-09-20 14:05:10 +07:00
|
|
|
static inline void sysfs_remove_dir(struct kobject *kobj)
|
2005-04-17 05:20:36 +07:00
|
|
|
{
|
|
|
|
}
|
|
|
|
|
2007-09-20 14:05:10 +07:00
|
|
|
static inline int sysfs_rename_dir(struct kobject *kobj, const char *new_name)
|
2005-04-17 05:20:36 +07:00
|
|
|
{
|
2008-07-04 08:05:28 +07:00
|
|
|
return 0;
|
2005-04-17 05:20:36 +07:00
|
|
|
}
|
|
|
|
|
2007-09-20 14:05:10 +07:00
|
|
|
static inline int sysfs_move_dir(struct kobject *kobj,
|
|
|
|
struct kobject *new_parent_kobj)
|
2006-11-20 23:07:51 +07:00
|
|
|
{
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
|
2007-09-20 14:05:10 +07:00
|
|
|
static inline int sysfs_create_file(struct kobject *kobj,
|
|
|
|
const struct attribute *attr)
|
2005-04-17 05:20:36 +07:00
|
|
|
{
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
|
2007-09-20 14:05:10 +07:00
|
|
|
static inline int sysfs_chmod_file(struct kobject *kobj,
|
|
|
|
struct attribute *attr, mode_t mode)
|
2005-04-19 11:57:32 +07:00
|
|
|
{
|
|
|
|
return 0;
|
|
|
|
}
|
2005-04-17 05:20:36 +07:00
|
|
|
|
2007-09-20 14:05:10 +07:00
|
|
|
static inline void sysfs_remove_file(struct kobject *kobj,
|
|
|
|
const struct attribute *attr)
|
2005-04-17 05:20:36 +07:00
|
|
|
{
|
|
|
|
}
|
|
|
|
|
2007-09-20 14:05:10 +07:00
|
|
|
static inline int sysfs_create_bin_file(struct kobject *kobj,
|
|
|
|
struct bin_attribute *attr)
|
2005-04-17 05:20:36 +07:00
|
|
|
{
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
|
2008-02-20 08:39:02 +07:00
|
|
|
static inline void sysfs_remove_bin_file(struct kobject *kobj,
|
|
|
|
struct bin_attribute *attr)
|
2005-04-17 05:20:36 +07:00
|
|
|
{
|
|
|
|
}
|
|
|
|
|
2007-09-20 14:05:10 +07:00
|
|
|
static inline int sysfs_create_link(struct kobject *kobj,
|
|
|
|
struct kobject *target, const char *name)
|
2005-04-17 05:20:36 +07:00
|
|
|
{
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
|
2008-06-10 16:09:08 +07:00
|
|
|
static inline int sysfs_create_link_nowarn(struct kobject *kobj,
|
|
|
|
struct kobject *target,
|
|
|
|
const char *name)
|
|
|
|
{
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
|
2007-09-20 14:05:10 +07:00
|
|
|
static inline void sysfs_remove_link(struct kobject *kobj, const char *name)
|
2005-04-17 05:20:36 +07:00
|
|
|
{
|
|
|
|
}
|
|
|
|
|
2007-09-20 14:05:10 +07:00
|
|
|
static inline int sysfs_create_group(struct kobject *kobj,
|
|
|
|
const struct attribute_group *grp)
|
2005-04-17 05:20:36 +07:00
|
|
|
{
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
|
2008-04-30 23:01:17 +07:00
|
|
|
static inline int sysfs_update_group(struct kobject *kobj,
|
|
|
|
const struct attribute_group *grp)
|
|
|
|
{
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
|
2007-09-20 14:05:10 +07:00
|
|
|
static inline void sysfs_remove_group(struct kobject *kobj,
|
|
|
|
const struct attribute_group *grp)
|
2005-04-17 05:20:36 +07:00
|
|
|
{
|
|
|
|
}
|
|
|
|
|
2007-02-21 03: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 19:40:21 +07:00
|
|
|
const struct attribute *attr, const char *group)
|
2007-02-21 03:02:44 +07:00
|
|
|
{
|
|
|
|
}
|
|
|
|
|
2008-09-26 06:45:13 +07:00
|
|
|
static inline void sysfs_notify(struct kobject *kobj, const char *dir,
|
|
|
|
const char *attr)
|
2006-03-20 13:53:53 +07:00
|
|
|
{
|
|
|
|
}
|
2008-07-16 05:58:04 +07: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 13:53:53 +07:00
|
|
|
|
2006-08-15 12:43:23 +07:00
|
|
|
static inline int __must_check sysfs_init(void)
|
|
|
|
{
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
|
2007-08-25 06:11:54 +07:00
|
|
|
static inline void sysfs_printk_last_file(void)
|
|
|
|
{
|
|
|
|
}
|
|
|
|
|
2005-04-17 05:20:36 +07:00
|
|
|
#endif /* CONFIG_SYSFS */
|
|
|
|
|
|
|
|
#endif /* _SYSFS_H_ */
|