From 4d095e09213473fc9e8a5635bb1bc1728d20d979 Mon Sep 17 00:00:00 2001
From: Jean Delvare <khali@linux-fr.org>
Date: Thu, 29 Apr 2004 17:43:50 +0000
Subject: [PATCH] New manual page for isaset.

git-svn-id: http://lm-sensors.org/svn/lm-sensors/trunk@2490 7894878c-1315-0410-8ee3-d5d059ff63e0
---
 prog/dump/Module.mk |  2 +-
 prog/dump/i2cset.8  |  2 +-
 prog/dump/isadump.8 |  2 +-
 prog/dump/isaset.8  | 59 +++++++++++++++++++++++++++++++++++++++++++++
 4 files changed, 62 insertions(+), 3 deletions(-)
 create mode 100644 prog/dump/isaset.8

diff --git a/prog/dump/Module.mk b/prog/dump/Module.mk
index 80caeb78..30c0694a 100644
--- a/prog/dump/Module.mk
+++ b/prog/dump/Module.mk
@@ -33,7 +33,7 @@ PROGDUMPBININSTALL := $(MODULE_DIR)/i2cdump $(MODULE_DIR)/i2cset
 
 # Only build isadump and isaset on x86 machines.
 ifneq (,$(findstring $(MACHINE), i386 i486 i586 i686 x86_64))
-PROGDUMPMAN8FILES += $(MODULE_DIR)/isadump.8
+PROGDUMPMAN8FILES += $(MODULE_DIR)/isadump.8 $(MODULE_DIR)/isaset.8
 PROGDUMPTARGETS += $(MODULE_DIR)/isadump $(MODULE_DIR)/isaset
 PROGDUMPSOURCES += $(MODULE_DIR)/isadump.c $(MODULE_DIR)/isaset.c
 PROGDUMPBININSTALL += $(MODULE_DIR)/isadump $(MODULE_DIR)/isaset
diff --git a/prog/dump/i2cset.8 b/prog/dump/i2cset.8
index 2f64fc19..320322dc 100644
--- a/prog/dump/i2cset.8
+++ b/prog/dump/i2cset.8
@@ -40,7 +40,7 @@ using this program.
 lm_sensors-2.x
 
 .SH SEE ALSO
-i2cdump(8)
+i2cdump(8), isaset(8)
 
 .SH AUTHOR
 Frodo Looijaard, Mark D. Studebaker, and the lm_sensors group
diff --git a/prog/dump/isadump.8 b/prog/dump/isadump.8
index 9bc4406f..a1e82570 100644
--- a/prog/dump/isadump.8
+++ b/prog/dump/isadump.8
@@ -77,7 +77,7 @@ this program.
 lm_sensors-2.x
 
 .SH SEE ALSO
-i2cdump(8)
+i2cdump(8), isaset(8)
 
 .SH AUTHOR
 Frodo Looijaard, Mark D. Studebaker, and the lm_sensors group
diff --git a/prog/dump/isaset.8 b/prog/dump/isaset.8
new file mode 100644
index 00000000..29940ac7
--- /dev/null
+++ b/prog/dump/isaset.8
@@ -0,0 +1,59 @@
+.TH ISASET 8 "April 2004"
+.SH "NAME"
+i2cset \- set ISA registers
+
+.SH SYNOPSIS
+.B isaset
+.I addrreg
+.I datareg
+.I address
+.I value
+(for I\u2\dC-like access)
+.br
+.B isaset
+.BI "-f " address
+.I value
+(for flat address space)
+
+.SH DESCRIPTION
+isaset is a small helper program to set registers visible through the ISA
+bus.
+
+.SH OPTIONS (I\u2\dC-like access mode)
+Exactly four options must be provided to isaset. \fIaddrreg\fR contains the
+ISA address of the address register for the chip to probe; \fIdatareg\fR
+contains the address of the data register. Both addresses are integers between
+0x0000 and 0x3FFF. Usually, if the chip's base address is 0x0nn0, the
+address register is at 0x0nn5 and the data register is at 0x0nn6. The most
+common base address for hardware monitoring chips is 0x0290.
+.PP
+For Super-I/O chips, address register is typically at 0x2E with data
+register at 0x2F.
+The \fIaddress\fR and \fIvalue\fR parameters are two integers between
+0x00 and 0xFF. isaset will write value \fIvalue\fR to address \fIaddress\fR.
+
+.SH OPTIONS (flat address space mode)
+In flat mode (triggered by the \fB-f\fR flag), exactly two parameters must
+be provided. \fIaddress\fR contains the ISA address of the register to
+write to; it is an integer between 0x0000 and 0xFFFF. Basically, it is
+the sum of the chip's base address and the chip register's address. isaset
+will write value \fIvalue\fR at this address.
+
+.SH WARNING
+Poking around in ISA data space is extremely dangerous.
+Running isaset with random parameters can cause system
+crashes, data loss, and worse!  Be extremely careful when using
+this program.
+
+.SH CONFORMING TO
+lm_sensors-2.x
+
+.SH SEE ALSO
+i2cset(8), isadump(8)
+
+.SH AUTHOR
+Mark D. Studebaker, and the lm_sensors group
+(http://www.lm-sensors.nu/)
+.PP
+This manual page was shamelessly ripped from i2cset and isadump manual
+pages by Jean Delvare.