Merge branch 'doc/4.4' of git.lwn.net:/home/git/linux-2.6

*.png

*.gif

*.svg

*.proc

*.db

media-indices.tmpl

media-entities.tmpl

in the directories and applications only see a limited set of

the network devices.

Each sysfs directory entry may be tagged with zero or one

namespaces.  A sysfs_dirent is augmented with a void *s_ns.  If a

directory entry is tagged, then sysfs_dirent->s_flags will have a

flag between KOBJ_NS_TYPE_NONE and KOBJ_NS_TYPES, and s_ns will

point to the namespace to which it belongs.

Each sysfs directory entry may be tagged with a namespace via the

void *ns member of its kernfs_node.  If a directory entry is tagged,

then kernfs_node->flags will have a flag between KOBJ_NS_TYPE_NONE

and KOBJ_NS_TYPES, and ns will point to the namespace to which it

belongs.

Each sysfs superblock's sysfs_super_info contains an array void

Each sysfs superblock's kernfs_super_info contains an array void

*ns[KOBJ_NS_TYPES].  When a task in a tagging namespace

kobj_nstype first mounts sysfs, a new superblock is created.  It

will be differentiated from other sysfs mounts by having its

through bind mounting and mounts propagation, a task can easily view

the contents of other namespaces' sysfs mounts.  Therefore, when a

namespace exits, it will call kobj_ns_exit() to invalidate any

sysfs_dirent->s_ns pointers pointing to it.

kernfs_node->ns pointers pointing to it.

Users of this interface:

- define a type in the kobj_ns_type enumeration.

belong to. 

Sysfs internally stores a pointer to the kobject that implements a

directory in the sysfs_dirent object associated with the directory. In

directory in the kernfs_node object associated with the directory. In

the past this kobject pointer has been used by sysfs to do reference

counting directly on the kobject whenever the file is opened or closed.

With the current sysfs implementation the kobject reference count is

  be called again, rearmed, to fill the buffer.

- On write(2), sysfs expects the entire buffer to be passed during the

  first write. Sysfs then passes the entire buffer to the store()

  method. 

  first write. Sysfs then passes the entire buffer to the store() method.

  A terminating null is added after the data on stores. This makes

  functions like sysfs_streq() safe to use.

  When writing sysfs files, userspace processes should first read the

  entire file, modify the values it wishes to change, then write the

- HOW

Lockdep already has hooks in the lock functions and maps lock instances to

lock classes. We build on that (see Documentation/lokcing/lockdep-design.txt).

lock classes. We build on that (see Documentation/locking/lockdep-design.txt).

The graph below shows the relation between the lock functions and the various

hooks therein.

ALS contains 4 different gain steps. Driver automatically

selects suitable gain step. After each measurement, reliability of the results

is estimated and new measurement is trigged if necessary.

is estimated and new measurement is triggered if necessary.

Platform data can provide tuned values to the conversion formulas if

values are known. Otherwise plain sensor default values are used.