From d38f92e42a9909887b28774cf1574d0099bcc312 Mon Sep 17 00:00:00 2001 From: Frodo Looijaard Date: Mon, 7 Dec 1998 23:57:51 +0000 Subject: [PATCH] Documentation update git-svn-id: http://lm-sensors.org/svn/lm-sensors/trunk@47 7894878c-1315-0410-8ee3-d5d059ff63e0 --- BUGS | 16 ++++++++++++++++ CONTRIBUTORS | 7 +++++-- TODO | 9 ++++++--- doc/modules | 5 ++++- 4 files changed, 31 insertions(+), 6 deletions(-) create mode 100644 BUGS diff --git a/BUGS b/BUGS new file mode 100644 index 00000000..a99438a5 --- /dev/null +++ b/BUGS @@ -0,0 +1,16 @@ +Except for many unimplemented things (listed in the TODO file), there may be +true bugs too. If you experience any problems, do not hesitate to mail +lm78@stimpy.netroedge.com. But read the documentation first, please! + +There is a problem in pre 2.1.58 kernels that can make the kernel Oops. You +can trigger this Oops if you have opened any file, or are in any directory, +created by a module. If you remove the module at such a moment, successive +access to those files or directories will make the kernel complain through +an Oops. There is really no good way to solve this. Stock kernel modules +exhibit the same problem, by the way. Kernels from 2.1.58 onwards have new +fill_inode() semantics; using this function, we can increase the module use +count while a module file or directory is accessed. This solves the problem, +because it makes it impossible to remove the module. +Alan Cox (alan@lxorguk.ukuu.org.uk), the maintainer of 2.0 kernels, has +said he will consider patches that backport this 2.1 feature; perhaps it +will be in 2.0.37. Until then, be careful when you unload modules. diff --git a/CONTRIBUTORS b/CONTRIBUTORS index 42dd77bb..c07e50ce 100644 --- a/CONTRIBUTORS +++ b/CONTRIBUTORS @@ -1,5 +1,7 @@ This package could not have been created without the help of many, many people. -The most notable contributors are listed below. +The most notable contributors are listed below. You are probably best of +to mail if you have questions, suggestions or +problems. * Alexander Larsson Wrote the original lm78 module; lm_sensors version 1 was no more than an @@ -12,7 +14,8 @@ The most notable contributors are listed below. developers of the current package. * Frodo Looijaard Took up the development of Alex' lm78 module. Large pieces of code were - written by him. Designed lm_sensors version 2. + written by him. Designed lm_sensors version 2, and wrote most of its + core code. * William Morgan Helped with some patches in lm_sensors version 1. He provided us with the original CVS archive, and even managed to explain to us how to use diff --git a/TODO b/TODO index 4b1543ae..8e1f69c8 100644 --- a/TODO +++ b/TODO @@ -1,15 +1,18 @@ Many, many things. Most notably: -* Support 10-bit addresses. At this moment, they are supported nowhere +* Support 10-bit addresses. At this moment, they are supported nowhere, except + in Simon Vogl's i2c modules. * Change the i2c modules to keep the namespace clean (EXPORT_SYMBOL does not work for us; many static declarations need to be added; better ask Simon Vogl first) * Make it SMP-safe: there are no spinlocks yet. They are needed at many - places, probably (everywhere where global vars are accessed). + places, probably (everywhere where global vars are accessed). This must be + done for the i2c modules, too. * Extend sensors.c with a file /proc/sys/dev/sensors/chips, which lists all directories under /proc/sys/dev/sensors with their SYSCTL id (needed for good sysctl access). -* Write smbus_access_i2c in smbus.c +* Extend the mod_inc_use/mod_dec_use through the fill_inode trick, for all + new /proc files. * Make lm78.c detect 'double hits', (same chip connected to both SMBus and ISA). * Better lm78/lm75 detection; insmod-time paramters to set addresses diff --git a/doc/modules b/doc/modules index 01d75244..21a2601b 100644 --- a/doc/modules +++ b/doc/modules @@ -60,6 +60,9 @@ sensors: i2c-core General purpose routines for sensor client modules lm78: sensors smbus i2c-core - LM78 (and LM78-J, LM79) chip driver + LM78, LM78-J and LM79 chip driver + +lm75: sensors smbus i2c-core + LM75 chip driver (To do: i2c modules)