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