linux.git/Documentation/kobject.txt, branch v4.3

kobject: grammar fix

2014-12-08T14:07:11+00:00

Signed-off-by: John de la Garza 
Signed-off-by: Jonathan Corbet

kobject: remove kset from sysfs immediately in kset_unregister()

2013-12-08T05:20:11+00:00

There's no "unlink from sysfs" interface for ksets, so I think callers of
kset_unregister() expect the kset to be removed from sysfs immediately,
without waiting for the last reference to be released.

This patch makes the sysfs removal happen immediately, so the caller may
create a new kset with the same name as soon as kset_unregister() returns.
Without this, every caller has to call "kobject_del(&kset->kobj)" first
unless it knows it will never create a new kset with the same name.

This sometimes shows up on module unload and reload, where the reload fails
because it tries to create a kobject with the same name as one from the
original load that still exists.  CONFIG_DEBUG_KOBJECT_RELEASE=y makes this
problem easier to hit.

Signed-off-by: Bjorn Helgaas 
Signed-off-by: Greg Kroah-Hartman

Documentation: Fix "struct kobj_type" to include newer members.

2012-09-04T23:06:34+00:00

kobj_type replaced by verbatim copy-and-paste from kobject.h.

Signed-off-by: Robert P. J. Day 
Signed-off-by: Greg Kroah-Hartman

driver-core: documentation: fix up Greg's email address

2012-02-15T22:48:01+00:00

My old email address was used in a lot of documentation files, so fix
this up to point to the correct one now.

Signed-off-by: Greg Kroah-Hartman

kobject: documentation: Update to refer to kset-example.c.

2010-03-19T14:12:20+00:00

Signed-off-by: Robert P. J. Day 
Signed-off-by: Greg Kroah-Hartman

kobject: documentation: Fix erroneous example in kobject doc.

2010-03-19T14:12:18+00:00

Replace uio_mem example for kobjects with uio_map, since the uio_mem
struct no longer contains a kobject.

Signed-off-by: Robert P. J. Day 
Signed-off-by: Greg Kroah-Hartman

Driver core: Constify struct sysfs_ops in struct kobj_type

2010-03-08T01:04:49+00:00

Constify struct sysfs_ops.

This is part of the ops structure constification
effort started by Arjan van de Ven et al.

Benefits of this constification:

 * prevents modification of data that is shared
   (referenced) by many other structure instances
   at runtime

 * detects/prevents accidental (but not intentional)
   modification attempts on archs that enforce
   read-only kernel data at runtime

 * potentially better optimized code as the compiler
   can assume that the const data cannot be changed

 * the compiler/linker move const data into .rodata
   and therefore exclude them from false sharing

Signed-off-by: Emese Revfy 
Acked-by: David Teigland 
Acked-by: Matt Domsch 
Acked-by: Maciej Sosnowski 
Acked-by: Hans J. Koch 
Acked-by: Pekka Enberg 
Acked-by: Jens Axboe 
Acked-by: Stephen Hemminger 
Signed-off-by: Greg Kroah-Hartman

trivial: Miscellaneous documentation typo fixes

2009-06-12T16:01:47+00:00

Fix various typos in documentation txts.

Signed-off-by: Matt LaPlante 
Signed-off-by: Jiri Kosina

kobject: Make Documentation/kobject.txt a little more coherent.

2009-01-06T18:44:32+00:00

While reading Documentation/kobject.txt:

  Note kobject_rename does perform any locking or have a solid notion of
  what names are valid so the provide must provide their own sanity checking
  and serialization.

I expect better: You never see me hard with time word making sentence
coherent stuff.  Ever.

Signed-off-by: Rusty Russell 
Acked-by: Eric W. Biederman 
Signed-off-by: Greg Kroah-Hartman

kobject: Fix kobject_rename and !CONFIG_SYSFS

2008-10-16T16:24:52+00:00

When looking at kobject_rename I found two bugs with
that exist when sysfs support is disabled in the kernel.

kobject_rename does not change the name on the kobject when
sysfs support is not compiled in.

kobject_rename without locking attempts to check the
validity of a rename operation, which the kobject layer
simply does not have the infrastructure to do.

This patch documents the previously unstated requirement of
kobject_rename that is the responsibility of the caller to
provide mutual exclusion and to be certain that the new_name
for the kobject is valid.

This patch modifies sysfs_rename_dir in !CONFIG_SYSFS case
to call kobject_set_name to actually change the kobject_name.

This patch removes the bogus and misleading check in kobject_rename
that attempts to see if a rename is valid.  The check is bogus
because we do not have the proper locking.  The check is misleading
because it looks like we can and do perform checking at the kobject
level that we don't.

Signed-off-by: Eric W. Biederman 
Signed-off-by: Greg Kroah-Hartman