The Linux HOWTO Index by Greg Hankins, gregh@sunsite.unc.edu v2.9.27, 5 June 1996 This document contains an index to the Linux HOWTOs and mini-HOWTOs, as well as other information about the HOWTO project. 1. What Are Linux HOWTOs? Linux HOWTOs are documents which describe in detail a certain aspect of configuring or using Linux. For example, there is the Installation HOWTO, which gives instructions on installing Linux, and the Mail HOWTO, which describes how to set up and configure mail under Linux. Other examples include the NET2 HOWTO and the Printing HOWTO. HOWTOs are comprehensive docs - much like an FAQ but generally not in question-and-answer format. However, many HOWTOs contain an FAQ section at the end. There are several HOWTO formats available: plain text, PostScript, DVI, and HTML. In addition to the HOWTOs, there are a multitude of mini-HOWTOs. These are short, specific HOWTOs, such as the Colour-ls mini-HOWTO. They are only available in plain text format. 2. Where Do I Get Linux HOWTOs? HOWTOs can be retrieved via anonymous FTP from the following sites: · ftp://sunsite.unc.edu/pub/Linux/docs/HOWTO · ftp://tsx-11.mit.edu/pub/linux/docs/HOWTO as well as many mirror sites . You can also browse HOWTOs in HTML format on the World Wide Web. Many mirror sites also mirror the HOWTO WWW files. sunsite.unc.edu is heavily used, so please use a mirror site if possible. HOWTOs are also posted monthly to the Usenet newsgroup comp.os.linux.answers. 2.1. HOWTO Translations French translations of the HOWTO documents can be found at ftp://ftp.ibp.fr/pub/linux/french/docs/HOWTO. Japanese translations can be found at the following locations: · http://jf.gee.kyoto-u.ac.jp/JF/index.html (English) · http://jf.gee.kyoto-u.ac.jp/JF/JF.html (Japanese) · ftp://ftp.kuis.kyoto-u.ac.jp/Linux/JF/ · ftp://wcarchive.cdrom.com/pub/linux/jf/ Italian translations are available at: · ftp://ftp.unipd.it/pub/Linux/pluto/docs/HOWTO · http://www.psico.unipd.it/ildp/docs/HOWTO/INDEX.html Spanish translations are available at: · http://lml.ls.fi.upm.es/~jjamor/ · ftp://luna.gui.uva.es/pub/docs-esp/ · ftp://volcan.us.es If you know of any other translation projects, please let me know and I will add them to this list. 3. HOWTO Index The following Linux HOWTOs are currently available: (The JE HOWTO, and SCSI HOWTO are only available in plain text format. This is because they have not been converted to the SGML source format.) · Linux AX25 HOWTO, by Terry Dawson . How to configure AX25 networking for Linux. Updated 25 Apr 1996. · Linux Access HOWTO, by Michael De La Rue . How to use adaptive technology with Linux. Updated 4 May 1996. · Linux BootPrompt HOWTO, by Paul Gortmaker . List of boot time arguments and overview of booting software. Updated 18 August 1995. · Linux Bootdisk HOWTO, by Graham Chapman . How to create a boot/root maintenance disk for Linux. Updated 25 June 1995. · Linux Busmouse HOWTO, by Mike Battersby . Information on bus mouse compatibility with Linux. Updated 2 August 1994. · Linux CDROM HOWTO, by Jeff Tranter . Information on CD-ROM drive compatibility for Linux. Updated 24 February 1996. · Linux Commercial HOWTO, by Harald Milz . Listing of commercial software products for Linux. Updated September 1995. · Linux Cyrillic HOWTO, by Alexander L. Belikoff . How to configure Linux for use with the Cyrillic characterset. Updated 17 September 1995. · Linux DNS HOWTO, by Nicolai Langfeldt . How to set up DNS. Updated 25 March 1996. · Linux DOSEMU HOWTO, by Mike Deisher . HOWTO about the Linux MS-DOS Emulator, DOSEMU. Updated 11 August 1995. · Linux Danish HOWTO, by Thomas Petersen . How to configure Linux for use with the Danish characterset. Updated 2 June 1996. · Linux Distribution HOWTO, by Eric S. Raymond . A list of Linux distributions. Updated 29 May 1996. · Linux ELF HOWTO, by Daniel Barlow . How to install and migrate to the ELF binary file format. Updated 13 September 1995. · Linux Ethernet HOWTO, by Paul Gortmaker . Information on Ethernet hardware compatibility for Linux. Updated 18 November 1995. · Linux Finnish HOWTO, by Pekka Taipale . How to configure Linux for use with the Finnish characterset. Updated 14 February 1996. · Linux Firewall HOWTO, by David Rudder . How to set up a firewall using Linux. Updated 17 July 1995. · Linux Ftape HOWTO, by Kai Harrekilde-Petersen . Information on ftape drive compatibility with Linux. Updated 22 May 1996 for ftape-2.08. · Linux GCC HOWTO, by Daniel Barlow . How to set up the GNU C compiler and development libraries. Updated 28 February 1996. · Linux German HOWTO, by Winfried Trümper . Information on using Linux with German-specific features. Updated 20 January 1996. · Linux HAM HOWTO, by Terry Dawson . HOWTO configure amateur radio software for Linux. Updated 30 April 1996. · Linux HOWTO Index, by Greg Hankins . Index of HOWTO documents about Linux. Updated 5 June 1996. · Linux Hardware Compatibility HOWTO, by Tawei Wan . A list of hardware known to work with Linux. Updated 14 November 1995. · Linux Hebrew HOWTO, by Yair G. Rajwan . How to configure Linux for use with the Hebrew characterset. Updated 12 September 1995. · Linux INFO-SHEET, by Michael K. Johnson . Generic introduction to the Linux operating system. Updated 6 May 1996. · Linux IPX HOWTO, by Terry Dawson . How to install and configure IPX networking. Updated 1 June 1996. · Linux ISP Hookup HOWTO, by Egil Kvaleberg . Basic introduction to hooking up to an ISP. Updated 9 March 1996. · Linux Installation HOWTO, by Matt Welsh . How to obtain and install the Linux software. Updated 11 December 1994. · Linux Italian HOWTO, by Marco ``Gaio'' Gaiarin . How to configure Linux for use with the Italian characterset. Updated 23 March 1996. · Linux JE HOWTO, by Hiroo Yamagata . Information on JE, a set of Japanese language extensions for Linux. · Linux Java HOWTO, by Eric S. Raymond . How to get started with Java and HotJava. Updated 29 May 1996. · Linux Kernel HOWTO, by Brian Ward . Upgrading and compiling the Linux kernel. Updated 22 February 1996. · Linux Keyboard HOWTO, by Andries Brouwer . Information about the Linux keyboard, console and non-ASCII characters. Updated 8 November 1995. · Linux META-FAQ, by Michael K. Johnson . A listing of Linux sources of information. Updated 6 May 1996. · Linux MGR HOWTO, by Vincent Broman . Information on the MGR graphics interface for Linux. Updated 30 May 1996. · Linux Electronic Mail HOWTO, by Vince Skahan . Information on Linux-based mail servers and clients. Updated 29 November 1995. · Linux NET-2 HOWTO, by Terry Dawson . HOWTO configure TCP/IP networking, SLIP, PLIP, and PPP under Linux. Updated 16 January 1996. · Linux NIS HOWTO, by Erwin Embsen . Information on using NIS/YP on Linux systems. Updated 24 January 1995. · Linux News HOWTO, by Vince Skahan . Information on USENET news server and client software for Linux. Updated 29 November 1995. · Linux PCI HOWTO, by Michael Will . Information on PCI-architecture compatibility with Linux. Updated March 1996. · Linux PCMCIA HOWTO, by Dave Hinds . How to install and use PCMCIA Card Services. Updated 27 December 1995. · Linux PPP HOWTO, by Robert Hart . Information on using PPP networking with Linux. Updated 23 March 1996. · Linux Polish HOWTO, by Sergiusz Pawlowicz . How to configure Linux for use with the Polish characterset. Updated v0.1, 1 June 1996. · Linux Portuguese HOWTO, by Joao Carlos Rodrigues Pereira . How to configure Linux for use with the Portuguese characterset. Updated 14 September 1995. · Linux Printing HOWTO, by Grant Taylor . HOWTO on printing software for Linux. Updated 12 March 1996. · Linux Printing Usage HOWTO, by Mark Komarinski . How to use the printing system for a variety of file types and options. Updated 2 February 1996. · Linux SCSI HOWTO, by Drew Eckhardt . Information on SCSI driver compatibility with Linux. · Linux SCSI Programming HOWTO, by Heiko Eissfeldt . Information on programming the generic Linux SCSI interface. Updated 7 May 1996. · Linux Serial HOWTO, by Greg Hankins . Information on use of serial devices and communications software. Updated 9 October 1995. · Linux Shadow Password HOWTO, by Michael H. Jackson . How to obtain, install, and configure shadow passwords. Updated 3 April 1996. · Linux Sound HOWTO, by Jeff Tranter . Sound hardware and software for the Linux operating system. Updated 24 February 1996. · Linux Sound Playing HOWTO, by Yoo C. Chung . How to play various sound formats under Linux. Updated 18 May 1996. · Linux Term HOWTO, by Patrick Reijnen . HOWTO use the `term' communications package on Linux systems. Updated 15 July 1995. · Linux Tips HOWTO, by Paul Anderson . HOWTO on miscellaneous tips and tricks for Linux. Updated June 1996. · Linux UMSDOS HOWTO, by Jacques Gelinas . How to install and use the UMSDOS filesystem. Updated 13 November 1995. · Linux UPS HOWTO, by Harvey J. Stein . Information on using a UPS power supply with Linux. Updated 16 April 1995. · Linux UUCP HOWTO, by Vince Skahan . Information on UUCP software for Linux. Updated 29 November 1995. · Linux XFree86 HOWTO, by Matt Welsh . How to obtain, install, and configure XFree86 3.1.1 (X11R6). Updated 15 March 1995. The following mini-HOWTOs are available (plain text only): · Linux 3 Button Mouse mini-HOWTO, by Geoff Short . How to configure your mouse to use 3 buttons. Updated 9 May 1996. · Linux ADSM Backup mini-HOWTO, by Thomas Koenig . How to install and use the ADSM backup program. Updated 3 January 1996. · Linux Assembly mini-HOWTO, by Francois-Rene Rideau . How to program x86 assembly language. Updated 2 May 1996. · Linux Backup with MSDOS mini-HOWTO, by Christopher Neufeld . How to backup Linux machines with MSDOS. Updated 6 February 1996. · Linux Boca mini-HOWTO, by David H Dennis . How to install a Boca 16-port serial card (Boca 2016). Updated 16 February 1995. · Linux BogoMips mini-HOWTO, by Wim C.A. van Dorst . Information about BogoMips. Updated 19 December 1995. · Linux CD Writer mini-HOWTO, by Matt Cutts . How to write CDs. Updated 17 December 1994. · Linux Colour ls mini-HOWTO, by Thorbjoern Ravn Andersen . How to set up the colours with 'ls'. Updated 27 April 1996. · Linux Consoles mini-HOWTO, by R. Mark Salathiel . How to set up multiple virtual consoles. Updated 25 December 1994. · Linux Consoles-Many mini-HOWTO, by Winfried Trümper . How to set up many virtual consoles. Updated 17 March 1996. · Linux DOS2Linux mini-HOWTO, by Guido Gonzato . A short guide on getting started with Linux. Updated 26 April 1996. · Linux Dip+SLiRP+CSLIP mini-HOWTO, by Zenon Fortuna . How to use Dip+SLiRP+CSLIP together. Updated 15 October 1995. · Linux Diskless mini-HOWTO, by Robert Nemkin . How to set up a diskless Linux box. Updated 31 May 1996. · Linux Dynamic IP Hacks mini-HOWTO, by Michael Driscoll . Tips and tricks for people with dynamic IP addresses. Updated 1 June 1996. · Linux GUI Development mini-HOWTO, by Philip Markwalder . Information about GUI Development Software and Books. Updated 6 June 1995. · Linux getty-ps mini-HOWTO, by Mark Horton . How to set up 'getty_ps'. Updated 6 September 1994. · Linux Graphics Tools mini-HOWTO, by Michael J. Hammel . Introduction to graphics tools available for Linux. Updated 15 May 1996. · Linux Gravis-UltraSound mini-HOWTO, by J-F Mammet . How to install the Gravis UltraSound PnP card. Updated 27 March 1996. · Linux HTTP+Netware mini-HOWTO, by Pramod Karnad . How to setup a Linux HTTP server on a Netware LAN. Updated 14 March 1996. · Linux HTML Validation mini-HOWTO, by Keith M. Corbett . How to validate HTML 2.0 documents with nsgmls. Updated 29 October 1995. · Linux Kerneld mini-HOWTO, by Henrik Storner . How to use 'kerneld' (dynamic module loading). Updated 3 June 1996. · Linux IO Port Programming mini-HOWTO, by Riku Saikkonen . How to use I/O ports in C programs. Updated 26 December 1995. · Linux Key Setup mini-HOWTO, by Stephen Lee . How to set up cursor control keys. Updated 16 September 1995. · Linux Keystroke mini-HOWTO, by Zenon Fortuna . How to assign special action to keys. Updated 4 April 1995. · Linux LBX mini-HOWTO, by Paul D. Smith . How to use Low-Bandwidth X (LBX). Updated 23 October 1995. · Linux LF1000 mini-HOWTO, by Skip Rye . How to use the Panasonic LF1000 optical disk drive. Updated 29 March 1996. · Linux LILO mini-HOWTO, by Cameron Spitzer . Examples of typical LILO installations. Updated 4 June 1995. · Linux Linux+DOS+Win95+OS2 mini-HOWTO, by Mike Harlan . How to use Linux and DOS and OS/2 and Win95 together. Updated 6 March 1996. · Linux Linux+OS2+DOS mini-HOWTO, by Hamish Moffatt . How to use Linux and OS/2 and DOS together. Updated 20 May 1996. · Linux Linux+Win95 mini-HOWTO, by Jonathan Katz . How to use Linux and Windows95 together. Updated 18 December 1995. · Linux Large IDE mini-HOWTO, by Patrick LoPresti . This document is no longer valid. Please read /usr/src/linux/drivers/block/README.ide in the Linux kernel source for more complete and accurate information. · Linux Locales mini-HOWTO, by Peeter Joot . How to configure Linux to use locales. Updated 2 May 1996. · Linux Mail Queue mini-HOWTO, by Leif Erlingsson . How to queue remote mail and deliver local mail. Updated 19 September 1995. · Linux Man Page mini-HOWTO, by Jens Schweikhardt . How to write man pages. Updated April 1996. · Linux Modeline mini-HOWTO, by Rick Niles . How to use 'modeline'. Updated 11 February 1995. · Linux Multiple Disks Layout mini-HOWTO, by Gjoen Stein . How to use multiple ethernet cards. Updated 5 August 1995. · Linux NFS-Root mini-HOWTO, by Andreas Kostyrka . How to set up diskless Linux machines. Updated 14 March 1996. · Linux Online Support mini-HOWTO, by lilo . Information about the Linux Internet Support Cooperative. Updated 7 May 1996. · Linux PLIP mini-HOWTO, by Andrea Controzzi . How to set up PLIP (Parallel Line Interface Protocol). Updated 8 January 1996. · Linux PPP-over-ISDN mini-HOWTO, by R Marc Phillips . How to set up MLPPP over ISDN. Updated 13 April 1996. · Linux Proxy ARP mini-HOWTO, by Al Longyear . A small treatise on the use of Proxy ARP. Updated 5 December 1994. · Linux Reading List, by James H. Haynes . Interesting books pertaining to Linux subjects. Updated 24 February 1996. · Linux SLIP+proxyARP mini-HOWTO, by Dave Kennedy . Using SLIP and Proxy ARP to connect LANs to the net. Updated 4 February 1994. · Linux Stacker mini-HOWTO, by Corey Sweeney . How to mount MSDOS Stacked filesystems. Updated 6 September 1994. · Linux Swap Space mini-HOWTO, by H. Peter Anvin . How to share swap space between Linux and Windows. Updated 19 June 1995. · Linux TIA mini-HOWTO, by Irish . How to use 'TIA' with Linux. Updated 16 December 1995. · Linux Term Firewall mini-HOWTO, by Barak Pearlmutter . How to use 'term' over a firewall. Updated 22 May 1996. · Linux Tiny News mini-HOWTO, by Kent Lewis . How to use 'INN' to make a small news spool. Updated 25 May 1995. · Linux Token Ring mini-HOWTO, by Mike Eckhoff . How to use token ring cards. Updated 5 July 1995. · Linux Upgrade mini-HOWTO, by Greg Louis . How to upgrade your Linux distribution. Updated 11 May 1996. · Linux Virtual Web mini-HOWTO, by Dan Pancamo . How to set up a virtual WWW site. Updated 24 November 1995. · Linux Visual Bell mini-HOWTO, by Alessandro Rubini . How to disable audible bells, and enable visual bells. Updated May 1995. · Linux Win95+Win+Linux mini-HOWTO, by Robert Goodwin . How to get Windows95, Windows 3.x and Linux to work. Updated January 1996. · Linux WordPerfect mini-HOWTO, by Wade Hampton . How to set up SCO WordPerfect for Linux. Updated 17 May 1995. · Linux X Notebook mini-HOWTO, by Darin Ernst . How to set up X on notebooks with WD90C24 video chips. Updated 10 August 1995. · Linux XFree86-XInside mini-HOWTO, by Marco Melgazzi . How to convert XFree86 to XInside modelines. Updated May 1996. · Linux Xterminal mini-HOWTO, by Scot W. Stevenson . How to connect Xterminals to Linux boxen. Updated July 1995. · Linux ZIP Drive mini-HOWTO, by Grant Guenther . How to use an Iomega ZIP drive with Linux. Updated 15 April 1996. 4. HOWTO Project Developement 4.1. Wanted HOWTOs and mini-HOWTOs If you are interested in writing about any of these subject, please get in touch with me at gregh@sunsite.unc.edu. · Notebook HOWTO or Notebook mini-HOWTO. A guide to notebooks - information about power management, LCD displays, video controlers, pointers to related material (PCMCIA-HOWTO), and most anything pertaining to notebooks. · A Disk HOWTO about disks, partitions, swap space, formatting, filesystems, etc. · If you have an idea for another HOWTO or mini-HOWTO, please get in touch. 4.2. HOWTOs Currently Under Contsruction · A SMP HOWTO (multiprocessor support for Linux) (7 February 1996). · A BBS guide with FIDO information is being written (15 February 1996). · A Samba HOWTO is being written (4 March 1996). · An Information Services HOWTO is being written (5 March 1996). · A Microchannel Bus mini-HOWTO is under construction (17 March 1996). · The Tips HOWTO is being rewritten with a new maintainer (18 April 1996). 4.3. Writing and Submitting a HOWTO If you would like to write a Linux HOWTO document, there are a few guidelines that you should follow. · Get in touch with me first, and let me know you want to work on something. You can reach me at gregh@sunsite.unc.edu. · Try to use meaningful structure and organization, and write clearly. Remember that many of the people reading HOWTOs do not speak English as their first language. · If you are writing a HOWTO, you must use the Linuxdoc-SGML package, available from sunsite.unc.edu:/pub/Linux/utils/text/, to format the HOWTO. This package allows us to produce LaTeX (for DVI and PostScript), plain text, and HTML from a single source document, and was designed by Matt Welsh specifically for the HOWTOs. This also gives all of the HOWTOs a uniform look. · If you are writing a mini-HOWTO, you can use any form you wish. mini-HOWTOs are meant to be short, free-form HOWTOs on very specific subjects. In general, these should be quick to write and maintain, so it's not worth bothering with the Linuxdoc-SGML package. This does not mean that the mini-HOWTOs are any less important! Only plain text versions of mini-HOWTOs are distributed. · Make sure that all of the information is correct. I can't stress this enough. When in doubt, speculate, but make it clear that you're only guessing. · Make sure that you are covering the most recent version of the available software. Also, be sure to include full instructions on where software can be downloaded from (FTP site name, full pathname), and the current version number and release date of the software. · Include an FAQ section at the end, if appropriate. Many HOWTO documents need an ``FAQ'' or ``Common Problems'' section to cover information which can't be covered in the regular text. · Use other HOWTOs as a model. The SGML source to the HOWTOs is available on Linux FTP sites. · Lastly, be prepared to receive questions and comments about your writing. There are several hundreds of accesses to the HOWTO collection every day from around the world! After you have written the HOWTO, mail it to me. If you used Linuxdoc-SGML, simply mail me the SGML source; I take care of formatting the documents. I'll also take care of archiving the HOWTOs on sunsite.unc.edu and posting them to the various newsgroups. It is important that you go through me when submitting a HOWTO, as I maintain the archives and need to keep track of what HOWTOs are being written and who is doing what. Then, all you have to do is send me periodic updates whenever appropriate. 5. Copyright Unless otherwise stated, Linux HOWTO documents are copyrighted by their respective authors. Linux HOWTO documents may be reproduced and distributed in whole or in part, in any medium physical or electronic, as long as this copyright notice is retained on all copies. Commercial redistribution is allowed and encouraged; however, the author would like to be notified of any such distributions. All translations, derivative works, or aggregate works incorporating any Linux HOWTO documents must be covered under this copyright notice. That is, you may not produce a derivative work from a HOWTO and impose additional restrictions on its distribution. Exceptions to these rules may be granted under certain conditions; please contact the Linux HOWTO coordinator at the address given below. In short, we wish to promote dissemination of this information through as many channels as possible. However, we do wish to retain copyright on the HOWTO documents, and would like to be notified of any plans to redistribute the HOWTOs. If you have questions, please contact Greg Hankins, the Linux HOWTO coordinator, at gregh@sunsite.unc.edu via email.