linux-toradex.git/Documentation/filesystems/sysfs.txt, branch v3.0.44

Fix common misspellings

2011-03-31T14:26:23+00:00

Fixes generated by 'codespell' and manually reviewed.

Signed-off-by: Lucas De Marchi

docs/sysfs: show() methods should use scnprintf().

2011-02-03T23:10:18+00:00

Since snprintf() may return a value that exceeds its second argument,
show() methods should use scnprintf() instead of snprintf(). This patch
updates the example in the sysfs documentation accordingly.

Signed-off-by: Bart Van Assche 
Cc: Tejun Heo 
Cc: Dmitry Torokhov 
Signed-off-by: Greg Kroah-Hartman

docs/sysfs: Update directory/kobject documentation.

2011-02-03T23:10:18+00:00

Some time ago the way how sysfs stores a pointer to a kobject
corresponding to a directory was modified. This patch brings the
documentation again in sync with the implementation.

Signed-off-by: Bart Van Assche 
Cc: Tejun Heo 
Cc: Dmitry Torokhov 
Signed-off-by: Greg Kroah-Hartman

sysfs: Fix one more signature discrepancy between sysfs implementation and docs.

2010-08-05T20:53:34+00:00

Signed-off-by: Ira Weiny 
Signed-off-by: Greg Kroah-Hartman

sysfs: fix discrepancies between implementation and documentation

2010-08-05T20:53:34+00:00

Fix all discrepancies I know of between the sysfs implementation and its
documentation.

Signed-off-by: Bart Van Assche 
Cc: Randy Dunlap 
Signed-off-by: Andrew Morton 
Signed-off-by: Greg Kroah-Hartman

Driver core: driver_attribute parameters can often be const*

2009-12-23T19:23:43+00:00

Many struct driver_attribute descriptors are purely read-only
structures, and there's no need to change them. Therefore make
the promise not to, which will let those descriptors be put in
a ro section.

Signed-off-by: Phil Carmody 
Signed-off-by: Greg Kroah-Hartman

Driver core: device_attribute parameters can often be const*

2009-12-23T19:23:43+00:00

Most device_attributes are const, and are begging to be
put in a ro section. However, the create and remove
file interfaces were failing to propagate the const promise
which the only functions they call offer.

Signed-off-by: Phil Carmody 
Signed-off-by: Greg Kroah-Hartman

driver core: documentation: make it clear that sysfs is optional

2009-07-28T20:45:23+00:00

The original text suggested that sysfs is mandatory and always
compiled in the kernel.

Signed-off-by: Lucian Adrian Grijincu 
Signed-off-by: Randy Dunlap 
Signed-off-by: Greg Kroah-Hartman

PATCH [2/2] Documentation/filesystems/sysfs.txt: fix descriptions of device attributes

2009-02-22T17:28:15+00:00

Fix descriptions of device attributes to be consistent with the actual
implementations in include/linux/device.h

Signed-off-by: Mike Murphy 
Signed-off-by: Linus Torvalds

sysfs: add /sys/dev/{char,block} to lookup sysfs path by major:minor

2008-07-22T04:54:40+00:00

Why?:
There are occasions where userspace would like to access sysfs
attributes for a device but it may not know how sysfs has named the
device or the path.  For example what is the sysfs path for
/dev/disk/by-id/ata-ST3160827AS_5MT004CK?  With this change a call to
stat(2) returns the major:minor then userspace can see that
/sys/dev/block/8:32 links to /sys/block/sdc.

What are the alternatives?:
1/ Add an ioctl to return the path: Doable, but sysfs is meant to reduce
   the need to proliferate ioctl interfaces into the kernel, so this
   seems counter productive.

2/ Use udev to create these symlinks: Also doable, but it adds a
   udev dependency to utilities that might be running in a limited
   environment like an initramfs.

3/ Do a full-tree search of sysfs.

[kay.sievers@vrfy.org: fix duplicate registrations]
[kay.sievers@vrfy.org: cleanup suggestions]

Cc: Neil Brown 
Cc: Tejun Heo 
Acked-by: Kay Sievers 
Reviewed-by: SL Baur 
Acked-by: Kay Sievers 
Acked-by: Mark Lord 
Acked-by: H. Peter Anvin 
Signed-off-by: Dan Williams 
Signed-off-by: Greg Kroah-Hartman