Linux HOWTO Index by Greg Hankins, gregh@sunsite.unc.edu v2.6, 8 May 1995 This is an index to the Linux HOWTO documents. 1. What are Linux HOWTOs? Linux HOWTOs are short online documents which describe in detail a certain aspect of configuring or using the Linux system. 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 NET-2-HOWTO (previously the NET-2-FAQ) and the Printing HOWTO. Information in HOWTOs is generally more detailed and in-depth than what can be squeezed into the Linux FAQ. For this reason, the Linux FAQ is being rewritten. A large amount of the information contained therein will be relegated to various HOWTO documents. The FAQ will be a shorter list of frequently asked questions about Linux, covering small specific topics. Most of the ``useful'' information in the FAQ will now be covered in the HOWTOs. 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. For example, the NET-2-FAQ has been renamed to the NET-2-HOWTO, because it wasn't in question-and-answer format. However, you will see the NET-2-HOWTO named as the NET-2-FAQ in many places. The two docs are one and the same. There are several HOWTO formats: plain text, PostScript, dvi, and html formats are all available. You can also browse HOWTOs (http://sunsite.unc.edu/mdw/HOWTO/) on the World Wide Web. In addition to the HOWTOs, there are a multitude of "mini-HOWTOs". These are very short, specific HOWTOs, such as the Colour-ls HOWTO. They are only available in plain text format. 2. Where to get Linux HOWTOs HOWTOs can be retrieved via anonymous FTP from the following sites: o sunsite.unc.edu:/pub/Linux/docs/HOWTO o tsx-11.mit.edu:/pub/linux/docs/HOWTO as well as the many mirror sites (ftp://sunsite.unc.edu/pub/Linux/MIRRORS.html). You can also browse HOWTOs (http://sunsite.unc.edu/mdw/HOWTO/) on the Web. Many mirror sites (http://sunsite.unc.edu/mdw/hmirrors.html) also mirror the HTML versions. sunsite is heavily used, so please use a mirror site if possible. HOWTOs are also posted regularly to the newsgroup comp.os.linux.answers, and other appropriate newsgroups. 3. HOWTO Index The following Linux HOWTOs are currently available: (The German-HOWTO, JE-HOWTO, and Printing-HOWTO are only available in plain text format. This is because they have not been converted to the SGML source format. Conversion to SGML is in progress.) o Linux Bootdisk HOWTO (Bootdisk-HOWTO.html), by Graham Chapman . How to create a boot/root maintenance disk for Linux. Updated 6 February 1995. o Linux Busmouse HOWTO (Busmouse-HOWTO.html), by Mike Battersby . Information on bus mouse compatibility with Linux. Updated 2 August 1994. o Linux CDROM HOWTO (CDROM-HOWTO.html), by Jeff Tranter . Information on CD- ROM drive compatibility for Linux. Updated 2 December 1994. o Linux Commercial HOWTO (Commercial-HOWTO.html), by Harald Milz . Listing of commercial software products for Linux. Updated April 1995. o Linux DOSEMU HOWTO (DOSEMU-HOWTO.html), by Michael E. Deisher . HOWTO about the Linux MS-DOS Emulator, DOSEMU. Updated 17 April 1995. o Linux Danish HOWTO (Danish-HOWTO.html), by Thomas Petersen . How to configure Linux for use with the Danish characterset. Updated 9 March 1994. o Linux Distribution HOWTO (Distribution-HOWTO.html), by Erik Troan . A list of mail order distributions and other commercial services. Updated 10 February 1995. o Linux ELF HOWTO (ELF-HOWTO.html), by Riccardo Facchetti . How to install the ELF binary file format. Updated 18 April 1995. o Linux Ethernet HOWTO (Ethernet-HOWTO.html), by Paul Gortmaker . Information on Ethernet hardware compatibility for Linux. Updated 11 February 1995. o Linux Firewall HOWTO (Firewall-HOWTO.html), by David Rudder . How to set up a firewall using Linux. Updated 23 April 1995. o Linux Ftape HOWTO (Ftape-HOWTO.html), by Ftape-HOWTO maintainer . Information on ftape drive compatibility with Linux. Updated 1 April 1995 for ftape-2.02. o Linux German HOWTO, by Winfried Truemper . Information on using Linux with German-specific features. o Linux HAM HOWTO (HAM-HOWTO.html), by Terry Dawson . HOWTO configure amateur radio software for Linux. Updated 8 April 1995. o Linux HOWTO Index (HOWTO-INDEX.html), by Greg Hankins . Index of HOWTO documents about Linux. Updated 8 May 1995. o Linux Hardware Compatibility HOWTO (Hardware-HOWTO.html), by Tawei Wan . A list of hardware known to work with Linux. Updated 2 May 1995. o Linux INFO-SHEET (INFO-SHEET.html), by Michael K. Johnson . Generic introduction to the Linux operating system. Updated 31 March 1994. o Linux Installation HOWTO (Installation-HOWTO.html), by Matt Welsh . How to obtain and install the Linux software. Updated 11 December 1994. o Linux JE HOWTO, by Hiroo Yamagata . Information on JE, a set of Japanese language extensions for Linux. o Linux Kernel HOWTO (Kernel-HOWTO.html), by Brian Ward . Upgrading and compiling the Linux kernel. Updated 31 March 1995. o Linux Keystroke HOWTO, by Zenon Fortuna . HOWTO bind macro actions to keystrokes under Linux. o Linux META-FAQ (META-FAQ.html), by Michael K. Johnson . A listing of Linux sources of information. Updated 12 November 1994. o Linux MGR HOWTO (MGR-HOWTO.html), by Vincent Broman . Information on the MGR graphics interface for Linux. Updated 16 November 1994. o Linux Electronic Mail HOWTO (Mail-HOWTO.html), by Vince Skahan . Information on Linux-based mail servers and clients. Updated 31 March 1995. o Linux NET-2 HOWTO (NET-2-HOWTO.html), by Terry Dawson . HOWTO configure TCP/IP networking, SLIP, PLIP, and PPP under Linux. Updated 8 April 1995. o Linux NIS HOWTO (NIS-HOWTO.html), by Erwin Embsen . Information on using NIS/YP on Linux systems. Updated 24 January 1995. o Linux News HOWTO (News-HOWTO.html), by Vince Skahan . Information on USENET news server and client software for Linux. Updated 31 March 1995. o Linux PCI-HOWTO (PCI-HOWTO.html), by Michael Will . Information on PCI-architecture compatibility with Linux. Updated March 1995. o Linux PCMCIA HOWTO (PCMCIA-HOWTO.html), by Dave Hinds . How to install and use PCMCIA Card Services. Updated 9 April 1995. o Linux PPP-HOWTO (PPP-HOWTO.html), by Al Longyear . Information on using PPP networking with Linux. Updated April 1995. o Linux Printing HOWTO, by Grant Taylor . HOWTO on printing software for Linux. o Linux SCSI HOWTO (SCSI-HOWTO.html), by Drew Eckhardt . Information on SCSI driver compatibility with Linux. Updated 20 March 1995. o Linux SCSI Programming HOWTO (SCSI-Programming-HOWTO.html), by Heiko Eissfeldt . Information on programming the generic Linux SCSI interface. Updated 14 April 1995. o Linux Serial HOWTO (Serial-HOWTO.html), by Greg Hankins . Information on use of serial devices and communications software. Updated 28 March 1995. o Linux Sound HOWTO (Sound-HOWTO.html), by Jeff Tranter . Sound hardware and software for the Linux operating system. Updated 3 December 1994. o Linux Term HOWTO (Term-HOWTO.html), by Patrick Reijnen . HOWTO use the `term' communications package on Linux systems. Updated March 1995. o Linux Tips HOWTO (Tips-HOWTO.html), by Vince Reed . HOWTO on miscellaneous tips and tricks for Linux. Updated 30 August 1994. o Linux UPS HOWTO (UPS-HOWTO.html), by Harvey J. Stein . Information on using a UPS power supply with Linux. Updated 16 April 1995. o Linux UUCP HOWTO (UUCP-HOWTO.html), by Vince Skahan . Information on UUCP software for Linux. Updated 31 March 1995. o Linux XFree86 HOWTO (XFree86-HOWTO.html), by Matt Welsh . How to obtain, install, and configure XFree86 3.1.1 (X11R6). Updated 15 March 1995. The following mini-HOWTOs are available: o Linux Anon FTP Setup mini-HOWTO (Anon-FTP-Setup), by Christopher Klaus . How to set up a secure anonymous FTP site. Updated 24 July 1994. o Linux Backspace mini-HOWTO (Backspace), by Stephen Lee . How to set up BackSpace and Delete keys. Updated 11 November 1994. o Linux Backup with MSDOS mini-HOWTO (Backup-With-MSDOS), by Christopher Neufeld . How to backup MSDOS machines with Linux. Updated ???. o Linux Boca mini-HOWTO (Boca), by David H Dennis . How to install a Boca 16-port serial card (Boca 2016). Updated ???. o Linux BogoMips mini-HOWTO (BogoMips), by Wim C.A. van Dorst . Information about BogoMips. Updated 1 May 1995. o Linux CD Writer mini-HOWTO (CD-Writer), by Matt Cutts . How to write CDs. Updated 17 December 1994. o Linux Caching named mini-HOWTO (Caching-named), by Nicolai Langfeldt . How to set up a caching nameserver. Updated 20 March 1995. o Linux Colour ls mini-HOWTO (Colour-ls), by Thorbjoern Ravn Andersen . How to set up the colours with 'ls'. Updated 12 December 1994. o Linux Consoles mini-HOWTO (Consoles), by R. Mark Salathiel . How to set up multiple virtual consoles. Updated 25 December 1995. o Linux getty-ps mini-HOWTO (Getty-ps), by Mark Horton . How to set up getty_ps. Updated ???. o Linux IO Port mini-HOWTO (IO-Port), by Riku Saikkonen . How to use I/O ports in C programs. Updated 18 October 1994. o Linux Key Setup mini-HOWTO (Key-Setup), by Stephen Lee . How to set up cursor control keys. Updated 10 March 1995. o Linux Keystroke mini-HOWTO (Keystroke), by Zenon Fortuna . How to assign special action to keys. Updated 4 April 1995. o Linux Large IDE mini-HOWTO (Large-IDE), by Patrick LoPresti . How to use large IDE drives (kernel versions < 1.1.39). Updated ???. o Linux Man Page mini-HOWTO (Man-Page), by Jens Schweikhardt . How to write man pages. Updated March 1995. o Linux Modeline mini-HOWTO (Modeline), by Rick Niles . How to use 'modeline'. Updated 11 February 1995. o Linux Multiple Ethernet mini-HOWTO (Multiple-Ethernet.html), by Don Becker . How to use multiple ethernet cards (HTML format). Updated ???. o Linux Online Support mini-HOWTO (Online-Support), by lilo . Information about the Linux Internet Support Cooperative. Updated 2 January 1995. o Linux Proxy ARP mini-HOWTO (Proxy-ARP), by Al Longyear . A small treatise on the use of Proxy ARP. Updated 5 December 1994. o Linux Reading List (Reading-List), by James H. Haynes . Interesting books pertaining to Linux subjects. Updated 16 February 1995. o Linux Stacker mini-HOWTO (Stacker), by Corey Sweeney . How to mount MSDOS Stacked filesystems. Updated ???. o Linux Swap Space mini-HOWTO (Swap-Space), by H. Peter Anvin . How to share swap space between Linux and Windows. Updated 13 November 1995. o Linux Term Firewall mini-HOWTO (Term-Firewall), by Barak Pearlmutter . How to use 'term' over a firewall. Updated March 2 1995. o Linux Visual Bell mini-HOWTO (Visual-Bell), by Alessandro Rubini . How to disable audible bells, and enable visual bells. Updated July 1994. 4. Wanted HOWTOs I would be very happy if someone would write the following HOWTO documents, and submit them to me (see the instructions in the next section below). Most of these are modifications of existing FAQ documents, and should be easy to put into HOWTO format. Keep in mind that HOWTOs generally aren't in FAQ format, but can contain an FAQ section at the end. Some of these are under construction; however, if you're interested in working on one of them, please let me know. o GCC/LIBRARY HOWTO. Discussing installation/upgrading of the GCC and shared libraries under Linux. How to build shared libraries. Most of the material would come from Mitchum DeSouza's GCC FAQ. o If you have an idea for another HOWTO, please mail me! 5. Writing and submitting a HOWTO If you would like to write a Linux HOWTO document, there are a few guidelines that you should follow. o Format the document neatly. HOWTOs must be available in plain ASCII format, but you are free to use a formatting tool (texinfo, LameTeX, nroff) to format the document. 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. o You may wish to use the Linuxdoc-SGML package, available from ftp.cs.cornell.edu:/pub/mdw/, to format the HOWTO. This package allows you to produce LaTeX, plain ASCII, and HTML from a single source document, and was designed specifically with the HOWTOs in mind. If you are writing a new HOWTO you should seriously consider this. o 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. o 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). o 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. o Use other HOWTOs as a model. After you have written the HOWTO, mail it to me (Greg Hankins) at gregh@sunsite.unc.edu. If you have use Linuxdoc-SGML, simply mail me the SGML source; I take care of formatting the documents. I'll also take care of archiving the HOWTO and posting it 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. All you have to do is send me periodic updates (every month or so, as needed) and I will take care of posting the HOWTO regularly. 6. Miscellaneous and Legalese If you have questions, please feel free to mail gregh@sunsite.unc.edu. The Linux FAQ rewrite is being coordinated by Ian Jackson, ijackson@nyx.cs.du.edu, with help from others. 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, without permission of the author. Translations and derivative works are similarly permitted without express permission. Commercial redistribution is allowed and encouraged; however, the author would like to be notified of any such distributions. 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.