home *** CD-ROM | disk | FTP | other *** search
/ CD Actual 13 / CDA13.ISO / DOC / HOWTO / OTHER_FO / SGML / MODULE_H.GZ / Module-HOWTO.sgml
Encoding:
SGML Document  |  1996-06-24  |  67.5 KB  |  2,309 lines
  1. <!doctype linuxdoc system>
  2.  
  3. <article>
  4.  
  5. <title>Linux Module HOWTO
  6. <author>Lauri Tischler, Editor.
  7. <date>v1.0, 20 June 1996
  8.  
  9. <abstract>
  10.     This is the Module-HOWTO, which is a compilation of all the
  11.     possible module parameters that can be passed to the Linux
  12.     modules at load time. Information within is based on Linux Kernel
  13.     version 2.0.0.
  14. </abstract>
  15.  
  16. <toc>
  17.  
  18. <sect>Introduction<label id="main-intro">
  19. <p>
  20.         Inspiration for this paper came from Paul Gortmaker's excellent
  21.         BootPrompt-HOWTO.  With Paul's permission I have used his paper
  22.         as a framework, upon which I have grafted my ramblings.
  23.     Different parts of this paper have been shamelessly, without
  24.     any permissions what so ever, ripped off from various README and
  25.     *.txt files within the SourceTree. My sincere thanks for all the
  26.     authors of those texts which have made this document possible.
  27.  
  28.     This paper generally follows the same structure/module order as the
  29.     kernel configuration utility <tt/menuconfig/ when run in 
  30.     <tt/single_menu_mode=TRUE/ mode.
  31.  
  32.     All sections which are marked <tt/Modular/ in the configuration
  33.     utility are included here, regardless whether they have option
  34.     parameters or not. 
  35.  
  36.     Each section follows the example outline below:
  37. <code>
  38. Load command:
  39.     /sbin/insmod ne.o io=0x300 irq=5
  40.  
  41.         io = 0          (Explicitly *requires* an "io=0xNNN" value)
  42.         irq = 0         (Tries to determine configured IRQ via autoIRQ)
  43.         (Probes ports: 0x300, 0x280, 0x320, 0x340, 0x360)
  44.  
  45.     Depends on 8390.o
  46. </code>
  47. <p>
  48.     The Module-HOWTO is edited and maintained by:
  49. <quote>    Lauri Tischler, <tt/ltischler@efore.fi/</quote>
  50.  
  51. <sect1>Disclaimer and Copyright<label id="copyright">
  52. <p>
  53.     This document is <em/not/ gospel. However, it is probably the most
  54.     up to date info that you will be able to find. Nobody is responsible
  55.     for what happens to your hardware but yourself. If your
  56.     hardware goes up in smoke (...nearly impossible!)
  57.     I take no responsibility. ie. THE AUTHOR IS NOT RESPONSIBLE
  58.     FOR ANY DAMAGES INCURRED DUE TO ACTIONS TAKEN BASED ON THE
  59.     INFORMATION INCLUDED IN THIS DOCUMENT.
  60.  
  61.     This document is Copyright (c) 1996 by Lauri Tischler.
  62.     Permisson is granted to make and distribute
  63.     verbatim copies of this manual provided the copyright notice
  64.     and this permission notice are preserved on all copies.
  65.  
  66.     Permission is granted to copy and distribute modified versions
  67.     of this document under the conditions for verbatim copying,
  68.     provided that this copyright notice is included exactly as in
  69.     the original, and that the entire resulting derived work is
  70.     distributed under the terms of a permission notice identical
  71.     to this one.
  72.  
  73.     Permission is granted to copy and distribute translations
  74.     of this document into another language, under the above
  75.     conditions for modified versions.
  76.  
  77.     If you are intending to incorporate this document into a
  78.     published work, please contact me, and I will make an effort
  79.     to ensure that you have the most up to date information
  80.     available. In the past, out of date versions of the Linux
  81.     howto documents have been published, which caused the developers
  82.     undue grief from being plagued with questions that were already
  83.     answered in the up to date versions.
  84.  
  85. <sect1>Related Documentation<label id="other_docs">
  86. <p>
  87.     Following HOWTO's are highly recommended :
  88. <itemize>
  89. <item>  <bf/BootPrompt-HOWTO/ by Paul Gortmaker (<tt/Paul.Gortmaker@anu.edu.au/).
  90.     New versions of this document can be retrieved via anonymous FTP from
  91.     sunsite.unc.edu, in <tt>/pub/Linux/docs/HOWTO/*</tt> and various Linux
  92.     ftp mirror sites.
  93. <item>    <bf/kerneld mini-HOWTO/ by Henrik Storner (<tt/storner@osiris.ping.dk/).
  94.     The latest released version of this document can be found at
  95.     <tt>http://eolicom.olicom.dk/~storner/kerneld-mini-HOWTO.html</tt>.
  96.     Between releases of the mini-HOWTO you can find updates on Henrik's
  97.     unstructured list of changes at
  98.     <tt>http://eolicom.olicom.dk/~storner/kern.html</tt>.
  99.  
  100.  </itemize>
  101. <p>    
  102.     The file <tt>Documentation/Configure.help</tt> gives good general
  103.     information about what parts of the kernel to modularize or not.
  104.  
  105.     Also plethora of various README files, sprinkled (unfortunately) 
  106.     all over The SourceTree are good and informative reading.
  107.  
  108.     The most up-to-date documentation will always be The Kernel
  109.     Source itself.     For example, if you were looking for what parameters
  110.     could be passed to the smc-ultra ethernetcard, then you would go to
  111.     the <tt>linux/drivers/net</tt> directory, and look at the
  112.     file <tt/smc-ultra.c/ -- usually somewhere in the end of the file you
  113.     would find a procedure called <tt/init_module/.  Within this
  114.     procedure or around it you will parameter and structure
  115.     definitions related to module parameters.
  116.  
  117. <sect1>The Linux Newsgroups<label id="news">
  118. <p>
  119.     If you have questions about passing parameters to modules at
  120.     load time, please READ this document first. If this and the
  121.     related documentation mentioned above does not answer your
  122.     question(s) then you can try the Linux newsgroups.
  123.  
  124.     General questions on how to configure your system
  125.     should be directed to comp.os.linux.setup.
  126.     We ask that you <em/please/ respect this general guideline 
  127.     for content, and don't cross-post your request to other groups.
  128.  
  129.  
  130. <sect1>New Versions of Document<label id="new-doc">
  131. <p>
  132.     New versions of this document can be retrieved via anonymous
  133.     FTP from sunsite.unc.edu, in <tt>/pub/Linux/docs/HOWTO/*</tt> and various
  134.     Linux ftp mirror sites. Updates will be made  as new information or
  135.     drivers becomes available. If this copy that you are reading is more
  136.     than 3 months old, it is either out of date, or it means that I have
  137.     been lazy and haven't updated it.
  138.  
  139.     This document was produced by using the SGML system that was
  140.     specifically set up for the Linux Howto project, and there are
  141.     various output formats available, including, postscript, dvi,
  142.     ascii, html, and soon TeXinfo.
  143.  
  144.     I would recommend viewing it in the html (via a WWW browser) or the
  145.     Postscript/dvi format. Both of these contain cross-references
  146.     that are lost in the ascii translation.
  147.  
  148.     If you want to get the official copy off sunsite, here is URL.
  149.  
  150.     <url url="http://sunsite.unc.edu/mdw/HOWTO/Module-HOWTO.html"
  151.         name="Module-HOWTO">
  152.  
  153. <sect1>Experimental (alpha-code) modules or incomplete information.
  154. <p>
  155.     Here is a list of modules which are declared <em/experimental/
  156.     in configuration scripts or otherwise have incomplete info or
  157.     I'm just too dumb to understand the source code. Pick your choice.
  158. <itemize>
  159. <item>    Support for JAVA binaries.
  160. <item>    Qlogic ISP SCSI driver.
  161. <item>    Frame Relay DLCI driver.
  162. <item>    Sangoma S502A FRAD driver.
  163. <item>    BAYCOM driver for AX.25.
  164. <item>    WIC Radio IP Bridge.
  165. <item>  3Com 3c505 Ethernet driver.
  166. <item>    3Com 3c507 Ethernet driver.
  167. <item>    Allied Telesis AT1700 Ethernet driver.
  168. <item>    Intel Ether Express Pro driver.
  169. <item>    Fujitsu FMV-18x Ethernet driver.
  170. <item>    ICL EtherTeam 16i/32 Ethernet driver.
  171. <item>  NI 5210 Ethernet driver.
  172. <item>  Ansel Communications EISA 3200 Ethernet driver.
  173. <item>    Amiga FSS Filesystem.
  174. </itemize>
  175.  
  176. <sect1>History.
  177. <p><itemize>
  178. <item>  Initial release 1.0.
  179. </itemize>
  180.  
  181.  
  182. <sect>Module utilities
  183.  
  184. <p>    Module utilities are a set of programs necessary for handling
  185.     the modules. At the time of this writing, version of latest
  186.     module utilities was <tt/modules-2.0.0.tar.gz/.  Info about
  187.     latest current version can be found at
  188.     <tt>http://www.pi.se/blox</tt>
  189.  
  190. <p>    This information was originally provided by following gentlemen,
  191.     Jacques Gelinas <tt/jacques@solucorp.qc.ca/ and Björn Ekwall
  192.     <tt/bj0rn@blox.se/ in <tt>/usr/src/linux/Documentation/modules.txt</tt>.
  193.  
  194. <sect1>Making the modules
  195. <p>    Your first step is to compile the kernel, as explained in
  196.     the file <tt>linux/README</tt>.  It generally goes like:
  197. <itemize>
  198. <item>    make config
  199. <item>    make dep
  200. <item>    make clean
  201. <item>    make zImage or make zlilo
  202. </itemize>
  203. <p>
  204. In <tt/make config/, you select what you want to include in the <em/resident/
  205. kernel and what features you want to have available as loadable modules.
  206. You will generally select the minimal resident set that is needed to boot:
  207. <itemize>
  208. <item>    The filesystem of your root partition
  209. <item>    A scsi driver
  210. <item>    Normal hard drive support
  211. <item>    Net support (CONFIG_NET)
  212. <item>    TCP/IP support (CONFIG_INET), but no drivers!
  213. <item>    plus those things that you just can't live without...
  214. </itemize>
  215.  
  216. <p>
  217. The set of modules is constantly increasing, and you will be able to select
  218. the option <tt/m/ in <tt/make config/ for those features that the current
  219. kernel can offer as loadable modules.
  220.  
  221. <p>
  222. You also have a possibility to create modules that are less dependent on
  223. the kernel version.  This option can be selected during <tt/make config/, by
  224. enabling <tt/CONFIG_MODVERSIONS/, and is most useful on <em/stable/ kernel
  225.  versions, such as the kernels from the 1.2 and 2.0 series.
  226. If you have modules that are based on sources that are not included in
  227. the official kernel sources, you will certainly like this option...
  228.  
  229. <p>When you have made the kernel, you create the modules by doing:
  230. <tscreen>
  231.     make modules
  232. </tscreen>
  233. <p>This will compile all modules and update the <tt>linux/modules</tt>
  234. directory.  In this directory you will then find a bunch of symbolic links,
  235. pointing to the various object files in the kernel tree.
  236.  
  237. <p>Now, after you have created all your modules, you should also do:
  238. <tscreen>
  239.     make modules_install
  240. </tscreen>
  241.  
  242. <p>This will copy all newly made modules into subdirectories under
  243. <tt>/lib/modules/kernel_release/</tt>, where <tt/kernel_release/ is something
  244. like 2.0.1, or whatever the current kernel version is...
  245.  
  246. <p>As soon as you have rebooted the newly made kernel, you can install
  247. and remove modules at will with the utilities: <tt/insmod/ and <tt/rmmod/.
  248. After reading the man-page for insmod, you will also know how easy
  249. it is to configure a module when you do <tt/insmod/ (hint: symbol=value).
  250.  
  251. <sect1>Extended utilities, <tt/modprobe/ and <tt/depmod/.
  252. <p>
  253. You also have access to two utilities: <tt/modprobe/ and <tt/depmod/, where
  254. modprobe is a <em/wrapper/ for (or extension to) <tt/insmod/.
  255. These utilities use (and maintain) a set of files that describe all the
  256. modules that are available for the current kernel in the
  257. <tt>/lib/modules</tt> hierarchy as well as their interdependencies.
  258.  
  259. <p>Using the modprobe utility, you can load any module like this:
  260. <tscreen>
  261.     /sbin/modprobe module
  262. </tscreen>
  263. <p>without paying much attention to which kernel you are running, or what
  264. other modules this module depends on.
  265.  
  266. <p>With the help of the modprobe configuration file:
  267. <tt>/etc/conf.modules</tt> you can tune the behaviour of modprobe
  268. in many ways, including an automatic setting of insmod options for
  269.  each module. And, yes, there <em/are/ man-pages for all this...
  270.  
  271. To use modprobe successfully, you generally place the following
  272. command in your <tt>/etc/rc.d/rc.S</tt> script.  (Read more about this in the
  273. <tt/rc.hints/ file in the module utilities package, <tt/modules-x.y.z.tar.gz/.)
  274. <tscreen>
  275.     /sbin/depmod -a
  276. </tscreen>
  277. <p>This computes the dependencies between the different modules.
  278. Then if you do, for example
  279. <tscreen>
  280.     /sbin/modprobe umsdos
  281. </tscreen>
  282. <p>you will automatically load <em/both/ the <tt/msdos/ and <tt/umsdos/
  283.  modules, since <tt/umsdos/ runs piggyback on <tt/msdos/.
  284.  
  285.  
  286. <sect1>The <em/ultimate/ utility, <tt/kerneld/.
  287. <p>
  288. OK, you have read all of the above, and feel amply impressed...
  289. Now, we tell you to forget all about how to install and remove
  290. loadable modules...
  291.  
  292. <p>With the kerneld daemon, all of these chores will be taken care of
  293. automatically.  Just answer "Y" to CONFIG_KERNELD in <tt/make config/,
  294. and make sure that <tt>/sbin/kerneld</tt> is started as soon as possible
  295. after boot and that <tt>/sbin/depmod -a</tt> has been executed for the
  296. current kernel. (Read more about this in the module utilities package.)
  297.  
  298. <p>Whenever a program wants the kernel to use a feature that is only
  299. available as a loadable module, and if the kernel hasn't got the
  300. module installed yet, the kernel will ask the kerneld deamon to take
  301. care of the situation and make the best of it.
  302.  
  303. <p>This is what happens:
  304. <itemize>
  305. <item>    The kernel notices that a feature is requested that is not
  306.     resident in the kernel.
  307. <item>    The kernel sends a message to kerneld, with a symbolic
  308.     description of the requested feature.
  309. <item>    The kerneld daemon asks e.g. modprobe to load a module that
  310.     fits this symbolic description.
  311. <item>    Modprobe looks into its internal <em/alias/ translation table
  312.     to see if there is a match.  This table can be reconfigured
  313.     and expanded by having <em/alias/ lines in
  314.     <tt>/etc/conf.modules</tt>.
  315. <item>    Insmod is then asked to insert the module(s) that modprobe
  316.     has decided that the kernel needs.  Every module will be
  317.     configured according to the <tt/options/ lines in
  318.     <tt>/etc/conf.modules</tt>.
  319. <item>    Modprobe exits and kerneld tells the kernel that the request
  320.     succeded (or failed...)
  321. <item>    The kernel uses the freshly installed feature just as if it
  322.     had been configured into the kernel as a <em/resident/ part.
  323. </itemize>
  324. <p>The icing of the cake is that when an automatically installed module
  325. has been unused for a period of time (usually 1 minute), the module
  326. will be automatically removed from the kernel as well.
  327.  
  328. <p>This makes the kernel use the minimal amount of memory at any given time,
  329. making it available for more productive use than as just a placeholder for
  330. unused code.
  331.  
  332. <p>Actually, this is only a side-effect from the <em/real/ benefit of kerneld:
  333. You only have to create a minimal kernel, that is more or less independent
  334. of the actual hardware setup.  The setup of the <em/virtual/ kernel is
  335. instead controlled by a configuration file as well as the actual usage
  336. pattern of the current machine and its kernel.
  337.  
  338. <p>This should be good news for maintainers of multiple machines as well as
  339. for maintainers of distributions.
  340.  
  341. <p>To use kerneld with the least amount of <em/hassle/, you need modprobe from
  342. a release that can be considered <em/recent/ w.r.t. your kernel, and also
  343. a configuration file for modprobe (<tt>/etc/conf.modules</tt>).
  344. <p>Since modprobe already knows about most modules, the minimal configuration
  345. file could look something like this:
  346. <tscreen><verb>
  347.     alias scsi_hostadapter aha1542  # or whatever SCSI adapter you have
  348.     alias eth0 3c509        # or whatever net adapter you have
  349.  
  350.     # you might need an "options" line for some net adapters:
  351.     options 3c509 io=0x300 irq=10
  352.  
  353.     # you might also need an "options" line for some other module:
  354.     options cdu31a cdu31a_port=0x1f88 sony_pas_init=1
  355. </verb></tscreen>
  356. <p>You could add these lines as well, but they are only <em/cosmetic/:
  357. <tscreen><verb>
  358.     alias net-pf-3 off    # no ax25 module available (yet)
  359.     alias net-pf-4 off    # if you don't use the ipx module
  360.     alias net-pf-5 off    # if you don't use the appletalk module
  361. </verb></tscreen>
  362. <p>
  363. Finally, for the <em/purists/: You can name the modprobe configuration
  364. either <tt>/etc/conf.modules</tt> or
  365. <tt>/etc/modules.conf</tt>, since modprobe knows what to do in each case...
  366.  
  367.  
  368. <sect>General Kernel setup
  369. <p>
  370.     Note: you can't have both a.out <em/and/ ELF support
  371.     compiled as modules.  Otherwise, you get a nice Catch-22 when you try
  372.     to run insmod to install a.out/ELF support so you can run insmod ;-).
  373.     If you have an all-ELF system, but need a.out for the occasional
  374.     Netscape session, then you can do a.out support as a module.
  375.     Otherwise, you should probably leave it in the kernel, and if you
  376.     haven't gone ELF yet, you can probably leave out ELF compleately.
  377.  
  378. <sect1>Kernel support for a.out binaries (<tt/binfmt_aout.o/).
  379. <p><code>
  380. Load command:
  381.     /sbin/insmod binfmt_aout.o
  382.  
  383.     No module parameters.
  384. </code>
  385.  
  386.  
  387. <sect1>Kernel support for ELF binaries (<tt/binfmt_elf.o/).
  388. <p><code>
  389. Load command:
  390.     /sbin/insmod binfmt_elf.o
  391.  
  392.         No module parameters.
  393. </code>
  394.  
  395.  
  396. <sect1>Kernel support for JAVA binaries (<tt/binfmt_java.o/).              
  397. <p>
  398.   JAVA is an object oriented programming language developed by SUN;
  399.   JAVA programs are compiled into "JAVA bytecode" which can then be
  400.   interpreted by run time systems on many different operating systems.
  401.   These JAVA binaries are becoming a universal executable format. This
  402.   option allows you to run a Java binary just like any other Linux
  403.   program: by typing in its name.
  404. <code>
  405. Load command:
  406.     /sbin/insmod binfmt_java.o
  407.  
  408.         No module parameters.
  409. </code>
  410.  
  411.  
  412. <sect>Floppy and other block devices.
  413. <p>
  414. <sect1>The Floppy Disk Driver (<tt/floppy.o/).
  415. <p>
  416.     There are many floppy driver options, and they are all listed in
  417.     <tt/README.fd/ in <tt>linux/drivers/block</tt>. For detailed,
  418.     up to date, information refer directly to this file.
  419.  
  420. <p><code>
  421. Load command:
  422.     /sbin/insmod floppy.o 'floppy="<options>"'
  423.  
  424.         Option explanations below..
  425. </code>
  426.  
  427.  
  428. <p>
  429.     <tt/mask,allowed_drive_mask/ -     Sets the bitmask of allowed drives
  430.     to <tt/mask/. By default, only units
  431.     0 and 1 of each floppy controller are allowed. This is done because
  432.     certain non-standard hardware (ASUS PCI motherboards) mess up the
  433.     keyboard when accessing units 2 or 3. This option is somewhat
  434.     obsoleted by the cmos option.
  435.  
  436. <p>
  437.     <tt/all_drives/ - Sets the bitmask of allowed drives to all drives.
  438.     Use this if you have more than two drives connected to
  439.     a floppy controller.
  440.  
  441. <p>
  442.     <tt/asus_pci/ - Sets the bitmask to allow only units 0 and 1.
  443.     (The default)
  444.  
  445. <p>
  446.     <tt/daring/ - Tells the floppy driver that you have a well behaved
  447.     floppy controller.  This allows more efficient and smoother operation,
  448.     but may fail on certain controllers.
  449.     This may speed up certain operations.
  450.  
  451. <p>
  452.     <tt/0,daring/ - Tells the floppy driver that your floppy controller
  453.     should be used with caution.
  454.  
  455. <p>
  456.     <tt/one_fdc/ - 
  457.     Tells the floppy driver that you have only floppy 
  458.     controller (default)
  459.  
  460. <p>
  461.     <tt/two_fdc/ <em/or/ <tt/address,two_fdc/ - 
  462.         Tells the floppy driver that you have two floppy controllers. The
  463.         second floppy controller is assumed to be at <tt/address/. This
  464.         option is not needed if the second controller is at address
  465.         0x370, and if you use the 'cmos' option
  466.  
  467. <p>
  468.     <tt/thinkpad/ -
  469.     Tells the floppy driver that you have a Thinkpad. Thinkpads use an
  470.     inverted convention for the disk change line.
  471.  
  472. <p>
  473.     <tt/0,thinkpad/ - 
  474.     Tells the floppy driver that you don't have a Thinkpad.
  475.  
  476. <p>
  477.     <tt/omnibook/ <em/or/ <tt/nodma/ -
  478.         Tells the floppy driver not to use Dma for data transfers.
  479.         This is needed on HP Omnibooks, which don't have a workable
  480.         DMA channel for the floppy driver. This option is also useful
  481.         if you frequently get "Unable to allocate DMA memory" messages.
  482.         Indeed, dma memory needs to be continuous in physical, and is
  483.         thus harder to find, whereas non-dma buffers may be allocated
  484.         in virtual memory. However, I advise against this if you have
  485.         an FDC without a FIFO (8272A or 82072). 82072A and later are
  486.         OK. You also need at least a 486 to use nodma.
  487.         If you use nodma mode, I suggest you also set the FIFO
  488.         threshold to 10 or lower, in order to limit the number of data
  489.         transfer interrupts.
  490.  
  491. <p>
  492.     <tt/dma/ - 
  493.         Tells the floppy driver that a workable DMA channel is available
  494.         (the default).
  495.  
  496. <p>
  497.     <tt/nofifo/ -
  498.         Disables the FIFO entirely. This is needed if you get "Bus
  499.         master arbitration error" messages from your ethernet card (or
  500.         from other devices) while accessing the floppy.
  501.  
  502. <p>
  503.     <tt/fifo/ - Enables the FIFO (default)
  504.  
  505. <p>
  506.     <tt/[threshold],fifo_depth/ - 
  507.         Sets the FIFO threshold. This is mostly relevant in DMA
  508.         mode. If this is higher, the floppy driver tolerates more
  509.         interrupt latency, but it triggers more interrupts (i.e. it
  510.         imposes more load on the rest of the system). If this is
  511.         lower, the interrupt latency should be lower too (faster
  512.         processor). The benefit of a lower threshold is less
  513.         interrupts.
  514. <p>     To tune the fifo threshold, switch on over/underrun messages
  515.         using 'floppycontrol --messages'. Then access a floppy
  516.         disk. If you get a huge amount of "Over/Underrun - retrying"
  517.         messages, then the fifo threshold is too low. Try with a
  518.         higher value, until you only get an occasional Over/Underrun.
  519.         It is a good idea to compile the floppy driver as a module
  520.         when doing this tuning. Indeed, it allows to try different
  521.         fifo values without rebooting the machine for each test. Note
  522.         that you need to do 'floppycontrol --messages' every time you
  523.         re-insert the module.
  524.         Usually, tuning the fifo threshold should not be needed, as
  525.         the default (0xa) is reasonable.
  526.  
  527. <p>
  528.     <tt/[drive],[type],cmos/ - 
  529.         Sets the CMOS type of <tt/drive/ to <tt/type/. This is mandatory if
  530.         you have more than two floppy drives (only two can be
  531.         described in the physical CMOS), or if your BIOS uses
  532.         non-standard CMOS types. The CMOS types are:
  533. <code>          0 - Use the value of the physical CMOS
  534.                 1 - 5 1/4 DD
  535.                 2 - 5 1/4 HD
  536.                 3 - 3 1/2 DD
  537.                 4 - 3 1/2 HD
  538.                 5 - 3 1/2 ED
  539.                 6 - 3 1/2 ED
  540.                16 - unknown or not installed
  541. </code>
  542.     (Note: there are two valid types for ED drives. This is because 5
  543.     was initially chosen to represent floppy *tapes*, and 6 for ED drives.
  544.         AMI ignored this, and used 5 for ED drives. That's why the floppy
  545.         driver handles both)
  546.  
  547. <p>
  548.     <tt/unexpected_interrupts/ - 
  549.         Print a warning message when an unexpected interrupt is received
  550.         (default behavior)
  551.  
  552. <p>
  553.     <tt/no_unexpected_interrupts/ <em/or/ <tt/L40SX/ - 
  554.         Don't print a message when an unexpected interrupt is received. This
  555.         is needed on IBM L40SX laptops in certain video modes. (There seems
  556.         to be an interaction between video and floppy. The unexpected
  557.     interrupt only affect performance, and can safely be ignored.)
  558.  
  559.  
  560. <sect1>Loopback block device support (<tt/loop.o/).
  561. <p>
  562.   Enabling this option will allow you to mount a file as a file system.
  563.   This is useful if you want to check an ISO9660 file system before
  564.   burning the CD, or want to use floppy images without first writing
  565.   them to floppy.
  566.  
  567. <code>
  568. Load command:
  569.     /sbin/insmod loop.o
  570.  
  571.         No module parameters.
  572. </code>
  573.  
  574. <sect1>Multiple devices driver support.
  575. <p>
  576.   This driver lets you combine several harddisk partitions into one
  577.   logical block device.
  578. <p>Tools that can be used to manage md devices can be found at
  579. <tt>sweet-smoke.ufr-info-p7.ibp.fr/public/Linux/md035.tar.gz</tt>.
  580. Same location contains also a document <em/md-FAQ/.
  581.  
  582.  
  583. <sect2>Multiple device in Linear (append) mode (<tt/linear.o/).
  584. <p>
  585.   If you use this, then your multiple devices driver will be able
  586.   to use the so-called linear mode, i.e. it will combine the harddisk
  587.   partitions by simply appending one to the other.
  588. <code>
  589. Load command:
  590.         /sbin/insmod linear.o
  591.  
  592.         No module parameters.
  593. </code>
  594.  
  595. <sect2>Multiple device in RAID-0 (striped) mode (<tt/raid0.o/).
  596. <p>
  597.   If you use this, then your multiple devices driver will be able
  598.   to use the so-called raid0 mode, i.e. it will combine the harddisk
  599.   partitions into one logical device in such a fashion as to fill them
  600.   up evenly, one chunk here and one chunk there. This will increase
  601.   the throughput rate if the partitions reside on distinct disks.
  602. <code>
  603. Load command:
  604.         /sbin/insmod raid0.o
  605.  
  606.         No module parameters.
  607. </code>
  608.  
  609. <!--This does NOT yet exist, too bad..
  610. <sect2>Multiple device in RAID-1 (mirrored) mode (<tt/raid1.o/).
  611. <p><bf/NOT YET IMPLEMENTED, SORRY...../
  612.  
  613. <sect2>Multiple device in RAID-5 (parity correction) mode (<tt/raid5.o/).
  614. <p><bf/NOT YET IMPLEMENTED, SORRY...../
  615. -->
  616.  
  617. <sect1>RAM disk support (<tt/rd.o/).
  618. <p>
  619.   Enabling this option will allow you to use a portion of your RAM
  620.   memory as a block device, so that you can make filesystems on it,
  621.   read and write to it and do all the other things that normal block
  622.   devices (such as harddrives) can do.  It is usually used to load and
  623.   store a copy of a minimal root file system off of a floppy into RAM
  624.   during the initial install of Linux.
  625. <code>
  626. Load command:
  627.     /sbin/insmod rd.o
  628.  
  629.         No module parameters.
  630.     Boottime parameters available, see BootPrompt-HOWTO.
  631. </code>
  632.  
  633. <sect1>XT harddisk support (<tt/xd.o/).
  634. <p>
  635. Very old 8 bit hard disk controllers used in the IBM XT computer.
  636. No, the existence of XT disk support does <em/NOT/ mean that you
  637. can run Linux on an IBM XT :).  
  638. <code>
  639. Load command:
  640.     /sbin/insmod xd.o
  641.  
  642.         No module parameters.
  643. </code>
  644.  
  645.  
  646. <sect>General TCP/IP and Networking options.
  647. <p>
  648. <sect1>IP Tunneling (<tt/ipip.o and new_tunnel.o/).
  649. <p>
  650.   Tunneling means encapsulating data of one protocol type within
  651.   another protocol and sending it over a channel that understands the
  652.   encapsulating protocol. Two modules are necessary <tt/ipip.o/, IP/IP
  653.   protocol decoder, and <tt/new_tunnel.o/ driver, (this was previously called
  654.   <tt/tunnel.o/ and the documentation still refers to this name).
  655.   Documentation is found at
  656.   <tt>/usr/src/linux/drivers/net/README.tunnel</tt>.
  657. <code>
  658. Load commands:
  659.     /sbin/insmod ipip.o
  660.     /sbin/insmod new_tunnel.o
  661.     
  662.         No module parameters.
  663. </code>
  664.  
  665. <sect1>IP Aliasing support (<tt/ip_alias.o/).
  666. <p>
  667.   Sometimes it is useful to give several addresses to a single network
  668.   interface (= serial port or ethernet card). The most common case is
  669.   that you want to serve different WWW documents to the outside
  670.   according to which of your host names they used to connect to you.
  671. <code>
  672. Load command:
  673.     /sbin/insmod ip_alias.o
  674.  
  675.         No module parameters.
  676. </code>
  677.  
  678. <sect1>IP Reverse ARP (<tt/rarp.o/).
  679. <p><code>
  680. Load command:
  681.     /sbin/insmod rarp.o
  682.  
  683.         No module parameters.
  684. </code>
  685.  
  686. <sect1>IPX Protocol (<tt/ipx.o/).
  687. <p>
  688.   This is support for the Novell networking protocol, IPX, commonly
  689.   used for local networks of DOS and Windows machines.
  690. <p>IPX protocol is required if :
  691. <itemize>
  692. <item>    You wish to connect to Netware servers using Linux DOS
  693.     emulator <em/DOSEMU/.
  694. <item>    You wish to mount Netware volumes as Linux filesystems using
  695.     Linux Novell client <em/ncpfs/.
  696. <item>    You wish to connect to Linux server from Netware client, or 
  697.     mount Linux directories as Netware volumes.  There are two
  698.     daemons for this purpose, <em/linwared/ and <em/nwserv/.
  699. </itemize>
  700. <p>    Homesite for ncpfs is <tt>ftp.gwdg.de/pub/linux/misc/ncpfs</tt>,
  701.     but sunsite and its many mirrors will have it as well.
  702. <p>    <em/Linware/'s home site is <tt>klokan.sh.cvut.cz/pub/linux/linware</tt>,
  703. <p>    <em/nwserv/ package <em/Mars_nwe/ is also on
  704.     <tt>ftp.gwdg.de/pub/linux/misc/ncpfs</tt>.
  705.  
  706. <code>
  707. Load command:
  708.     /sbin/insmod ipx.o
  709.  
  710.         No module parameters.
  711. </code>
  712.  
  713. <sect1>Appletalk DDP (<tt/appletalk.o/).
  714. <p>
  715.   Appletalk is the way Apple computers speak to each other on a
  716.   network. EtherTalk is the name used for appletalk over ethernet and
  717.   Localtalk is appletalk over the apple serial links.
  718. <code>
  719. Load command:
  720.     /sbin/insmod appletalk.o
  721.  
  722.         No module parameters.
  723. </code>
  724.  
  725.  
  726.  
  727. <sect>SCSI Support.
  728. <p>
  729. The scsi support in the linux kernel can be modularized in a
  730. number of different ways depending upon the needs of the end user.  To
  731. understand  your options, we should first define a few terms.
  732.  
  733. <p>The scsi-core contains the core of scsi support.  Without it
  734. you can do nothing with any of the other scsi drivers.  The scsi core
  735. support can be a module (<tt/scsi_mod.o/), or it can be build into the kernel.
  736. If the core is a module, it must be the first scsi module loaded, and
  737. if you unload the modules, it will have to be the last one unloaded.
  738.  
  739. <p>The individual upper and lower level drivers can be loaded in any
  740. order once the scsi core is present in the kernel (either compiled in
  741. or loaded as a module).  The disk driver (<tt/sd_mod.o/), cdrom driver
  742. (<tt/sr_mod.o/),
  743. tape driver (<tt/st.o/) and scsi generics driver (<tt/sg.o/) represent the upper level
  744. drivers to support the various assorted devices which can be controlled.
  745. You can for example load the tape driver to use the tape drive, and then
  746. unload it once you have no further need for the driver (and release the
  747. associated memory).
  748.  
  749. <p>The lower level drivers are the ones that support the
  750. individual cards that are supported for the hardware platform that you
  751. are running under.  Examples are <tt/aha1542.o/ to drive Adaptec 1542
  752. cards.
  753.  
  754. <sect1> SCSI Required Core Support.
  755.  
  756. <sect2> SCSI Core support (<tt/scsi_mod.o/).
  757. <p><code>
  758. Load command:
  759.     /sbin/insmod scsi_mod.o
  760.  
  761.         No module parameters.
  762. </code>
  763.  
  764. <sect1> SCSI High level support.
  765.  
  766. <sect2> SCSI Disk support (<tt/sd_mod.o/).
  767. <p><code>
  768. Load command:
  769.     /sbin/insmod sd_mod.o
  770.  
  771.         No module parameters.
  772. </code>
  773.  
  774. <sect2> SCSI Tape support (<tt/st.o/).
  775. <p><code>
  776. Load command:
  777.     /sbin/insmod st.o
  778.  
  779.         No module parameters.
  780.     Boottime parameters available, see BootPrompt-HOWTO.
  781. </code>
  782.  
  783. <sect2> SCSI CDrom support (<tt/sr_mod.o/).
  784. <p><code>
  785. Load command:
  786.     /sbin/insmod sr_mod.o
  787.  
  788.         No module parameters.
  789. </code>
  790.  
  791. <sect2> SCSI generic support (<tt/sg.o/).
  792. <p><code>
  793. Load command:
  794.     /sbin/insmod sg.o
  795.  
  796.         No module parameters.
  797. </code>
  798.  
  799. <sect1> SCSI Low Level Device Driver Support.
  800. <p>
  801.     Most SCSI-card drivers don't support module parameters, they do
  802.     generally <em/autoprobe/ for card settings.  Do read the SCSI-HOWTO
  803.     document and README files in <tt>/usr/src/linux/drivers/scsi</tt> to
  804.     to find out about your hardware.  If your card is located in some
  805.     unconventional i/o-address you must load the driver permanently
  806.     into the kernel and use Boottime options, see BootPrompt-HOWTO.
  807.     Optionally you can twiddle the Source and recompile.
  808.  
  809. <sect2>7000FASST SCSI support (<tt/wd7000.o/),
  810. <p><code>
  811. Load command:
  812.         /sbin/insmod wd7000.o
  813.  
  814.         No module parameters.
  815.         Autoprobes the card, requires installed BIOS.
  816.     Boottime parameters available, see BootPrompt-HOWTO.
  817. </code>
  818.  
  819. <sect2>Adaptec AHA152X/2825 support (<tt/aha154x.o/).
  820. <p><code>
  821. Load command:
  822.         /sbin/insmod aha154x.o
  823.  
  824.         No module parameters.
  825.     Autoprobes the card, requires installed BIOS.
  826.         Boottime parameters available, see BootPrompt-HOWTO.
  827. </code>
  828.  
  829. <sect2>Adaptec AHA1542 support (<tt/aha1542.o/).
  830. <p><code>
  831. Load command:
  832.     /sbin/insmod aha1542.o
  833.  
  834.         No module parameters.
  835.     Autoprobes card at 0x330 and 0x334 only.
  836.     Boottime parameters available, see BootPrompt-HOWTO.
  837. </code>
  838.  
  839. <sect2>Adaptec AHA1740 EISA support (<tt/aha1740.o/).
  840. <p><code>
  841. Load command:
  842.         /sbin/insmod aha1740.o
  843.  
  844.         No module parameters.
  845.     Autoprobes the card.
  846. </code>
  847.  
  848. <sect2>Adaptec AHA274X/284X/294X support (<tt/aic7xxx.o/).
  849. <p><code>
  850. Load command:
  851.         /sbin/insmod aic7xxx.o
  852.  
  853.         No module parameters.
  854.     Autoprobes the card, BIOS must be enabled.
  855.         Boottime parameters available, see BootPrompt-HOWTO.
  856. </code>
  857.  
  858. <sect2>AdvanSys SCSI support (<tt/advansys.o/).
  859. <p><code>
  860. Load command:
  861.         /sbin/insmod advansys.o [parameters]
  862.  
  863.     asc_iopflag=1            enable=1, disable=0 port scanning
  864.     asc_ioport=0x110,0x330        ports to scan
  865.     asc_dbglvl=1            debugging level
  866.                            0: Errors Only
  867.                            1: High-Level Tracing
  868.                            2-N: Verbose Tracing
  869.  
  870.         Boottime parameters available, see BootPrompt-HOWTO.
  871. </code>
  872.  
  873. <sect2>Always IN2000 SCSI support (<tt/in2000.o/).
  874. <p><code>
  875. Load command:
  876.         /sbin/insmod in2000.o
  877.  
  878.         No module parameters.
  879.     Autoprobes the card, BIOS not required.
  880. </code>
  881.  
  882. <sect2>BusLogic SCSI support (<tt/BusLogic.o/).
  883. <p>
  884.     The list of supported BusLogic cards is <em/long/.
  885.     Read <tt>usr/src/linux/drivers/scsi/README.BusLogic</tt> to
  886.     get the total picture.
  887. <code>
  888. Load command:
  889.     /sbin/insmod BusLogic.o
  890.  
  891.         No module parameters.
  892.     Boottime parameters available, see BootPrompt-HOWTO.
  893. </code>
  894.  
  895. <sect2>DTC3180/3280 SCSI support (<tt/dtc.o/).
  896. <p><code>
  897. Load command:
  898.         /sbin/insmod dtc.o
  899.  
  900.         No module parameters.
  901.     Autoprobes the card.
  902.         Boottime parameters available, see BootPrompt-HOWTO.
  903. </code>
  904.  
  905. <sect2>EATA ISA/EISA (DPT PM2011/021/012/022/122/322) support (<tt/eata.o/).
  906. <p><code>
  907. Load command:
  908.         /sbin/insmod eata.o
  909.  
  910.         No module parameters.
  911.         Boottime parameters available, see BootPrompt-HOWTO.
  912. </code>
  913.  
  914. <sect2>EATA-DMA (DPT, NEC, AT&T, SNI, AST, Olivetti, Alphatronix) (<tt/eata_dma.o/).
  915. <p>
  916.     Includes DPT Smartcache, Smartcache III and SmartRAID.
  917. <code>
  918. Load command:
  919.         /sbin/insmod eata_dma.o
  920.  
  921.         No module parameters.
  922.     Autoprobe works in all configurations.
  923. </code>
  924.  
  925. <sect2>EATA-PIO (old DPT PM2001, PM2012A) support (<tt/eata_pio.o/).
  926. <p><code>
  927. Load command:
  928.         /sbin/insmod eata_pio.o
  929.  
  930.         No module parameters.
  931. </code>
  932.  
  933. <sect2>Future Domain 16xx SCSI support (<tt/fdomain.o/).
  934. <p><code>
  935. Load command:
  936.         /sbin/insmod fdomain.o
  937.  
  938.         No module parameters.
  939.     Autoprobes the card, requires installed BIOS.
  940. </code>
  941.  
  942. <sect2>Generic NCR5380/53c400 SCSI support (<tt/NCR5380.o/).
  943. <p><code>
  944. Load command:
  945.         /sbin/insmod NCR5380.o
  946.  
  947.         ncr_irq=xx    the interrupt
  948.         ncr_addr=xx    the port or base address (for port or
  949.                 memory mapped, resp.)
  950.         ncr_dma=xx    the DMA
  951.         ncr_5380=1    to set up for a NCR5380 board
  952.         ncr_53c400=1    to set up for a NCR53C400 board
  953.  
  954.     modprobe g_NCR5380 ncr_irq=5 ncr_addr=0x350 ncr_5380=1
  955.      - for a port mapped NCR5380 board or
  956.  
  957.     modprobe g_NCR5380 ncr_irq=255 ncr_addr=0xc8000 ncr_53c400=1
  958.      - for a memory mapped NCR53C400 board with interrupts disabled.
  959.  
  960.     (255 should be specified for no or DMA interrupt,
  961.      254 to autoprobe for an IRQ line if overridden on the command line.)
  962.  
  963.         Boottime parameters available, see BootPrompt-HOWTO.
  964. </code>
  965.  
  966. <sect2>NCR53c406a SCSI support (<tt/NCR53c406a.o/).
  967. <p><code>
  968. Load command:
  969.         /sbin/insmod NCR53c406a.o
  970.  
  971.         No module parameters.
  972.         Boottime parameters available, see BootPrompt-HOWTO.
  973. </code>
  974.  
  975. <sect2>NCR53c7,8xx SCSI support (<tt/53c7,8xx.o/).
  976. <p><code>
  977. Load command:
  978.         /sbin/insmod 53c7,8xx.o
  979.  
  980.         No module parameters.
  981.     Autoprobes the card, requires installed BIOS.
  982.         Boottime parameters available, see BootPrompt-HOWTO.
  983. </code>
  984.  
  985. <sect2>IOMEGA Parallel Port ZIP drive SCSI support (<tt/ppa.o/).
  986. <p>
  987. Check file <tt>/usr/src/linux/drivers/scsi/README.ppa</tt> for detailed information.
  988. <code>
  989. Load command:
  990.     /sbin/insmod ppa.o ppa_base=0x378 ppa_nybble=1
  991.  
  992.     Here are the parameters and their functions:
  993.  
  994.     Variable        Default    Description
  995.  
  996.     ppa_base        0x378   The base address of PPA's parallel port.
  997.     ppa_speed_high  1       Microsecond i/o delay used in data transfers
  998.     ppa_speed_low   6       Microsecond delay used in other operations
  999.     ppa_nybble      0       1 to force the driver to use 4-bit mode.
  1000.  
  1001. </code>
  1002.  
  1003. <sect2>PAS16 SCSI support(<tt/pas16.o/).
  1004. <p><code>
  1005. Load command:
  1006.         /sbin/insmod pas16.o
  1007.  
  1008.         No module parameters.
  1009.     Autoprobes the card, BIOS not required.
  1010.         Boottime parameters available, see BootPrompt-HOWTO.
  1011. </code>
  1012.  
  1013. <sect2>Qlogic FAS SCSI support (<tt/qlogicfas.o/).
  1014. <p><code>
  1015. Load command:
  1016.         /sbin/insmod qlogicfas.o
  1017.  
  1018.         No module parameters.
  1019.         Boottime parameters available, see BootPrompt-HOWTO.
  1020. </code>
  1021.  
  1022. <sect2>Qlogic ISP SCSI support (<tt/qlogicisp.o/).
  1023. <p>
  1024. Requires firmware.
  1025. <code>
  1026. Load command:
  1027.         /sbin/insmod qlogicisp.o
  1028.  
  1029.         No module parameters.
  1030.         Boottime parameters available, see BootPrompt-HOWTO.
  1031. </code>
  1032.  
  1033. <sect2>Seagate ST-02 and Future Domain TMC-8xx SCSI support
  1034. (<tt/seagate.o/).
  1035. <p><code>
  1036. Load command:
  1037.         /sbin/insmod seagate.o
  1038.  
  1039.         No module parameters.
  1040.     Autoprobes for address only, irq fixed at 5.
  1041.     Requires installed BIOS.
  1042.         Boottime parameters available, see BootPrompt-HOWTO.
  1043. </code>
  1044.  
  1045. <sect2>Trantor T128/T128F/T228 SCSI support (<tt/t128.o/).
  1046. <p><code>
  1047. Load command:
  1048.         /sbin/insmod t128.o
  1049.  
  1050.         No module parameters.
  1051.     Autoprobes the card, requires installed BIOS.
  1052.         Boottime parameters available, see BootPrompt-HOWTO.
  1053. </code>
  1054.  
  1055. <sect2>UltraStor 14F/34F support (<tt/u14-34f.o/).
  1056. <p><code>
  1057. Load command:
  1058.     /sbin/insmod u14-34f.o
  1059.  
  1060.         No module parameters.
  1061.     Autoprobes the card, NOT 0x310 port, BIOS not required.
  1062.     Boottime parameters available, see BootPrompt-HOWTO.
  1063. </code>
  1064.  
  1065. <sect2>UltraStor SCSI support (<tt/ultrastor.o/).
  1066. <p><code>
  1067. Load command:
  1068.         /sbin/insmod ultrastor.o
  1069.  
  1070.         No module parameters.
  1071.         Boottime parameters available, see BootPrompt-HOWTO.
  1072. </code>
  1073.  
  1074.  
  1075.  
  1076. <sect>Network device support
  1077. <p>
  1078.  
  1079. <sect1>Required and/or optional lowlevel modules.
  1080. <p>
  1081.  
  1082. <sect2>Optional BSD compressor for PPP (<tt/bsd_comp.o/).
  1083. <p><code>
  1084. Load command:
  1085.         /sbin/insmod bsd_comp.o
  1086.  
  1087.         No module parameters.
  1088.  
  1089.     Depends on ppp.o
  1090. </code>
  1091.  
  1092. <sect2>SLHC compressor for PPP (<tt/slhc.o/).
  1093. <p>
  1094.     Routines to compress and uncompress tcp packets (for transmission
  1095.     over low speed serial lines).
  1096. <p>    Required by SLIP and PPP (also ISDN-PPP) protocols.
  1097. <code>
  1098. Load command:
  1099.         /sbin/insmod slhc.o
  1100.  
  1101.         No module parameters.
  1102. </code>
  1103.  
  1104. <sect2>A general NS8390 ethernet driver core for linux.(<tt/8390.o/).
  1105. <p>
  1106.   This is the chip-specific code for many 8390-based ethernet adaptors.
  1107.   This is not a complete driver, it must be combined with board-specific
  1108.   code such as <tt/ne.o, wd.o, 3c503.o/, etc.
  1109. <code>
  1110. Load command:
  1111.         /sbin/insmod 8390.o
  1112.  
  1113.         No module parameters.
  1114. </code>
  1115.  
  1116.  
  1117. <sect1>Dummy net driver support (<tt/dummy.o/).
  1118. <p>
  1119.   This is essentially a bit-bucket device (i.e. traffic you send to
  1120.   this device is consigned into oblivion) with a configurable IP
  1121.   address. It is most commonly used in order to make your currently
  1122.   inactive SLIP address seem like a real address for local
  1123.   programs.
  1124. <code>
  1125. Load command:
  1126.     /sbin/insmod dummy.o
  1127.  
  1128.         No module parameters.
  1129. </code>
  1130.  
  1131. <sect1>EQL (serial line load balancing) support (<tt/eql.o/). 
  1132. <p>
  1133.   If you have two serial connections to some other computer (this
  1134.   usually requires two modems and two telephone lines) and you use
  1135.   SLIP (= the protocol for sending internet traffic over telephone
  1136.   lines) or PPP (= a better SLIP) on them, you can make them behave
  1137.   like one double speed connection using this driver.
  1138. <code>
  1139. Load command:
  1140.     /sbin/insmod eql.o
  1141.  
  1142.         No module parameters.
  1143. </code>
  1144.  
  1145. <sect1>Frame relay DLCI support (<tt/dlci.o/).
  1146. <p>
  1147.   This is support for the frame relay protocol; frame relay is a fast
  1148.   low-cost way to connect to a remote internet access provider or to
  1149.   form a private wide area network. The one physical line from your
  1150.   box to the local "switch" (i.e. the entry point to the frame relay
  1151.   network) can carry several logical point-to-point connections to
  1152.   other computers connected to the frame relay network. For a general
  1153.   explanation of the protocol, check out
  1154.   <tt>http://frame-relay.indiana.edu/4000/4000index.html</tt> on the WWW.
  1155.   To use frame relay, you need supporting hardware (FRAD) and certain
  1156.   programs from the net-tools package as explained in
  1157.   <tt>Documentation/networking/framerelay.txt</tt>.
  1158. <code>
  1159. Load command:
  1160.     /sbin/insmod dlci.o
  1161.  
  1162.         No module parameters.
  1163. </code>
  1164.  
  1165. <sect1>Sangoma S502A FRAD support (<tt/sdla.o/).
  1166. <p>
  1167.   This is a driver for the Sangoma S502A, S502E and
  1168.   S508 Frame Relay Access Devices. These are multi-protocol
  1169.   cards, but only frame relay is supported by the driver at this
  1170.   time. Please read <tt>Documentation/networking/framerelay.txt</tt>.
  1171. <code>
  1172. Load command:
  1173.         /sbin/insmod sdla.o
  1174.  
  1175.         No module parameters.
  1176.  
  1177.     Depends on dlci.o
  1178. </code>
  1179.  
  1180.  
  1181. <sect1>PLIP (parallel port) support (<tt/plip.o/).
  1182. <p>
  1183.   PLIP (Parallel Line Internet Protocol) is used to create a mini
  1184.   network consisting of two (or, rarely, more) local machines. The
  1185.   parallel ports (the connectors at the computers with 25 holes) are
  1186.   connected using "null printer" or "Turbo Laplink" cables which can
  1187.   transmit 4 bits at a time or using special PLIP cables, to be used
  1188.   on bidirectional parallel ports only, which can transmit 8 bits at a
  1189.   time (you can find the wiring of these cables in
  1190.   <tt>drivers/net/README?.plip</tt>). The cables can be up to 15m long. This
  1191.   works also if one of the machines runs DOS/Windows and has some PLIP
  1192.   software installed, e.g. the Crynwr PLIP packet driver
  1193.   <tt>http://sunsite.cnam.fr/packages/Telnet/PC/msdos/misc/pktdrvr.txt</tt>
  1194.   and winsock or NCSA's telnet.
  1195. <code>
  1196. Load command:
  1197.         /sbin/insmod plip.o io=0x378 irq=7
  1198.  
  1199.         io = 0
  1200.         irq = 0         (by default, uses IRQ 5 for port at 0x3bc,
  1201.                       IRQ 7 for port at 0x378,
  1202.                       and IRQ 2 for port at 0x278)
  1203.         (Probes ports: 0x278, 0x378, 0x3bc)
  1204. </code>
  1205.  
  1206. <sect1>PPP (point-to-point) support (<tt/ppp.o/).
  1207. <p>
  1208.   To use PPP you need an additional program called pppd as described
  1209.   in <tt>Documentation/networking/ppp.txt</tt> and in the PPP-HOWTO,
  1210.   available from <tt>sunsite.unc.edu:/pub/Linux/docs/HOWTO</tt>.
  1211. <code>
  1212. Load command:
  1213.         /sbin/insmod ppp.o
  1214.  
  1215.         No module parameters.
  1216.  
  1217.     Depends on slhc.o
  1218.     Also depends on serial.o, this is not detected automatically,
  1219.     so serial.o must be loaded manually.
  1220. </code>
  1221.  
  1222.  
  1223. <sect1>SLIP (serial line) support (<tt/slip.o/).
  1224. <p>
  1225.   SLIP (Serial Line Internet Protocol) is the protocol used to send
  1226.   Internet traffic over telephone lines or serial cables (also known as
  1227.   nullmodems).
  1228. <code>
  1229. Load command:
  1230.         /sbin/insmod slip.o
  1231.  
  1232.         slip_maxdev = 256 (default value from SL_NRUNIT on slip.h)
  1233.  
  1234.     Depends on slhc.o
  1235.         Also depends on serial.o, this is not detected automatically,
  1236.         so serial.o must be loaded manually.
  1237. </code>
  1238.  
  1239.  
  1240. <sect1>Amateur Radio and wireless network interfaces.
  1241.  
  1242. <sect2>BAYCOM ser12 and par96 kiss emulation driver for AX.25
  1243. (<tt/baycom.o/).
  1244. <p>
  1245.   This is a driver for Baycom style simple amateur radio
  1246.   modems that connect to either a serial interface or a parallel
  1247.   interface. The driver supports the ser12 and par96 designs. To
  1248.   configure the driver, use the setbaycom utility available from
  1249.   http://www.ife.ee.ethz.ch/˜sailer/ham/ham.html#lnxbay. For
  1250.   informations on the modems, see <tt>http://www.baycom.de</tt> and
  1251.   <tt>drivers/char/README.baycom</tt>.
  1252. <code>
  1253. Load command:
  1254.       /sbin/insmod baycom.o modem=1 iobase=0x3f8 irq=4 options=1
  1255.   
  1256.      major    major number the driver should use; default 60
  1257.      modem    modem type of the first channel (minor 0); 1=ser12,
  1258.          2=par96/par97, any other value invalid
  1259.     iobase    base address of the port; common values are for ser12 0x3f8,
  1260.          0x2f8, 0x3e8, 0x2e8 and for par96/par97 0x378, 0x278, 0x3bc
  1261.      irq    interrupt line of the port; common values are for ser12 3,4
  1262.          and for par96/par97 7
  1263.      options    0=use hardware DCD, 1=use software DCD
  1264. </code>
  1265.  
  1266. <sect2>STRIP (Metricom starmode radio IP) <tt/strip.o/).
  1267. <p>
  1268.   STRIP is a radio protocol developed for the MosquitoNet project
  1269.   (http://mosquitonet.stanford.edu/) to send Internet traffic using
  1270.   Metricom radios.  Metricom radios are small, battery powered,
  1271.   100kbit/sec packet radio transceivers, about the size and weight of
  1272.   a cellular telephone.  (You may also have heard them called
  1273.   "Metricom modems" but we avoid the term "modem" because it misleads
  1274.   many people into thinking that you can plug a Metricom modem into a
  1275.   phone line and use it as a modem.)  You can use STRIP on any Linux
  1276.   machine with a serial port, although it is obviously most useful for
  1277.   people with laptop computers.
  1278. <code>
  1279. Load command:
  1280.         /sbin/insmod strip.o
  1281.  
  1282.         No module parameters.
  1283. </code>
  1284.  
  1285. <sect2>WaveLAN support (<tt/wavelan.o/).
  1286. <p>
  1287.   These are cards for wireless ethernet-like networking. Supported are
  1288.   AT&T GIS and NCR WaveLAN cards. 
  1289. <code>
  1290. Load command:
  1291.         /sbin/insmod wavelan.o
  1292.  
  1293.         io = 0x390      (Settable, but change not recommended)
  1294.         irq = 0         (Not honoured, if changed..)
  1295. </code>
  1296.  
  1297. <sect2>WIC Radio IP bridge (<tt/wic.o/).
  1298. <p>
  1299.   Support for the WIC parallel port radio bridge.
  1300. <code>
  1301. Load command:
  1302.         /sbin/insmod wic.o
  1303.  
  1304.     It appears that devices 'wic0', 'wic1' and 'wic2' have direct
  1305.     relations to corresponding 'lpx' ports.
  1306. </code>
  1307.  
  1308. <sect2>Z8530 SCC kiss emulation driver for AX.25 (<tt/scc.o/).
  1309. <p>
  1310.   These cards are used to connect your Linux box to an amateur radio
  1311.   in order to communicate with other computers.  If you want to use
  1312.   this, read <tt>Documentation/networking/z8530drv.txt</tt> and the HAM-HOWTO.
  1313. <code>
  1314. Load command:
  1315.         /sbin/insmod scc.o
  1316.  
  1317.     No module parameters.
  1318. </code>
  1319.  
  1320.  
  1321. <sect1>3COM Ethernet cards.
  1322. <p>
  1323.  
  1324. <sect2>3c501 support (<tt/3c501.o/).
  1325. <p><code>
  1326. Load command:
  1327.         /sbin/insmod 3c501.o
  1328.  
  1329.         io  = 0x280     IO base address
  1330.         irq = 5         IRQ
  1331.         (Probes ports:  0x280, 0x300)
  1332. </code>
  1333.  
  1334. <sect2>3c503 support (<tt/3c503.o/).
  1335. <p><code>
  1336. Load command:
  1337.         /sbin/insmod 3c503.o
  1338.  
  1339.         io = 0          (It will complain if you don't supply an "io=0xNNN")
  1340.         irq = 0         (IRQ software selected by driver using autoIRQ)
  1341.         xcvr = 0        (Use xcvr=1 to select external transceiver.)
  1342.         (Probes ports: 0x300, 0x310, 0x330, 0x350, 0x250, 0x280, 0x2A0,0x2E0)
  1343.  
  1344.     Depends on 8390.o
  1345. </code>
  1346.  
  1347. <sect2>3c505 support (<tt/3c505.o/).
  1348. <p><code>
  1349. Load command:
  1350.         /sbin/insmod 3c505.o
  1351.  
  1352.         io = 0x300
  1353.         irq = 0
  1354.         (Probes ports: 0x300, 0x280, 0x310)
  1355. </code>
  1356.  
  1357. <sect2>3c507 support (<tt/3c507.o/).
  1358. <p><code>
  1359. Load command:
  1360.         /sbin/insmod 3c507.o
  1361.  
  1362.         io = 0x300
  1363.         irq = 0
  1364.         (Probes ports: 0x300, 0x320, 0x340, 0x280)
  1365. </code>
  1366.  
  1367. <sect2>3c509/3c579 support (<tt/3c509.o/).
  1368. <p><code>
  1369. Load command:
  1370.         /sbin/insmod 3c509.o
  1371.  
  1372.         io = 0
  1373.         irq = 0
  1374.         ( Module load-time probing Works reliably only on EISA, ISA ID-PROBE
  1375.           IS NOT RELIABLE!  Compile this driver statically into kernel for
  1376.           now, if you need it auto-probing on an ISA-bus machine. )
  1377. </code>
  1378.  
  1379. <sect2>3c590 series "Vortex" support (<tt/3c59x.o/).
  1380. <p>Provides support for folloving cards :
  1381. <itemize>
  1382. <item>3c590 Vortex 10Mbps.
  1383. <item>3c595 Vortex 100baseTX.
  1384. <item>3c595 Vortex 100baseT4.
  1385. <item>3c595 Vortex 100base-MII.
  1386. <item>EISA Vortex 3c597.
  1387. </itemize>
  1388. <code>
  1389. Load command:
  1390.         /sbin/insmod 3c59x.o debug=1 options=0,,12
  1391.  
  1392.     This sets the debug message level to minimal messages,
  1393.     sets the first card to the 10baseT transceiver, the second
  1394.     to the EEPROM-set transceiver, and the third card to operate
  1395.     in full-duplex mode using its 100baseTx transceiver.
  1396.     (Note: card ordering is set by the PCI BIOS.)
  1397.  
  1398.     Possible media type settings
  1399.             0       10baseT
  1400.             1       10Mbs AUI
  1401.             2       undefined
  1402.             3       10base2 (BNC)
  1403.             4       100base-TX
  1404.             5       100base-FX
  1405.             6       MII (not yet available)
  1406.             7       <Use default setting>
  1407.  
  1408.             8       Full-duplex bit
  1409.                 8    10baseT full-duplex
  1410.                 12    100baseTx full-duplex
  1411.             16      Bus-master enable bit (experimental use only!)
  1412.  
  1413.     Details of the device driver implementation are at the top of
  1414.     the source file.
  1415. </code>
  1416.  
  1417. <sect1>Western Digital/SMC Ethernet cards.
  1418. <p>
  1419.  
  1420. <sect2>WD80*3 support (<tt/wd.o/).
  1421. <p><code>
  1422. Load command:
  1423.         /sbin/insmod wd.o
  1424.  
  1425.         io = 0        (It will complain if you don't supply an "io=0xNNN")
  1426.         irq = 0        (IRQ val. read from EEPROM, ancient cards use autoIRQ)
  1427.         mem = 0         (Force shared-memory on address 0xC8000, or whatever..)
  1428.         mem_end = 0     (Force non-std. mem. size via supplying mem_end val.)
  1429.                         (eg. for 32k WD8003EBT, use mem=0xd0000 mem_end=0xd8000
  1430.         (Probes ports:  0x300, 0x280, 0x380, 0x240)
  1431.  
  1432.         Depends on 8390.o
  1433. </code>
  1434.  
  1435. <sect2>SMC Ultra/EtherEZ support (<tt/smc-ultra.o/).
  1436. <p><code>
  1437. Load command:
  1438.         /sbin/insmod smc-ultra.o
  1439.  
  1440.         io = 0          (It will complain if you don't supply an "io=0xNNN")
  1441.         irq = 0         (IRQ val. read from EEPROM)
  1442.         (Probes ports:  0x200, 0x220, 0x240, 0x280, 0x300, 0x340, 0x380)
  1443.  
  1444.         Depends on 8390.o
  1445. </code>
  1446.  
  1447. <sect2>SMC 9194 support (<tt/smc9194.o/).
  1448. <p>This is a driver for SMC's 9000 series of Ethernet cards.
  1449. <code>
  1450. Load command:
  1451.         /sbin/insmod smc9194.o
  1452.  
  1453.     io = 0        for the base address
  1454.     irq = 0        for the IRQ
  1455.     ifport = 0    for autodetect, 1 for TP, 2 for AUI ( or 10base2 )
  1456.  
  1457.     Probes ports:     0x200, 0x220, 0x240, 0x260, 0x280, 0x2A0, 0x2C0, 0x2E0,
  1458.             0x300, 0x320, 0x340, 0x360, 0x380, 0x3A0, 0x3C0, 0x3E0
  1459.  
  1460.     Debug level setable in smc9194.c driver code.
  1461. </code>
  1462.  
  1463. <sect1>Other Ethernet cards.
  1464. <p>
  1465.  
  1466. <sect2>AT1700 support (<tt/at1700.o/).
  1467. <p><code>
  1468. Load command:
  1469.         /sbin/insmod at1700.o
  1470.  
  1471.         io = 0x260
  1472.         irq = 0
  1473.  
  1474.         (Probes ports: 0x260, 0x280, 0x2A0, 0x240, 0x340, 0x320, 0x380, 0x300)
  1475. </code>
  1476.  
  1477. <sect2>Cabletron E21xx support (<tt/e2100.o/).
  1478. <p><code>
  1479. Load command:
  1480.         /sbin/insmod e2100.o
  1481.  
  1482.         io = 0          (It will complain if you don't supply an "io=0xNNN")
  1483.         irq = 0         (IRQ software selected by driver)
  1484.         mem = 0         (Override default shared memory start of 0xd0000)
  1485.         xcvr = 0        (Use xcvr=1 to select external transceiver.)
  1486.         (Probes ports: 0x300, 0x280, 0x380, 0x220)
  1487.  
  1488.         Depends on 8390.o
  1489. </code>
  1490.  
  1491. <sect2>DEPCA, DE10x, DE200, DE201, DE202, DE422 support (<tt/depca.o/).
  1492. <p><code>
  1493. Load command:
  1494.         /sbin/insmod depca.o
  1495.  
  1496.         io = 0x200
  1497.         irq = 7
  1498.         (Probes ports:  ISA:  0x300, 0x200;
  1499.                         EISA: 0x0c00            )
  1500. </code>
  1501.  
  1502. <sect2>EtherWORKS 3 (DE203, DE204, DE205) support (<tt/ewrk3.o/).
  1503. <p><code>
  1504. Load command:
  1505.         /sbin/insmod ewrk3.o
  1506.  
  1507.         io = 0x300
  1508.         irq = 5
  1509.         (With module no autoprobing!
  1510.          On EISA-bus does EISA probing.
  1511.          Static linkage probes ports on ISA bus:
  1512.                 0x100, 0x120, 0x140, 0x160, 0x180, 0x1A0, 0x1C0,
  1513.                 0x200, 0x220, 0x240, 0x260, 0x280, 0x2A0, 0x2C0, 0x2E0,
  1514.                 0x300,        0x340, 0x360, 0x380, 0x3A0, 0x3C0)
  1515. </code>
  1516.  
  1517. <sect2>EtherExpress 16 support (<tt/eexpress.o/).
  1518. <p><code>
  1519. Load command:
  1520.         /sbin/insmod eexpress.o
  1521.  
  1522.         io = 0x300
  1523.         irq = 0         (IRQ value read from EEPROM)
  1524.         (Probes ports: 0x300, 0x270, 0x320, 0x340)
  1525. </code>
  1526.  
  1527. <sect2>EtherExpressPro support (<tt/eepro.o/).
  1528. <p>
  1529. <p><code>
  1530. Load command:
  1531.         /sbin/insmod eepro.o
  1532.  
  1533.         io = 0x200
  1534.         irq = 0
  1535.         (Probes ports: 0x200, 0x240, 0x280, 0x2C0, 0x300, 0x320, 0x340, 0x360)
  1536. </code>
  1537.  
  1538. <sect2>Fujitsu FMV-181/182/183/184 support (<tt/fmv18x.o/).
  1539. <p><code>
  1540. Load command:
  1541.         /sbin/insmod fmv18x.o
  1542.  
  1543.         io = 0x220    for the base address
  1544.         irq = 0        for the IRQ
  1545.  
  1546.     Probes ports: 0x220, 0x240, 0x260, 0x280, 0x2a0, 0x2c0, 0x300, 0x340
  1547. </code>
  1548.  
  1549. <sect2>HP PCLAN+ (27247B and 27252A) support (<tt/hp-plus.o/).
  1550. <p><code>
  1551. Load command:
  1552.         /sbin/insmod hp-plus.o
  1553.  
  1554.         io = 0          (It will complain if you don't supply an "io=0xNNN")
  1555.         irq = 0         (IRQ read from configuration register)
  1556.         (Probes ports: 0x200, 0x240, 0x280, 0x2C0, 0x300, 0x320, 0x340)
  1557.  
  1558.         Depends on 8390.o
  1559. </code>
  1560.  
  1561. <sect2>HP PCLAN (27245 and other 27xxx series) support (<tt/hp.o/).
  1562. <p><code>
  1563. Load command:
  1564.         /sbin/insmod hp.o
  1565.  
  1566.         io = 0          (It will complain if you don't supply an "io=0xNNN")
  1567.         irq = 0         (IRQ software selected by driver using autoIRQ)
  1568.         (Probes ports: 0x300, 0x320, 0x340, 0x280, 0x2C0, 0x200, 0x240)
  1569.  
  1570.         Depends on 8390.o
  1571. </code>
  1572.  
  1573. <sect2>HP 10/100VG PCLAN (ISA, EISA, PCI) support (<tt/hp100.o/).
  1574. <p><code>
  1575. Load command:
  1576.         /sbin/insmod hp100.o
  1577.  
  1578.     hp100_port = 0 (IO-base address)
  1579.  
  1580.         (Does EISA-probing, if on EISA-slot;
  1581.     On ISA-bus probes all ports from 0x100 thru to 0x3E0
  1582.     in increments of 0x020)
  1583. </code>
  1584.  
  1585. <sect2>ICL EtherTeam 16i/32 support (<tt/eth16i.o/).
  1586. <p><code>
  1587. Load command:
  1588.         /sbin/insmod eth16i.o
  1589.  
  1590.         io = 0x2a0    (It will complain if you don't supply an "io=0xNNN")
  1591.         irq = 0        (IRQ software selected by driver using autoIRQ)
  1592.  
  1593.     Probed ports on eth16i card :
  1594.     0x260, 0x280, 0x2A0, 0x240, 0x340, 0x320, 0x380, 0x300
  1595.  
  1596.     Probed ports in eth32i card :
  1597.     0x1000, 0x2000, 0x3000, 0x4000, 0x5000, 0x6000, 0x7000, 0x8000,
  1598.     0x9000, 0xA000, 0xB000, 0xC000, 0xD000, 0xE000, 0xF000
  1599. </code>
  1600.  
  1601. <sect2>NE2000/NE1000 support (<tt/ne.o/).
  1602. <p><code>
  1603. Load command:
  1604.         /sbin/insmod ne.o
  1605.  
  1606.         io = 0          (Explicitly *requires* an "io=0xNNN" value)
  1607.         irq = 0         (Tries to determine configured IRQ via autoIRQ)
  1608.         (Probes ports: 0x300, 0x280, 0x320, 0x340, 0x360)
  1609.  
  1610.         Depends on 8390.o
  1611. </code>
  1612.  
  1613. <sect2>NI5210 support (<tt/ni52.o/).
  1614. <p><code>
  1615. Load command:
  1616.         /sbin/insmod ni52.o
  1617.  
  1618.     io=0x360
  1619.     irq=9
  1620.     memstart=0xd0000
  1621.     memend=0xd4000
  1622.  
  1623.     Don't use autoprobing, io=0
  1624. </code>
  1625.  
  1626.  
  1627. <sect1>EISA, VLB, PCI and on board controllers
  1628. <p>
  1629.  
  1630. <sect2>Ansel Communications EISA 3200 support (<tt/ac3200.o/).
  1631. <p>
  1632. <p><code>
  1633. Load command:
  1634.         /sbin/insmod ac3200.o
  1635.  
  1636.     As this is an EISA board, Autoprobe should work.
  1637.  
  1638.         Depends on 8390.o
  1639. </code>
  1640.  
  1641. <sect2>Apricot Xen-II on board ethernet (<tt/apricot.o/).
  1642. <p><code>
  1643. Load command:
  1644.         /sbin/insmod apricot.o
  1645.  
  1646.         io = 0x300  (Can't be altered!)
  1647.         irq = 10
  1648. </code>
  1649.  
  1650. <sect2>DE425, DE434, DE435, DE450, DE500 support (<tt/de4x5.o/).
  1651. <p><code>
  1652. Load command:
  1653.         /sbin/insmod de4x5.o
  1654.  
  1655.         io = 0x000b
  1656.         irq = 10
  1657.         is_not_dec = 0
  1658.     For non-DEC card using DEC 21040/21041/21140 chip, set this to 1
  1659.         (EISA, and PCI probing)
  1660. </code>
  1661.  
  1662. <sect2>DECchip Tulip (dc21x4x) PCI support (<tt/tulip.o/).
  1663. <p><code>
  1664. Load command:
  1665.         /sbin/insmod tulip.o
  1666.  
  1667.     Read Documentation/networking/tulip.txt
  1668. </code>
  1669.  
  1670. <sect2>Digi Intl. RightSwitch SE-X support (<tt/dgrs.o/).
  1671. <p>
  1672. This is a Linux driver for the Digi International RightSwitch SE-X
  1673. EISA and PCI boards.  These are 4 (EISA) or 6 (PCI) port ethernet
  1674. switches and a NIC combined into a single board.
  1675.  
  1676. There is a tool for setting up input and output packet filters
  1677. on each port, called "dgrsfilt".
  1678.  
  1679. The management tool lets you watch the performance graphically,
  1680. as well as set the SNMP agent IP and IPX addresses, IEEE Spanning
  1681. Tree, and Aging time.  These can also be set from the command line
  1682. when the driver is loaded.
  1683.  
  1684. There is also a companion management tool, called "xrightswitch".
  1685.  
  1686. <code>
  1687. Load command:
  1688.         /sbin/insmod dgrs.o
  1689.  
  1690.     debug=NNN        Debug printing level
  1691.     dma=0/1            Disable/Enable DMA on PCI card
  1692.     spantree=0/1        Disable/Enable IEEE spanning tree
  1693.     hashexpire=NNN        Change address aging time (default 300 seconds)
  1694.     ipaddr=A,B,C,D        Set SNMP agent IP address i.e. 199,86,8,221
  1695.     ipxnet=NNN        Set SNMP agent IPX network number
  1696. </code>
  1697.  
  1698. <sect1>Pocket and portable adaptors
  1699. <p>
  1700.  
  1701. <sect2>D-Link DE600 pocket adaptor support (<tt/de600.o/).
  1702. <p><code>
  1703. Load command:
  1704.         /sbin/insmod de600.o
  1705.  
  1706.     de600_debug = 0
  1707.     (On port 0x378, irq 7 -- lpt1;  compile time configurable)
  1708. </code>
  1709.  
  1710. <sect2>D-Link DE620 pocket adaptor support (<tt/de620.o/).
  1711. <p><code>
  1712. Load command:
  1713.         /sbin/insmod de620.o
  1714.  
  1715.     bnc = 0, utp = 0    <-- Force media by setting either.
  1716.     io = 0x378        (also compile-time configurable)
  1717.     irq = 7
  1718. </code>
  1719.  
  1720. <sect1>Token Ring driver support
  1721. <p>
  1722. <sect2>Tropic chipset based adaptor support (<tt/ibmtr.o/).
  1723. <p><code>
  1724. Load command:
  1725.         /sbin/insmod ibmtr.o io=0xa20 irq=0
  1726.  
  1727.         io = 0xa20    You should not use auto-probing with insmod
  1728.     irq = 0
  1729. </code>
  1730.  
  1731. <sect1>ARCnet support (<tt/arcnet.o/).
  1732. <p><code>
  1733. Load command:
  1734.         /sbin/insmod arcnet.o
  1735.  
  1736.         io = 0
  1737.         irqnum = 0
  1738.         shmem = 0
  1739.         num = 0
  1740.  
  1741.         DO SET THESE MANUALLY AT INSMOD!
  1742.  
  1743.         (When probing, looks at the following possible addresses:
  1744.          Suggested ones:
  1745.                 0x300, 0x2E0, 0x2F0, 0x2D0
  1746.          Other ones:
  1747.                 0x200, 0x210, 0x220, 0x230, 0x240, 0x250, 0x260, 0x270,
  1748.                 0x280, 0x290, 0x2A0, 0x2B0, 0x2C0,
  1749.                        0x310, 0x320, 0x330, 0x340, 0x350, 0x360, 0x370,
  1750.                 0x380, 0x390, 0x3A0,                      0x3E0, 0x3F0  )
  1751. </code>
  1752.  
  1753. <sect>ISDN subsystem
  1754. <p>
  1755. Setting up ISDN-networking is a complicated task.  Read documentation
  1756. found in <tt>/usr/src/linux/Documentation/isdn</tt>.
  1757.  
  1758. <sect1>ISDN support (<tt/isdn.o/).
  1759. <p><code>
  1760. Load command:
  1761.         /sbin/insmod isdn.o
  1762.  
  1763.     No module parameters.
  1764.  
  1765.     Depends on slhc.o
  1766. </code>
  1767.  
  1768. <sect1>ICN 2B and 4B support (<tt/icn.o/).
  1769. <p><code>
  1770. Load command:
  1771.         /sbin/insmod icn.o [parameters]
  1772.  
  1773.     portbase=p membase=m icn_id=idstring [icn_id2=idstring2]
  1774.  
  1775.     p = portbase        (default: 0x320)
  1776.     m = shared memory    (default: 0xd0000)
  1777.  
  1778.     When using the ICN double card, you MUST define TWO idstrings.
  1779.     idstring must start with a character!
  1780.  
  1781.         Depends on isdn.o
  1782. </code>
  1783.  
  1784. <sect1>PCBIT-D support (<tt/pcbit.o/).
  1785. <p><code>
  1786. Load command:
  1787.         /sbin/insmod pcbit.o
  1788.  
  1789.     mem = 0        default = 0xd0000
  1790.     irq = 0        default = 5
  1791.  
  1792.         Depends on isdn.o
  1793. </code>
  1794.  
  1795. <sect1>Teles/NICCY1016PC/Creatix support (<tt/teles.o/).
  1796. <p><code>
  1797. Load command:
  1798.         /sbin/insmod teles.o io=.....
  1799.  
  1800.     io=m0,i0,p0,d0[,m1,i1,p1,d1 ... ,mn,in,pn,dn] teles_id=idstring
  1801.  
  1802.     m0 = shared memory of 1st card.        (default: 0xd0000
  1803.     i0 = irq of 1st card.            (default: 15)
  1804.     p0 = portbase of 1st card.        (default: 0xd80)
  1805.     d0 = D-channel protocol of 1st card.    1=1TR6, 2=EDSS1 (default: 2)
  1806.  
  1807.     p1,i1,m1,d1 = Parameters of second card (defaults: none)
  1808.     pn,in,mn,d1 = Parameters of n'th card (up to 16 cards are supported)
  1809.  
  1810.     idstring = Driver-Id for accessing with utilities and identification
  1811.     when using a Line-monitor. (default: none) idstring must start with a character!
  1812.  
  1813.     The type of the card is determined by the port, irq and shared memory:
  1814.  
  1815.     port == 0, shared memory != 0    -> Teles S0-8
  1816.     port != 0, shared memory != 0    -> Teles S0-16.0
  1817.     port != 0, shared memory == 0    -> Teles S0-16.3
  1818.  
  1819.         Depends on isdn.o
  1820. </code>
  1821.  
  1822.  
  1823. <sect>CD-ROM drivers (not for SCSI or IDE/ATAPI drives)
  1824. <p>
  1825.  
  1826. <sect1>Aztech/Orchid/Okano/Wearnes/TXC/CyDROM support (<tt/aztcd.o/).
  1827. <p><code>
  1828. Load command:
  1829.     /sbin/insmod aztcd.o aztcd=[baseaddress]
  1830.  
  1831.     Read Documentation/cdrom/aztcd for full information.
  1832. </code>
  1833.  
  1834. <sect1>Goldstar R420 CDROM support (<tt/gscd.o/).
  1835. <p><code>
  1836. Load command:
  1837.         /sbin/insmod gscd.o gscd=[address]
  1838.  
  1839.     The default base address is 0x340.
  1840.     This will work for most applications.
  1841.     Address selection is accomplished by jumpers PN801-1 to PN801-4
  1842.     on the GoldStar Interface Card.
  1843.     Appropriate settings are: 0x300, 0x310, 0x320, 0x330, 0x340, 0x350,
  1844.     0x360, 0x370, 0x380, 0x390, 0x3A0, 0x3B0, 0x3C0, 0x3D0, 0x3E0, 0x3F0
  1845. </code>
  1846.  
  1847. <sect1>Matsushita/Panasonic/Creative, Longshine, TEAC support (<tt/sbpcd.o/).
  1848. <p><code>
  1849. Load command:
  1850.         /sbin/insmod sbpcd.o sbpcd=[address], x
  1851.  
  1852.     address = ioaddress
  1853.     x    = SBPRO setting, read Documentation/cdrom/sbpcd
  1854. </code>
  1855.  
  1856. <sect1>Mitsumi (standard) [no XA/Multisession] support (<tt/mcd.o/).
  1857. <p><code>
  1858. Load command:
  1859.         /sbin/insmod mcd.o mcd=0x300,11,0x304,5
  1860.  
  1861.     Where parameters are io and irq in pairs.
  1862. </code>
  1863.  
  1864. <sect1>Mitsumi [XA/MultiSession] support (<tt/mcdx.o/).
  1865. <p><code>
  1866. Load command:
  1867.         /sbin/insmod mcdx.o mcdx=0x300,11,0x304,5
  1868.  
  1869.     Where parameters are io and irq in pairs.
  1870. </code>
  1871.  
  1872. <sect1>Optics Storage DOLPHIN 8000AT CDROM support (<tt/optcd.o/).
  1873. <p><code>
  1874. Load command:
  1875.         /sbin/insmod optcd.o optcd=0x340
  1876.  
  1877.         Where parameter is the baseaddress of your card.
  1878. </code>
  1879.  
  1880. <sect1>Philips/LMS CM206 CDROM support (<tt/cm206.o/).
  1881. <p><code>
  1882. Load command:
  1883.         /sbin/insmod cm206.o cm206=0x300,11
  1884.  
  1885.         Where parameters are the baseaddress and irq of your card.
  1886. </code>
  1887.  
  1888. <sect1>Sanyo CDR-H94A CDROM support (<tt/sjcd.o/).
  1889. <p><code>
  1890. Load command:
  1891.         /sbin/insmod sjcd.o sjcd_base=0x340
  1892.  
  1893.         Where parameter is the baseaddress of your card.
  1894.     Default address = 0x340,  no irq,  no dma.
  1895. </code>
  1896.  
  1897. <sect1>ISP16/MAD16/Mozart soft configurable cdrom interface support (<tt/isp16.o/).
  1898. <p><code>
  1899. Load command:
  1900.         /sbin/insmod isp16.o [parameters]
  1901.  
  1902.     isp16_cdrom_base=<port>
  1903.     isp16_cdrom_irq=<irq>
  1904.     isp16_cdrom_dma=<dma>
  1905.     isp16_cdrom_type=<drive_type>
  1906.  
  1907.     Valid values are:
  1908.       port=0x340,0x320,0x330,0x360
  1909.       irq=0,3,5,7,9,10,11
  1910.       dma=0,3,5,6,7
  1911.       drive_type=noisp16,Sanyo,Panasonic,Sony,Mitsumi.
  1912.  
  1913.       Note that these options are case sensitive.
  1914. </code>
  1915.  
  1916. <sect1>Sony CDU31A/CDU33A CDROM support (<tt/cdu31a.o/).
  1917. <p><code>
  1918. Load command:
  1919.         /sbin/insmod cdu31a.o [parameters]
  1920.  
  1921.     cdu31a_port=<I/O address> - sets the base I/O.
  1922.     This must be specified.
  1923.  
  1924.     cdu31a_irq=<interrupt> - Sets the interrupt number.
  1925.     Leaving this off will turn interrupts off.
  1926. </code>
  1927.  
  1928. <sect1>Sony CDU535 CDROM support (<tt/sonycd535.o/).
  1929. <p><code>
  1930. Load command:
  1931.         /sbin/insmod sonycd535.o sonycd535=[address]
  1932.  
  1933.         Where parameter is the baseaddress of your card.
  1934. </code>
  1935.  
  1936.  
  1937. <sect>Filesystems
  1938. <p>
  1939.  
  1940. <sect1>Minix fs support(<tt/minix.o/).
  1941. <p><code>
  1942. Load command:
  1943.         /sbin/insmod minix.o
  1944.  
  1945.         No module parameters.
  1946. </code>
  1947.  
  1948. <sect1>Extended fs support (<tt/ext.o/).
  1949. <p><code>
  1950. Load command:
  1951.         /sbin/insmod ext.o
  1952.  
  1953.         No module parameters.
  1954. </code>
  1955.  
  1956. <sect1>Second extended fs support (<tt/ext2.o/).
  1957. <p><code>
  1958. Load command:
  1959.         /sbin/insmod ext2.o
  1960.  
  1961.         No module parameters.
  1962. </code>
  1963.  
  1964. <sect1>xiafs filesystem support (<tt/xiafs.o/).
  1965. <p><code>
  1966. Load command:
  1967.         /sbin/insmod xiafs.o
  1968.  
  1969.         No module parameters.
  1970. </code>
  1971.  
  1972. <sect1>DOS FAT fs support (<tt/fat.o/).
  1973. <p><code>
  1974. Load command:
  1975.         /sbin/insmod fat.o
  1976.  
  1977.         No module parameters.
  1978. </code>
  1979.  
  1980. <sect1>MSDOS fs support (<tt/msdos.o/).
  1981. <p><code>
  1982. Load command:
  1983.         /sbin/insmod msdos.o
  1984.  
  1985.         No module parameters.
  1986.     Depends on fat.o.
  1987. </code>
  1988.  
  1989. <sect1>VFAT (Windows-95) fs support (<tt/vfat.o/).
  1990. <p><code>
  1991. Load command:
  1992.         /sbin/insmod vfat.o
  1993.  
  1994.         No module parameters.
  1995.     Depends on fat.o.
  1996. </code>
  1997.  
  1998. <sect1>UMSDOS: Unix like fs on top of std MSDOS FAT fs (<tt/umsdos.o/).
  1999. <p><code>
  2000. Load command:
  2001.         /sbin/insmod vfat.o
  2002.  
  2003.         No module parameters.
  2004.     Depends on fat.o and msdos.o.
  2005. </code>
  2006.  
  2007. <sect1>NFS filesystem support (<tt/nfs.o/).
  2008. <p><code>
  2009. Load command:
  2010.         /sbin/insmod nfs.o
  2011.  
  2012.         No module parameters.
  2013. </code>
  2014.  
  2015. <sect1>SMB filesystem support (to mount WfW shares etc..) (<tt/smbfs.o/).
  2016. <p>
  2017. <tt/smbfs/ is a filesystem which understands the SMB protocol. This is the
  2018. protocol Windows for Workgroups, Windows NT or Lan Manager use to talk
  2019. to each other. <tt/smbfs/ was inspired by <tt/samba/, the program written by
  2020. Andrew Tridgell that turns any unix host into a file server for DOS or
  2021. Windows clients.  See <tt>ftp://nimbus.anu.edu.au/pub/tridge/samba/</tt> for
  2022. this interesting program suite and lots of more information on SMB and
  2023. NetBIOS over TCP/IP. There you also find explanation for concepts like
  2024. netbios name or share.
  2025.  
  2026. To use smbfs, you need a special mount program, which can be found in
  2027. the <tt/ksmbfs/ package, found on
  2028. <tt>sunsite.unc.edu:/pub/Linux/system/Filesystems/smbfs</tt>. 
  2029.  
  2030. <code>
  2031. Load command:
  2032.         /sbin/insmod smbfs.o
  2033.  
  2034.         No module parameters.
  2035. </code>
  2036.  
  2037. <sect1>NCP filesystem support (to mount NetWare volumes) (<tt/ncpfs.o/).
  2038. <p>
  2039. <tt/ncpfs/ is a filesystem which understands the NCP protocol, designed by the
  2040. Novell Corporation for their NetWare(tm) product. NCP is functionally
  2041. similar to the NFS used in the tcp/ip community.
  2042. To mount a Netware-Filesystem, you need a special mount program, which
  2043. can be found in ncpfs package. Homesite for ncpfs is
  2044. <tt>ftp.gwdg.de/pub/linux/misc/ncpfs</tt>, but sunsite and its many mirrors
  2045. will have it as well.
  2046.  
  2047. Related products are <tt/linware/ and <tt/mars_nwe/,
  2048. which will give Linux partial NetWare Server functionality.
  2049. <p><em/Linware/'s home site is: <tt>klokan.sh.cvut.cz/pub/linux/linware</tt>,
  2050. <p><em/Mars_nwe/ can be found on <tt>ftp.gwdg.de/pub/linux/misc/ncpfs</tt>.
  2051. <code>
  2052. Load command:
  2053.         /sbin/insmod ncpfs.o
  2054.  
  2055.         No module parameters.
  2056.  
  2057.     Depends on ipx.o
  2058. </code>
  2059.  
  2060. <sect1>ISO9660 cdrom filesystem support (<tt/isofs.o/).
  2061. <p><code>
  2062. Load command:
  2063.         /sbin/insmod isofs.o
  2064.  
  2065.         No module parameters.
  2066. </code>
  2067.  
  2068. <sect1>OS/2 HPFS filesystem support (read only) (<tt/hpfs.o/)
  2069. <p><code>
  2070. Load command:
  2071.         /sbin/insmod hpfs.o
  2072.  
  2073.         No module parameters.
  2074. </code>
  2075.  
  2076. <sect1>System V and Coherent filesystem support (<tt/sysv.o/).
  2077. <p>This is the implementation of the SystemV/Coherent filesystem for Linux.
  2078. <p>It implements all of
  2079. <itemize>
  2080. <item>Xenix FS,
  2081. <item>SystemV/386 FS,
  2082. <item>Coherent FS.
  2083. </itemize>
  2084. <p><code>
  2085. Load command:
  2086.         /sbin/insmod sysv.o
  2087.  
  2088.         No module parameters.
  2089. </code>
  2090.  
  2091. <sect1>Amiga FFS filesystem support  (<tt/affs.o/).
  2092. <p><code>
  2093. Load command:
  2094.         /sbin/insmod affs.o
  2095.  
  2096.         No module parameters.
  2097. </code>
  2098.  
  2099. <sect1>UFS filesystem support (read only) (<tt/ufs.o/).
  2100. <p>
  2101. Apparently for mounting disks with FreeBSD and/or Sun partitions.  No
  2102. documentation exists, apart from The Source. 
  2103. <code>
  2104. Load command:
  2105.         /sbin/insmod ufs.o
  2106.  
  2107.         No module parameters.
  2108. </code>
  2109.  
  2110.  
  2111. <sect>Character devices                                                
  2112. <p>
  2113. <sect1>Support for user misc device modules (<tt/misc.o/).
  2114. <p>This module is used by <tt/atixlmouse, busmouse, msbusmouse,
  2115. psaux, wdt/ and <tt/softdog/ modules and it is 
  2116. automatically generated if required.
  2117. <code>
  2118. Load command:
  2119.         /sbin/insmod misc.o
  2120.  
  2121.         No module parameters.
  2122. </code>
  2123.  
  2124.  
  2125. <sect1>Standard/generic serial support (<tt/serial.o/).
  2126. <p>
  2127. NOTE: <tt/serial.o/ is required by other modules, like ppp.o and
  2128. slip.o. Also it is required by serial mouse and accordingly by gpm.
  2129. <em/However/ this dependency is <em/not/ detected by present tools and
  2130. module <tt/serial.o/ must be loaded manually.
  2131. <code>
  2132. Load command:
  2133.         /sbin/insmod serial.o
  2134.  
  2135.         No module parameters.
  2136. </code>
  2137.  
  2138. <sect1>Cyclades async mux support (<tt/cyclades.o/)
  2139. <p><code>
  2140. Load command:
  2141.         /sbin/insmod cyclades.o
  2142.  
  2143.         No module parameters.
  2144. </code>
  2145.  
  2146. <sect1>Stallion multiport serial support
  2147. <p>
  2148. The intelligent boards also need to have their "firmware" code downloaded
  2149. to them. This is done via a user level application supplied in the driver
  2150. package called "stlload". Compile this program where ever you dropped the
  2151. package files, by typing "make". In its simplest form you can then type
  2152. <tscreen>
  2153.     ./stlload -i cdk.sys
  2154. </tscreen>
  2155. <p>in this directory and that will download board 0 (assuming board 0 is an
  2156. EasyConnection 8/64 board). To download to an ONboard, Brumby or Stallion
  2157. do:
  2158. <tscreen>
  2159.     ./stlload -i 2681.sys
  2160. </tscreen>
  2161. <p>Read the information at <tt>/usr/src/linux/drivers/char/README.stallion</tt>.
  2162.  
  2163. <sect2>Stallion EasyIO or EC8/32 support (<tt/stallion.o/).
  2164. <p><code>
  2165. Load command:
  2166.         /sbin/insmod stallion.o
  2167.  
  2168.         No module parameters.
  2169. </code>
  2170.  
  2171. <sect2>Stallion EC8/64, ONboard, Brumby support (<tt/istallion.o/).
  2172. <p><code>
  2173. Load command:
  2174.         /sbin/insmod istallion.o
  2175.  
  2176.         No module parameters.
  2177. </code>
  2178.  
  2179. <sect1>SDL RISCom/8 card support (<tt/riscom8.o/).
  2180. <p><code>
  2181. Load command:
  2182.         /sbin/insmod riscom8.o [options]
  2183.  
  2184.     This driver can support up to 4 boards at time.
  2185.     Options : iobase=0xXXX iobase1=0xXXX iobase2=...
  2186.  
  2187. </code>
  2188.  
  2189. <sect1>Parallel printer support (<tt/lp.o/).
  2190. <p><code>
  2191. Load command:
  2192.         /sbin/insmod lp.o io=0x378 irq=0
  2193.  
  2194.         io = 0
  2195.         irq = 0         irq=0 will run in polled mode
  2196.  
  2197.         (Probes ports: 0x278, 0x378, 0x3bc)
  2198.     Note: loading lp.o without any parameters will
  2199.     grab all parallelports.
  2200.  
  2201. </code>
  2202.  
  2203. <sect1>Bus Mouse Support
  2204. <p>
  2205.  
  2206. <sect2>ATIXL busmouse support (<tt/atixlmouse.o/).
  2207. <p><code>
  2208. Load command:
  2209.         /sbin/insmod atixlmouse.o
  2210.  
  2211.         No module parameters.
  2212.     Depends on misc.o
  2213. </code>
  2214.  
  2215. <sect2>Logitech busmouse support (<tt/busmouse.o/).
  2216. <p><code>
  2217. Load command:
  2218.         /sbin/insmod busmouse.o
  2219.  
  2220.         No module parameters.
  2221.     Depends on misc.o
  2222. </code>
  2223.  
  2224. <sect2>Microsoft busmouse support (<tt/msbusmouse.o/).
  2225. <p><code>
  2226. Load command:
  2227.         /sbin/insmod msbusmouse.o
  2228.  
  2229.         No module parameters.
  2230.     Depends on misc.o
  2231. </code>
  2232.  
  2233. <sect2>PS/2 mouse (aka "auxiliary device") support (<tt/psaux.o/).
  2234. <p><code>
  2235. Load command:
  2236.         /sbin/insmod psaux.o
  2237.  
  2238.         No module parameters.
  2239.     Depends on misc.o
  2240. </code>
  2241.  
  2242. <sect1>Tape support
  2243. <p>
  2244. For support of SCSI tapedrives, see section <em/SCSI Support/.
  2245.  
  2246. <sect2>Ftape (QIC-80/Travan) support (<tt/ftape.o/).
  2247. <p><code>
  2248. Load command:
  2249.         /sbin/insmod ftape.o tracing=3
  2250.  
  2251.     Option parameter 'tracing' can take following values
  2252.  
  2253.     set it to:     to get:
  2254.        0        bugs
  2255.        1        + errors
  2256.        2        + warnings
  2257.        3        + information        ** Default **
  2258.        4        + more information
  2259.        5        + program flow
  2260.        6        + fdc/dma info
  2261.        7        + data flow
  2262.        8        + everything else
  2263. </code>
  2264.  
  2265. <sect1>Watchdog Timer Support
  2266. <p>
  2267.  
  2268. <sect2>WDT Watchdog timer (<tt/wdt.o/).
  2269. <p><code>
  2270. Load command:
  2271.         /sbin/insmod wdt.o
  2272.  
  2273.         No module parameters.
  2274.     Defaults to io=0x240 irq=14,
  2275.     make any required changes to wdt.c directly.
  2276.     Depends on misc.o
  2277. </code>
  2278.  
  2279. <sect2>Software Watchdog (<tt/softdog.o/).
  2280. <p><code>
  2281. Load command:
  2282.         /sbin/insmod softdog.o
  2283.  
  2284.         No module parameters.
  2285.     Depends on misc.o
  2286. </code>
  2287.  
  2288. <sect>Sound support (<tt/sound.o/).
  2289. <p>
  2290.     Configuring sound is a complex task, there is a number of 
  2291.     Readme-files in directory <tt>/usr/src/linux/drivers/sound</tt>,
  2292.     <em/read them/.
  2293. <code>
  2294. Load command:
  2295.         /sbin/insmod sound.o [option]
  2296.  
  2297.     Option: dma_buffsize=32768 
  2298. </code>
  2299.  
  2300. <sect>Closing
  2301. <p>
  2302.     If you have found any glaring typos, or outdated info in this
  2303.     document, please let me know. It is easy to overlook stuff.
  2304.  
  2305.     <em/Thanks,/
  2306.  
  2307.     Lauri Tischler, <tt/ltischler@efore.fi/
  2308. </article>
  2309.