Exit building if romstage.bin is larger than size of XIP
[coreboot.git] / util / superiotool / README
index 9fef6306ccf02cb6bc5a8d0ce56f4d5b01c6c7d1..0a969c596bc7d096554a2a65520e358a23b81599 100644 (file)
@@ -11,14 +11,20 @@ Superiotool is a user-space utility which can
  - dump all register contents of the Super I/O chip, together with the
    default values as per datasheet (to make comparing the values easy).
 
  - dump all register contents of the Super I/O chip, together with the
    default values as per datasheet (to make comparing the values easy).
 
-It is mainly used for LinuxBIOS development purposes (see linuxbios.org
-for details on LinuxBIOS), but it may also be useful for other things.
+It is mainly used for coreboot development purposes (see coreboot.org
+for details on coreboot), but it may also be useful for other things.
 
 
 Installation
 ------------
 
 
 
 Installation
 ------------
 
- $ svn co svn://linuxbios.org/repos/trunk/util/superiotool
+ $ svn co svn://coreboot.org/repos/trunk/util/superiotool
+
+ $ cd superiotool
+
+Optional: Edit the Makefile and set 'CONFIG_PCI = no' if you don't want to
+support PCI-attached "Super I/Os" (which needs libpci-dev) such as the
+VIA VT82686A/B southbridge with integrated Super I/O functionality.
 
  $ make
 
 
  $ make
 
@@ -28,16 +34,10 @@ Installation
 Usage
 -----
 
 Usage
 -----
 
- $ superiotool [-d] [-D] [-V] [-v] [-h]
-
- -d | --dump            Dump Super I/O registers
- -D | --dump-readable   Dump Super I/O registers in human-readable format
- -V | --verbose         Verbose mode
- -v | --version         Show the superiotool version
- -h | --help            Show a short help text
+Please read the superiotool(8) manpage or type 'superiotool --help'.
 
 Per default (no options) superiotool will just probe for a Super I/O
 
 Per default (no options) superiotool will just probe for a Super I/O
-and print its vendor, name, ID, version, and config port.
+and print its vendor, name, ID, revision, and config port.
 
 Typical usage of superiotool:
 
 
 Typical usage of superiotool:
 
@@ -49,24 +49,27 @@ Typical usage of superiotool:
 
    $ superiotool -d
 
 
    $ superiotool -d
 
- - Detailed register dump in human-readable format:
-
-   $ superiotool -D
-
 
 Supported Super I/O Chips
 -------------------------
 
 
 Supported Super I/O Chips
 -------------------------
 
-Please see http://linuxbios.org/Superiotool#Supported_devices.
+Please see http://coreboot.org/Superiotool#Supported_devices, or type
+
+ $ superiotool -l
+
+There's also a collection of sample register dumps from various Super I/O
+chips on that web page. Please send further register dumps (either from a
+proprietary BIOS and/or from coreboot) to the coreboot mailing list
+(http://coreboot.org/Mailinglist).
 
 
 Website and Mailing List
 ------------------------
 
 
 
 Website and Mailing List
 ------------------------
 
-The main website is http://linuxbios.org/Superiotool.
+The main website is http://coreboot.org/Superiotool.
 
 For additional information, patches, and discussions, please join the
 
 For additional information, patches, and discussions, please join the
-LinuxBIOS mailing list at http://linuxbios.org/Mailinglist, where most
+coreboot mailing list at http://coreboot.org/Mailinglist, where most
 superiotool developers are subscribed.
 
 
 superiotool developers are subscribed.
 
 
@@ -77,5 +80,37 @@ Superiotool is copyrighted by a number of individual developers. Please
 refer to the respective source code files for details.
 
 It is licensed under the terms of the GNU General Public License (GPL),
 refer to the respective source code files for details.
 
 It is licensed under the terms of the GNU General Public License (GPL),
-either version 2 of the License, or (at your option) any later version.
+either version 2 of the license, or (at your option) any later version.
+
+
+Contributors
+------------
+
+Anders Juel Jensen <andersjjensen@gmail.com>
+Andriy Gapon <avg@icyb.net.ua>
+Arjan Koers <0h3q2rmn2bdb@list.nospam.xutrox.com>
+Bingxun Shi <bingxunshi@gmail.com>
+Carl-Daniel Hailfinger <c-d.hailfinger.devel.2006@gmx.net>
+David Bartley <dtbartle@csclub.uwaterloo.ca>
+David Hendricks <david.hendricks@gmail.com>
+François-Regis Vuillemin <coreboot@miradou.com>
+Frieder Ferlemann <Frieder.Ferlemann@web.de>
+Idwer Vollering <idwer_v@hotmail.com>
+Ioannis Barkas <tripl3fault@yahoo.com>
+Josh Profitt <zorn169@gmail.com>
+Luc Verhaegen <libv@skynet.be>
+Michael Gold <mgold@ncf.ca>
+Michał Mirosław <mirq-linux@rere.qmqm.pl>
+Nikos Barkas <levelwol@gmail.com>
+Rasmus Wiman <rasmus@wiman.org>
+Robinson P. Tryon <bishop.robinson@gmail.com>
+Ronald Hoogenboom <hoogenboom30@zonnet.nl>
+Ronald Minnich <rminnich@gmail.com>
+Sean Young <sean@mess.org>
+Stefan Reinauer <stepan@coresystems.de>
+Tom Sylla <tsylla@gmail.com>
+Ulf Jordan <jordan@chalmers.se>
+Urja Rannikko <urjaman@gmail.com>
+Uwe Hermann <uwe@hermann-uwe.de>
+Ward Vandewege <ward@gnu.org>