kernel/Documentation/kobject.txt, branch linux-rolling-stable

Documentation: kobject.txt has been moved to core-api/kobject.rst

2020-03-02T20:03:44Z

Moved the `kobject.txt` to `core-api/kobject.rst` and updated the `core-api` index to point to it. Signed-off-by: Sameer Rahmani [jc: moved it down from the top of core-api/index.rst] Link: https://lore.kernel.org/r/20200225222125.61874-2-lxsameer@gnu.org Signed-off-by: Jonathan Corbet

Documentation: Converted the `kobject.txt` to rst format

2020-03-02T20:02:45Z

Reviewed and converted the `kobject.txt` format to rst in place. Signed-off-by: Sameer Rahmani Link: https://lore.kernel.org/r/20200225222125.61874-1-lxsameer@gnu.org Signed-off-by: Jonathan Corbet

kref/kobject: Improve documentation

2018-12-06T12:57:03Z

The current kref and kobject documentation may be insufficient to understand these common pitfalls regarding object lifetime and object releasing. Add a bit more documentation and improve the warnings seen by the user, pointing to the right piece of documentation. Also, it's important to understand that making fun of people publicly is not at all helpful, doesn't provide any value, and it's not a healthy way of encouraging developers to do better. "Mocking mercilessly" will, if anything, make developers feel bad and go away. This kind of behavior should not be encouraged or justified. Signed-off-by: Ezequiel Garcia Signed-off-by: Enric Balletbo i Serra Signed-off-by: Gustavo Padovan Signed-off-by: Matthias Brugger Acked-by: Daniel Vetter Acked-by: Guenter Roeck Signed-off-by: Greg Kroah-Hartman

kobject.txt: standardize document format

2017-07-14T19:51:44Z

Each text file under Documentation follows a different format. Some doesn't even have titles! Change its representation to follow the adopted standard, using ReST markups for it to be parseable by Sphinx: - Add markups for titles; - mark literal blocks as such; - add needed whitespace/blank lines; - use :Author: and :Last updated: for authorship. Acked-by: Greg Kroah-Hartman Signed-off-by: Mauro Carvalho Chehab Signed-off-by: Jonathan Corbet

kobject: grammar fix

2014-12-08T14:07:11Z

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:11Z

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:34Z

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:01Z

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:20Z

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:18Z

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