The Linux HOWTO Index
by Guylhem Aznar, guylhem@oeil.qc.ca
v3, February 2000
This document contains an index to the Linux HOWTOs as well as other
information about the HOWTO project.
______________________________________________________________________
Table of Contents
1. What Are Linux HOWTOs?
2. Where Can I Get Linux HOWTOs?
2.1 HOWTO Translations
3. Index
3.1 HOWTOs
3.2 Special HOWTOs
3.3 Unmaintained HOWTOs
4. Writing and Submitting a HOWTO
5. Copyright
______________________________________________________________________
11.. WWhhaatt AArree LLiinnuuxx HHOOWWTTOOss??
Linux HOWTOs are documents which describe in detail a certain aspect
of configuring or using Linux. For example, there is the _I_n_s_t_a_l_l_a_t_i_o_n
_H_O_W_T_O, which gives instructions on installing Linux, and the _M_a_i_l
_H_O_W_T_O, which describes how to set up and configure mail under Linux.
Other examples include the _N_E_T_-_3 _H_O_W_T_O and the _P_r_i_n_t_i_n_g _H_O_W_T_O.
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 on
short, specific subjects.
22.. WWhheerree CCaann II GGeett LLiinnuuxx HHOOWWTTOOss??
HOWTOs can be retrieved via anonymous FTP from the following sites:
+o ftp://metalab.unc.edu/pub/Linux/docs/HOWTO
+o ftp://tsx-11.mit.edu/pub/linux/docs/HOWTO
as well as many mirror sites.
You can also browse HOWTOs in HTML format
or grab All-html-HOWTOs.tar.gz
for viewing
on your own PC. The files will be extracted into HOWTO/html/.
Many mirror sites mirror
the HTML files.
metalab.unc.edu is heavily used, so please use a mirror site if
possible.
HOWTOs are also posted towards the beginning of the month to the
Usenet newsgroup comp.os.linux.answers. There is a tool called
NewstoHOWTO that
will assemble the postings.
22..11.. HHOOWWTTOO TTrraannssllaattiioonnss
HOWTO translations are available on metalab.unc.edu
and mirrors
around the world. So far there are:
+o Chinese (zh)
+o Croatian (hr)
+o French (fr)
+o German (de)
+o Hellenic (el)
+o Indonesian (id)
+o Italian (it)
+o Japanese (ja)
+o Korean (ko)
+o Polish (pl)
+o Slovenian (sl)
+o Spanish (es)
+o Swedish (sv)
+o Turkish (tr)
If you know of any other translation projects, please let me know and
I will add them to this list. If you are interested in getting your
translations archived on metalab.unc.edu, please read the directory
structure specification at
http://metalab.unc.edu/pub/Linux/docs/HOWTO/translations/Directory-
Structure and get in touch with me.
33.. IInnddeexx
33..11.. HHOOWWTTOOss
The following Linux HOWTOs are currently available:
+o 3Dfx-HOWTO, updated: February 1998,
+o AI-Alife-HOWTO, updated: Jan 2000,
+o AX25-HOWTO, updated: October 1997,
+o Access-HOWTO, updated: March 1997,
+o Alpha-HOWTO, updated: June 1997,
+o Assembly-HOWTO, updated: February 2000,
+o Bash-Prompt-HOWTO, updated: December 1999,
+o Belgian-HOWTO, updated: September 1999,
+o Benchmarking-HOWTO, updated: August 1997,
+o Beowulf-HOWTO, updated: November 1998,
+o BootPrompt-HOWTO, updated: May 1999,
+o Bootdisk-HOWTO, updated: January 2000,
+o Busmouse-HOWTO, updated: June 1998,
+o C-C++Beautifier-HOWTO, updated: February 2000 ,
+o CD-Writing-HOWTO, updated: September 1999,
+o CDROM-HOWTO, updated: March 1999,
+o CVS-HOWTO, updated: December 1999,
+o CVS-RCS-HOWTO, updated: November 1999,
+o Chinese-HOWTO, updated: June 1998,
+o Commercial-HOWTO, updated: March 1999,
+o Config-HOWTO, updated: September 1999,
+o Consultants-HOWTO, updated: September 1999,
+o Cyrillic-HOWTO, updated: January 1998,
+o DNS-HOWTO, updated: February 1999,
+o DOS-Win-to-Linux-HOWTO, updated: February 1999,
+o DOSEMU-HOWTO, updated: March 1997,
+o Danish-HOWTO, updated: February 1999,
+o Diskless-HOWTO, updated: Jan 2000,
+o Diskless-root-NFS-HOWTO, updated: March 1999,
+o Distribution-HOWTO, updated: February 2000,
+o Ecology-HOWTO, updated: January 2000,
+o Emacs-Beginner-HOWTO, updated: October 1999,
+o Emacspeak-HOWTO, updated: April 1999,
+o Enterprise-Java-for-Linux-HOWTO, updated: January 1999,
+o Esperanto-HOWTO, updated: August 1999,
+o Ethernet-HOWTO, updated: May 1999,
+o Finnish-HOWTO, updated: February 1996,
+o Firewall-HOWTO, updated: September 1999,
+o Font-HOWTO, updated:
+o Framebuffer-HOWTO, updated: July 1999,
+o Francophones-HOWTO, updated: Dcembre 1999,
+o From-PowerUp-To-Bash-Prompt-HOWTO, updated: February 2000,
+o Ftape-HOWTO, updated: August 1998,
+o GCC-HOWTO, updated: February 1996,
+o German-HOWTO, updated: March 1997,
+o Glibc2-HOWTO, updated: June 1998,
+o HOWTO-HOWTO, updated: February 1999,
+o HOWTO-INDEX, updated: February 2000,
+o Hardware-HOWTO, updated: September 1999,
+o Hebrew-HOWTO, updated: September 1995,
+o Hellenic-HOWTO, updated: Augoustos 1997,
+o INFO-SHEET, updated: September 1998,
+o IP-Masquerade-HOWTO, updated: January 2000,
+o IPCHAINS-HOWTO, updated: March 1999,
+o IPX-HOWTO, updated: May 1998,
+o IR-HOWTO, updated: September 1999,
+o ISP-Hookup-HOWTO, updated: March 1998,
+o IngresII-HOWTO, updated: December 1999,
+o Installation-HOWTO, updated: November 1999,
+o Intranet-Server-HOWTO, updated: August 1997,
+o Italian-HOWTO, updated: November 1998,
+o Java-CGI-HOWTO, updated: December 1998,
+o Jaz-Drive-HOWTO, updated: January 2000,
+o Kernel-HOWTO, updated: June 1999,
+o Keyboard-and-Console-HOWTO, updated: February 1998,
+o KickStart-HOWTO, updated: January 1999,
+o Kiosk-HOWTO, updated: October 1999,
+o LDAP-HOWTO, updated: June 1999,
+o LFS-HOWTO, updated: February 2000,
+o Laptop-HOWTO, updated: December 1999,
+o Large-Disk-HOWTO, updated: November 1999,
+o Linux-From-Scratch-HOWTO, updated: January 2000,
+o LinuxDoc+Emacs+Ispell-HOWTO, updated: February 1998,
+o Loopback-Encrypted-Filesystem-HOWTO, updated: November 1999,
+o META-FAQ, updated: October 1997,
+o MGR-HOWTO, updated: May 1996,
+o MILO-HOWTO, updated: December 1996,
+o MIPS-HOWTO, updated: March 1999,
+o MP3-HOWTO, updated: September 1999,
+o Mail-Administrator-HOWTO, updated: January 2000,
+o Mail-User-HOWTO, updated: May 1999,
+o Majordomo-MajorCool-HOWTO, updated: November 1999,
+o Modem-HOWTO, updated: January 2000,
+o Multi-Disk-HOWTO, updated: November 1999,
+o Multicast-HOWTO, updated: March 1998,
+o Mutt-GnuPG-PGP-HOWTO, updated: February 2000,
+o NC-HOWTO, updated: December 1999,
+o NCD-HOWTO, updated: Sept 1999,
+o NET3-4-HOWTO, updated: August 1999,
+o NFS-HOWTO, updated: October 1999,
+o NIS-HOWTO, updated: March 1999,
+o Net-HOWTO, updated: December 1999,
+o Networking-Overview-HOWTO, updated: September 1999,
+o Online-Troubleshooting-HOWTO, updated: September 1999,
+o Optical-Disk-HOWTO, updated: December 1998,
+o Oracle-HOWTO, updated: August 1998,
+o PCI-HOWTO, updated: March 1997,
+o PCMCIA-HOWTO, updated: December 1999,
+o PLIP-Install-HOWTO, updated: November 1999,
+o PPP-HOWTO, updated: March 1997,
+o PalmOS-HOWTO, updated: September 1998,
+o Parallel-Processing-HOWTO, updated: January 1998,
+o Plug-and-Play-HOWTO, updated: January 2000,
+o Polish-HOWTO, updated: February 1999,
+o Portuguese-HOWTO, updated: de 1999,
+o PostgreSQL-HOWTO, updated: December 1999,
+o Printing-HOWTO, updated: Feb 2000,
+o Printing-Usage-HOWTO, updated: February 1998,
+o Process-Monitor-HOWTO, updated: December 1999,
+o Psion-HOWTO, updated: Nov 1999,
+o Quake-HOWTO, updated: August 1998,
+o Reading-List-HOWTO, updated: November 1999,
+o Root-RAID-HOWTO, updated: March 1998,
+o SCSI-Programming-HOWTO, updated: May 1996,
+o SMB-HOWTO, updated: June 1999,
+o SMP-HOWTO, updated: January 2000,
+o SRM-HOWTO, updated: December 1999,
+o Secure-Programs-HOWTO, updated: February 2000,
+o Securing-Domain-HOWTO, updated: and 2049,
+o Security-HOWTO, updated: April 1999,
+o Serbian-HOWTO, updated: November 1998,
+o Serial-HOWTO, updated: January 2000,
+o Serial-Programming-HOWTO, updated: January 1998,
+o Shadow-Password-HOWTO, updated: April 1996,
+o Slovenian-HOWTO, updated: February 1999,
+o Software-Building-HOWTO, updated: July 1999,
+o Software-RAID-HOWTO, updated: November 1998,
+o Software-Release-Practice-HOWTO, updated: January 2000,
+o Sound-HOWTO, updated: March 1999,
+o Sound-Playing-HOWTO, updated: August 1998,
+o Spanish-HOWTO, updated: August 1996,
+o TclTk-HOWTO, updated: November 1998,
+o TeTeX-HOWTO, updated: November 1998,
+o Text-Terminal-HOWTO, updated: December 1999,
+o Thai-HOWTO, updated: August 1998,
+o Thinclient-HOWTO, updated: November 1999,
+o Tips-HOWTO, updated: June 1998,
+o Turkish-HOWTO, updated: September 1999,
+o UMSDOS-HOWTO, updated: November 1995,
+o UPS-HOWTO, updated: November 1997,
+o UUCP-HOWTO, updated: February 1998,
+o Unicode-HOWTO, updated: October 1999,
+o Unix-Internet-Fundamentals-HOWTO, updated: September 1999,
+o Unix-and-Internet-Fundamentals-HOWTO, updated: February 2000,
+o User-Group-HOWTO, updated: April 1998,
+o VAR-HOWTO, updated: August 1999,
+o VME-HOWTO, updated: July 1998,
+o VMS-to-Linux-HOWTO, updated: September 1999,
+o VPN-HOWTO, updated: Dec 1999,
+o VPN-Masquerade-HOWTO, updated: September 1999,
+o Vim-HOWTO, updated: December 1999,
+o Virtual-Services-HOWTO, updated: August 1998,
+o WWW-HOWTO, updated: August 1999,
+o WWW-mSQL-HOWTO, updated: September 1997,
+o Wacom-Tablet-HOWTO, updated: Nov 1999,
+o Wearable-HOWTO, updated: December 1999,
+o XFree86-HOWTO, updated: May 1999,
+o XFree86-Video-Timings-HOWTO, updated: January 2000,
+o XWindow-User-HOWTO, updated: September 1999,
+o 3-Button-Mouse, updated: May 1998,
+o ADSL, updated: April 1999,
+o ADSM-Backup, updated: January 1997,
+o Advocacy, updated: May 1998,
+o Alsa-sound, updated: November 1999,
+o Apache+SSL+PHP+fp, updated: July 1998,
+o Automount, updated: April 1999,
+o BTTV-Mini-HOWTO-0.3, updated: February 2000,
+o Backup-With-MSDOS, updated: August 1997,
+o Battery-Powered, updated: December 1997,
+o BogoMips, updated: November 1999,
+o Bridge+Firewall, updated: December 1997,
+o Bridge, updated: September 1998,
+o Bzip2, updated: August 1999,
+o Cipe+Masq, updated: April 1999,
+o Clock, updated: July 1999,
+o Coffee, updated: January 1998,
+o Commercial-Port-Advocacy, updated: December 1999,
+o DPT-Hardware-RAID, updated: April 1999,
+o Domain-Setup-mini-HOWTO, updated: and 2049,
+o Ext2fs-Undeletion, updated: February 1999,
+o FTP, updated: January 2000,
+o Fax-Server, updated: November 1997,
+o Firewall-Piercing, updated: November 1998,
+o Firewall-and-ADSL-mini-HOWTO, updated:
+o Font-Deuglification-mini-HOWTO, updated: November 1999,
+o Home-Network-mini-HOWTO, updated: January 2000,
+o IO-Port-Programming, updated: December 1997,
+o IP-Subnetworking, updated: March 1997,
+o ISP-Connectivity, updated: November 1997,
+o Install-From-ZIP, updated: April 1998,
+o LBX, updated: December 1997,
+o LILO, updated: August 1998,
+o Linux+DOS+Win95+OS2, updated: November 1997,
+o Linux+FreeBSD, updated: January 1999,
+o Linux+NT-Loader, updated: September 1997,
+o Loadlin+Win95, updated: March 1999,
+o Loopback-Root-FS, updated: September 1999,
+o Mac-Terminal, updated: November 1997,
+o Mail-Queue, updated: September 1997,
+o Mail2News, updated: July 1999,
+o Multiboot-with-LILO, updated: March 1998,
+o NCD-X-Terminal, updated: November 1999,
+o NFS-Root, updated: August 1997,
+o Netrom-Node, updated: October 1998,
+o Netstation, updated: February 1998,
+o News-Leafsite, updated: January 1998,
+o Offline-Mailing, updated: June 1998,
+o PLIP, updated: March 1998,
+o Partition-Rescue-mini-HOWTO, updated: Jan 2000,
+o Partition, updated: November 1997,
+o Path, updated: November 1997,
+o Programming-Languages, updated: January 2000,
+o Public-Web-Browser, updated: January 1998,
+o Qmail+MH, updated: March 1998,
+o Quota, updated: August 1997,
+o RCS, updated: August 1997,
+o RPM+Slackware, updated: April 1998,
+o RedHat-CD, updated: September 1999,
+o Remote-Boot, updated: February 1999,
+o Remote-X-Apps, updated: November 1999,
+o Saving-Space, updated: April 1999,
+o Secure-POP+SSH, updated: September 1998,
+o Sendmail+UUCP, updated: May 1998,
+o Sendmail-Address-Rewrite, updated: May 1998,
+o Software-RAID, updated: November 1998,
+o Soundblaster-AWE, updated: January 1998,
+o StarOffice, updated: November 1999,
+o Swap-Space, updated: December 1999,
+o TT-Debian, updated: January 2000,
+o Term-Firewall, updated: July 1996,
+o TkRat, updated: September 1999,
+o Token-Ring, updated: January 1998,
+o Ultra-DMA, updated: November 1999,
+o Update, updated: September 1999,
+o Upgrade, updated: June 1996,
+o VAIO+Linux, updated: September 1998,
+o VPN, updated: August 1997,
+o Visual-Bell, updated: November 1997,
+o WordPerfect, updated: August 1997,
+o X-Big-Cursor, updated: August 1997,
+o XFree86-XInside, updated: September 1997,
+o Xterm-Title, updated: October 1999,
+o ZIP-Drive, updated: January 1999,
+o ZIP-Install, updated: January 1998,
33..22.. SSppeecciiaall HHOOWWTTOOss
The _H_i_g_h _A_v_a_i_l_a_b_i_l_i_t_y _H_O_W_T_O, by Harald Milz is
available at http://metalab.unc.edu/pub/Linux/ALPHA/linux-ha/High-
Availability-HOWTO.html. It is not included with the HOWTO collection
because it relies on figures and cannot be distributed in all
supported formats.
The _G_r_a_p_h_i_c_s _m_i_n_i_-_H_O_W_T_O, by Michael J. Hammel is available at http://www.graphics-muse.org/linux/lgh.html.
It is not included with the HOWTO collection because it needs to use a
lot of images, which don't translate to other output formats.
33..33.. UUnnmmaaiinnttaaiinneedd HHOOWWTTOOss
There are a number of unmaintained documents.
These are kept around since old documentation is sometimes better than
none. However, you should _b_e _a_w_a_r_e _t_h_a_t _y_o_u _a_r_e _r_e_a_d_i_n_g _o_l_d
_d_o_c_u_m_e_n_t_a_t_i_o_n.
If the date tag is too old, please consider the HOWTO as unmaintained.
However, there are exceptions, such as old programs (for ex UUCP
HOWTO) or not-so-hot topics (for ex AX-25 HOWTO).
44.. WWrriittiinngg aanndd SSuubbmmiittttiinngg aa HHOOWWTTOO
If you are interested in writing or maintaining a HOWTO, please get in
touch with us FFIIRRSSTT!!!!!! at ldp-discuss@lists.linuxdoc.org.
If you want to maintain a unmaintained HOWTO, please also get in touch
with the former author.
Here are a few guidelines that you should follow when writing a HOWTO:
+o 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 If you are writing a HOWTO, you _m_u_s_t use the SGML-Tools package,
available from http://www.sgmltools.org/, to format the HOWTO. This
package allows us to produce HTML, LaTeX (for DVI and PostScript),
plain text and DocBook sgml from a single source document, and was
designed specifically for the HOWTOs. This also gives all of the
HOWTOs a uniform look. It is very important that you format and
review the output of the formatting in PostScript, plain text and
HTML.
+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), and the current version number and release date of the
software.
+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 a model! The SGML source to the HOWTOs is
available on Linux FTP sites. In addition, have a look at the LDP
Style Guide , the HOWTO-HOWTO, the LDP manifesto and the LDP license
guide.
+o Make sure that your name, email address, date, and a version number
is near the beginning of the document. You could also include WWW
addresses and a snail mail address if you want. The standard
header is:
Title
Author's name and email address
Version number and date
for example:
The Linux HOWTO Index
by Tim Bynum
v2.10.29, 31 July 1997
+o 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 the SGML source to us at ldp-
submit@lists.linuxdoc.org.
It is _i_m_p_o_r_t_a_n_t that you go through us when submitting a HOWTO, as we
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.
55.. CCooppyyrriigghhtt
Copyright (c) 1995 - 2000 by Tim Bynum. Copyright (c) 2000 by Guylhem
Aznar.
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 the Linux HOWTO coordinator, at
linux-howto@metalab.unc.edu via email.