Changeset 389

Timestamp:

04/14/99 22:05:16 (14 years ago)

Author:

frodo

Message:

New program doc-insmod.pl to automatically document the insmod

parameters of a module.

Location:

lm-sensors/trunk

Files:

• doc/chips/lm75 (modified) (2 diffs)
• prog/detect/sensors-detect (modified) (1 diff)
• prog/doc/doc-features.pl (modified) (3 diffs)
• prog/doc/doc-insmod.pl (added)

lm-sensors/trunk/doc/chips/lm75

@@ -1 +1 @@
 Kernel driver `lm75.o'
+=====================
 
-Prefixes: lm75 (LM75, I2C)
+Status: Complete and well-tested
 
-This driver implements support for the National Semiconductor LM75, a
-`Digital Temperature Sensor and Thermal Watchdog with Two-Wire Interface'.
+Supported chips: 
+  * National Semiconductors LM75
+    Prefix: `lm75'
+    Addresses scanned: I2C 0x48 - 0x4f (inclusive)
+    Datasheet: Publicly available at the National Semiconductors website
+
+
+Description
+-----------
 
 The LM75 implements one temperature sensor. Limits can be set through the
@@ -12 +20 @@
 gets higher then the Overtemperature Shutdown value; it stays on until
 the temperature falls below the Hysteris value.
-All temperatures are in degrees Celcius.
+All temperatures are in degrees Celcius, and are guaranteed within a 
+range of -55 to +125 degrees.
 
 The LM75 only updates its values each 1.5 seconds; reading it more often
 will do no harm, but will return 'old' values.
 
+The LM75 is usually used in combination with LM78-like chips, to measure
+the temperature of the processor(s).
 
-/proc and sysctl interface files:
-  * temp (LM75_SYSCTL_TEMP)
-    Overtemperature Shutdown Value (RW,1), Hysteris Value (RW,1) and Current 
-    Temperature (R,1).
 
-configuration file features:
-               NAME        LABEL CLASS     COMPUTE CLASS   RW
-               temp:                                       R 
-          temp_hyst:              temp              temp   RW
-          temp_over:              temp              temp   RW
+Configuration file features
+---------------------------
+
+          LABEL     LABEL CLASS   COMPUTE CLASS ACCESS MAGNITUDE
+           temp            NONE            NONE      R     1
+      temp_hyst            temp            temp      RW    1
+      temp_over            temp            temp      RW    1
+
+
+          LABEL                           FEATURE SYMBOL     SYSCTL FILE:OFFSET
+           temp                        SENSORS_LM75_TEMP            temp:3
+      temp_hyst                   SENSORS_LM75_TEMP_HYST            temp:2
+      temp_over                   SENSORS_LM75_TEMP_OVER            temp:1
+

lm-sensors/trunk/prog/detect/sensors-detect

@@ -2 +2 @@
 
 #
-#    detect.pl - Detect PCI bus and chips
+#    sensors-detect - Detect PCI bus and chips
 #    Copyright (c) 1998, 1999  Frodo Looijaard <frodol@dds.nl>
 #

lm-sensors/trunk/prog/doc/doc-features.pl

@@ -1 +1 @@
 #!/usr/bin/perl
+
+#
+#    doc-features.pl - Generate module/library documentation
+#    Copyright (c) 1999  Frodo Looijaard <frodol@dds.nl>
+#
+#    This program is free software; you can redistribute it and/or modify
+#    it under the terms of the GNU General Public License as published by
+#    the Free Software Foundation; either version 2 of the License, or
+#    (at your option) any later version.
+#
+#    This program is distributed in the hope that it will be useful,
+#    but WITHOUT ANY WARRANTY; without even the implied warranty of
+#    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#    GNU General Public License for more details.
+#
+#    You should have received a copy of the GNU General Public License
+#    along with this program; if not, write to the Free Software
+#    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+#
 
 use strict;
@@ -197 +216 @@
 sub scan_all
 {
-  my ($prefix) = @_;
+  my ($prefix,@modules) = @_;
   my ($filename);
   scan_chips_h $prefix . "/lib/chips.h";
   scan_chips_c_1 $prefix . "/lib/chips.c";
   scan_chips_c_2 $prefix . "/lib/chips.c";
-  foreach $filename (glob ($prefix ."/kernel/chips/*.c")) { 
-    scan_kernel_module $filename 
+  foreach $filename (@modules) { 
+    scan_kernel_module "$prefix/kernel/chips/$filename"
   }
 }
@@ -245 +264 @@
 }
 
+sub help_message
+{
+  print STDERR "Syntax: doc-features PATH MODULES...\n";
+  print STDERR "PATH is the path to the base of the lm_sensors tree.\n";
+  print STDERR "MODULES are the modules that need to be examined. If none ".
+               "are specified,\n".
+               "all modules are examined. Modules are looked for in ".
+               "PATH/kernel/chips\n.";
+}
+
+# @_: @ARGV
+# Returns ($base_dir,@modules)
+sub scan_arguments 
+{
+  my ($base_dir,@modules);
+  if (@_ < 1 or @_[0] =~ /^-/) {
+    help_message;
+    exit 0;
+  }
+  $base_dir = @_[0];
+  if (@_ == 1) {
+    @modules = map { substr $_, length "$base_dir/kernel/chips/" }
+                   glob "$base_dir/kernel/chips/*.c";
+  } else {
+    splice(@_,0,1);
+    @modules = map { $_ !~ /\./ ? $_.".c" : $_ } @_; 
+  }
+  return ($base_dir,@modules)
+}
 
 initialize;
-scan_all "../..";
+scan_all scan_arguments @ARGV;
 my $el;
 foreach $el (keys %features) {
-  output_data $el;
-  print "\n\n";
-}
+  if (exists $sysctls{$features{$el}->{features}->[0]->{sysctl}}) {
+    output_data $el;
+    print "\n\n";
+  }
+}