<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" [ <!ENTITY date "$FreeBSD: www/en/docs.sgml,v 1.100 2001/04/29 03:46:35 dd Exp $"> <!ENTITY title "Documentation"> <!ENTITY % includes SYSTEM "includes.sgml"> %includes; ]> <!-- $FreeBSD: www/en/docs.sgml,v 1.100 2001/04/29 03:46:35 dd Exp $ --> <html> &header; <img src="gifs/doc.jpg" alt="" align="right" border="0" width="274" height="163"> <p>A wide variety of documentation is available for FreeBSD, on this web site, on other web sites, and available over the counter.</p> <h2>On this site</h2> <p>All the documentation on this site can be downloaded in a variety of different formats (HTML, Postscript, PDF, and more) and compression schemes (GZip, BZip2, Zip) from the <a href="ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/">FreeBSD FTP site</a>.</p> <p>This documentation is provided and maintained by the <a href="docproj/docproj.html">FreeBSD Documentation Project</a>, and we are always looking for people to contribute new documentation and maintain existing documentation.</p> <h3>Books</h3> <p><a href="doc/en_US.ISO_8859-1/books/faq/index.html">The FreeBSD FAQ</a><br> <small>Frequently Asked Questions, and answers, covering all aspects of FreeBSD.</small></p> <p><a href="doc/en_US.ISO_8859-1/books/handbook/index.html">The FreeBSD Handbook</a><br> <small>A constantly evolving, comprehensive resource for FreeBSD users.</small></p> <p><a href="doc/en_US.ISO_8859-1/books/developers-handbook/index.html">The FreeBSD Developer's Handbook</a><br> <small>For people who want to develop software for FreeBSD (and not just people who are developing FreeBSD itself).</small></p> <p><a href="doc/en_US.ISO_8859-1/books/design-44bsd/index.html">Chapter 2 of "The Design and Implementation of the 4.4BSD Operating System"</a><br> <small>Donated by Addison-Wesley, provides a design overview of 4.4BSD, from which FreeBSD was originally derived.</small></p> <p><a href="doc/en_US.ISO_8859-1/books/corp-net-guide/index.html">Chapter 8 of "The FreeBSD Corporate Networker's Guide"</a><br> <small>Donated by Addison-Wesley, provides an in-depth look at using FreeBSD to provide printing services to Windows, NT, and Novell hosts.</small></p> <p><a href="doc/en_US.ISO_8859-1/books/ppp-primer/index.html">The Pedantic PPP Primer</a><br> <small>Everything you need to know about configuring PPP on FreeBSD.</small></p> <p><a href="doc/en_US.ISO_8859-1/books/porters-handbook">The Porter's Handbook</a><br> <small>Essential reading if you plan on providing a port of a third party piece of software.</small></p> <p><a href="doc/en_US.ISO_8859-1/books/fdp-primer">The FreeBSD Documentation Project Primer for New Contributors</a><br> <small>Everything you need to know in order to start contributing to the FreeBSD Documentation Project.</small></p> <h3>Articles</h3> <p><a href="doc/en_US.ISO_8859-1/articles/committers-guide/index.html">The Committer's Guide</a><br> <small>Introductory information for FreeBSD committers.</small></p> <p><a href="doc/en_US.ISO_8859-1/articles/dialup-firewall/index.html">Dialup firewalling with FreeBSD</a><br> <small>How to set up a firewall using PPP and ipfw over a dialup link with dynamically assigned IP addresses.</small></p> <p><a href="doc/en_US.ISO_8859-1/articles/diskless-x/index.html">Creating a diskless X server</a><br> <small>How to create a diskless X server.</small></p> <p><a href="doc/en_US.ISO_8859-1/articles/fonts/index.html">Fonts and FreeBSD</a><br> <small>A description of the various font technologies in FreeBSD, and how to use them with different programs.</small></p> <p><a href="doc/en_US.ISO_8859-1/articles/formatting-media/index.html">Formatting media on FreeBSD</a><br> <small>How to slice, partition, and format fixed and removable media on FreeBSD.</small></p> <p><a href="doc/en_US.ISO_8859-1/articles/freebsd-questions/index.html">How to get the best results from the FreeBSD-questions mailing list</a><br> <small>Tips and tricks to help you maximise the chances of getting useful information from the -questions mailing list.</small></p> <p><a href="doc/en_US.ISO_8859-1/articles/mh/index.html">An MH Primer</a><br> <small>An introduction to using the MH mail reader on FreeBSD.</small></p> <p><a href="doc/en_US.ISO_8859-1/articles/multi-os/index.html">Using FreeBSD with other operating systems</a><br> <small>How to install FreeBSD alongside one or more different operating systems on the same computer.</small></p> <p><a href="doc/en_US.ISO_8859-1/articles/new-users/index.html">FreeBSD First Steps</a><br> <small>For people coming to FreeBSD and Unix for the first time.</small></p> <p><a href="doc/en_US.ISO_8859-1/articles/programming-tools/index.html">Programming Tools on FreeBSD</a><br> <small>A user's guide to the various tools for software development on FreeBSD.</small></p> <p><a href="doc/en_US.ISO_8859-1/articles/zip-drive/index.html">Zip-drives and FreeBSD</a><br> <small>How to format, mount, and use an Iomega Zip (SCSI, IDE, or parallel) Drive on FreeBSD.</small></p> <h3>Manual pages</h3> <dl> <dt><strong>FreeBSD</strong></dt> <dd>For release: <a href="http://www.FreeBSD.org/cgi/man.cgi?manpath=FreeBSD+1.0-RELEASE">1.0</a>, <a href="http://www.FreeBSD.org/cgi/man.cgi?manpath=FreeBSD+1.1-RELEASE">1.1</a>, <a href="http://www.FreeBSD.org/cgi/man.cgi?manpath=FreeBSD+1.1.5.1-RELEASE">1.1.5.1</a>, <a href="http://www.FreeBSD.org/cgi/man.cgi?manpath=FreeBSD+2.0-RELEASE">2.0</a>, <a href="http://www.FreeBSD.org/cgi/man.cgi?manpath=FreeBSD+2.0.5-RELEASE">2.0.5</a>, <a href="http://www.FreeBSD.org/cgi/man.cgi?manpath=FreeBSD+2.1.0-RELEASE">2.1.0</a>, <a href="http://www.FreeBSD.org/cgi/man.cgi?manpath=FreeBSD+2.1.5-RELEASE">2.1.5</a>, <a href="http://www.FreeBSD.org/cgi/man.cgi?manpath=FreeBSD+2.1.6.1-RELEASE">2.1.6.1</a>, <a href="http://www.FreeBSD.org/cgi/man.cgi?manpath=FreeBSD+2.1.7.1-RELEASE">2.1.7.1</a>, <a href="http://www.FreeBSD.org/cgi/man.cgi?manpath=FreeBSD+2.2.1-RELEASE">2.2.1</a>, <a href="http://www.FreeBSD.org/cgi/man.cgi?manpath=FreeBSD+2.2.2-RELEASE">2.2.2</a>, <a href="http://www.FreeBSD.org/cgi/man.cgi?manpath=FreeBSD+2.2.5-RELEASE">2.2.5</a>, <a href="http://www.FreeBSD.org/cgi/man.cgi?manpath=FreeBSD+2.2.6-RELEASE">2.2.6</a>, <a href="http://www.FreeBSD.org/cgi/man.cgi?manpath=FreeBSD+2.2.7-RELEASE">2.2.7</a>, <a href="http://www.FreeBSD.org/cgi/man.cgi?manpath=FreeBSD+2.2.8-RELEASE">2.2.8</a>, <a href="http://www.FreeBSD.org/cgi/man.cgi?manpath=FreeBSD+3.0-RELEASE">3.0</a>, <a href="http://www.FreeBSD.org/cgi/man.cgi?manpath=FreeBSD+3.1-RELEASE">3.1</a>, <a href="http://www.FreeBSD.org/cgi/man.cgi?manpath=FreeBSD+3.2-RELEASE">3.2</a>, <a href="http://www.FreeBSD.org/cgi/man.cgi?manpath=FreeBSD+3.3-RELEASE">3.3</a>, <a href="http://www.FreeBSD.org/cgi/man.cgi?manpath=FreeBSD+3.4-RELEASE">3.4</a>, <a href="http://www.FreeBSD.org/cgi/man.cgi?manpath=FreeBSD+3.5.1-RELEASE">3.5.1</a>, <a href="http://www.FreeBSD.org/cgi/man.cgi?manpath=FreeBSD+4.0-RELEASE">4.0</a>, <a href="http://www.FreeBSD.org/cgi/man.cgi?manpath=FreeBSD+4.1-RELEASE">4.1</a>, <a href="http://www.FreeBSD.org/cgi/man.cgi?manpath=FreeBSD+4.2-RELEASE">4.2</a>, <a href="http://www.FreeBSD.org/cgi/man.cgi?manpath=FreeBSD+4.3-RELEASE">4.3</a>, <a href="http://www.FreeBSD.org/cgi/man.cgi?manpath=FreeBSD+5.0-current">5.0-current</a>, <a href="http://www.FreeBSD.org/cgi/man.cgi?manpath=FreeBSD+Ports">Ports</a>.</dd> <dt><strong>Other Systems</strong></dt> <dd><a href="http://www.FreeBSD.org/cgi/man.cgi?manpath=v7">Unix Seventh Edition (V7)</a>, <a href="http://www.FreeBSD.org/cgi/man.cgi?manpath=2.8BSD">2.8BSD</a>, <a href="http://www.FreeBSD.org/cgi/man.cgi?manpath=2.9BSD">2.9.1BSD</a>, <a href="http://www.FreeBSD.org/cgi/man.cgi?manpath=2.10BSD">2.10BSD</a>, <a href="http://www.FreeBSD.org/cgi/man.cgi?manpath=2.11BSD">2.11BSD</a>, <a href="http://www.FreeBSD.org/cgi/man.cgi?manpath=4.3BSD+Reno">4.3BSD Reno</a>, <a href="http://www.FreeBSD.org/cgi/man.cgi?manpath=NET%2F2">NET/2</a>, <a href="http://www.FreeBSD.org/cgi/man.cgi?manpath=386BSD+0.1">386BSD 0.1</a>, <a href="http://www.FreeBSD.org/cgi/man.cgi?manpath=4.4BSD+Lite2">4.4BSD Lite2</a>, <a href="http://www.FreeBSD.org/cgi/man.cgi?manpath=linux">Linux</a>, <a href="http://www.FreeBSD.org/cgi/man.cgi?manpath=NetBSD">NetBSD</a>, <a href="http://www.FreeBSD.org/cgi/man.cgi?manpath=OpenBSD">OpenBSD</a>, <a href="http://www.FreeBSD.org/cgi/man.cgi?manpath=darwin">Darwin</a>, <a href="http://www.FreeBSD.org/cgi/man.cgi?manpath=plan9">Plan 9</a>, <a href="http://www.FreeBSD.org/cgi/man.cgi?manpath=sunos4">SunOS 4.x</a>, <a href="http://www.FreeBSD.org/cgi/man.cgi?manpath=sunos5">SunOS 5.x</a>, <a href="http://www.FreeBSD.org/cgi/man.cgi?manpath=ultrix">ULTRIX 4.2</a>, and <a href="http://www.FreeBSD.org/cgi/man.cgi?manpath=XFree86">XFree86</a>. </dd> </dl> <h3>Other documentation</h3> <p><a href="http://docs.freebsd.org/44doc/">4.4BSD Documents</a>: This is a hypertext version of the 4.4BSD documents from <a href="file:/usr/share/doc">/usr/share/doc</a>, where you will find the documents on a FreeBSD machine (if you install the doc distribution).</p> <p><a href="http://docs.FreeBSD.org/info/">Info Documents</a>: This is a hypertext version of the Info documents from <a href="file:/usr/share/info">/usr/share/info</a>, where you will find the Info documents on a FreeBSD machine (if you install the info distribution).</p> <h2>On other web sites</h2> <p>Various independent efforts have also produced a great deal of useful information about FreeBSD.</p> <h3>Books</h3> <ul> <li> <p><a href="http://www.vmunix.com/fbsd-book/">A Comprehensive Guide to FreeBSD</a> - an attempt at a more readable, "book-like" tutorial explaining the FreeBSD Operating System. Intended for people new to both FreeBSD and UNIX. Currently a work in progress.</p> </li> </ul> <h3>Articles</h3> <ul> <li> <p><a href="http://www.computerbits.com/">Computer Bits</a>, an Internet online magazine, has, since March 1996, been running an excellent series of FreeBSD related articles in their column titled <strong>The Network Community</strong>, by <a href="mailto:tedm@agora.rdrop.com">Ted Mittelstaedt</a>.</p> <p>These articles cover everything from setting up <a href="http://www.computerbits.com/archive/9603/lan9603.htm">a FreeBSD based mail server</a> to doing <a href="http://www.computerbits.com/archive/9708/lan9708.htm">Network Address Translation</a> for other hosts.</p> </li> </ul> <ul> <li> <p><a href="mailto:mckusick@mckusick.com">Kirk McKusick</a>, one of the original architects of BSD at U.C. Berkeley, teaches two <a href="http://www.mckusick.com/courses/">4.4BSD Kernel Internals</a> courses using FreeBSD. For those unable to attend the courses in person, a video tape series is also now available.</p> </li> <li> <p><a href="http://flag.blackened.net/freebsd/">FreeBSD How-To's for the Lazy and Hopeless</a> is another somewhat more light-hearted attempt to provide more readable "how-to" style information on setting up and configuring FreeBSD.</p> </li> <li> <p><a href="http://www.linuxdoc.org/HOWTO/mini/Linux+FreeBSD.html">The Linux+FreeBSD mini-HOWTO</a> describes how to use Linux and FreeBSD on the same system. It introduces FreeBSD and discusses how the two operating systems can cooperate, e.g. by sharing swap space.</p> </li> <li> <p><a href="http://ukug.uk.FreeBSD.org/~mark/ntfs_install_2.2.html">Installing the FreeBSD 2.2.x NTFS (NT file system) driver</a>.</p> </li> <li><p><a href="http://ukug.uk.FreeBSD.org/~mark/ntfs_install_3.1.html">Installing the FreeBSD 3.1 NTFS driver</a>.</p> </li> <li> <p><a href="http://people.FreeBSD.org/~rpratt/">FreeBSD Installation Details for Newbies</a>.</p> <li> <p><a href="http://www.daemonnews.org/200010/blueprints.html">Dynamic Kernel Linker (KLD) Facility Programming Tutorial</a>.</p> </li> <li> <p><a href="http://www.daemonnews.org/200007/newbus-intro.html">How to Write Kernel Drivers with Newbus</a>.</p> </li> <li> <p><a href="http://www.daemonnews.org/200008/isa.html">Writing an ISA device driver</a>.</p> </li> <li> <p><a href=" http://www.int80h.org/bsdasm/">FreeBSD Assembly Language Programming Tutorial</a>.</p> </li> </ul> <h3>Links</h3> <ul> <li> <p>The <a href="http://dmoz.org/Computers/Operating_Systems/Unix/FreeBSD/">Open Directory Project</a> offers an excellent selection of links for FreeBSD, including a list of <a href="http://dmoz.org/Computers/Operating_Systems/Unix/FreeBSD/Prominent_Users/">prominent users</a> which can be helpful for marketing purposes.</p></li> </ul> <h2>In the real world...</h2> <h3><a href="news/press.html">FreeBSD in the Press</a></h3> <p>Articles in the press about FreeBSD.</p> <h2>Additional resources</h2> <h3><a href="y2kbug.html">Year 2000 Compatibility</a></h3> <p>The FreeBSD project's current statement about its Year 2000 compatibility.</p> <h3><a href="http://www.daemonnews.org/newsletter/">BSD Real-Quick (TM) Newsletter</a></h3> <p>A monthly (sometimes bi-weekly) newsletter announcing recent developments in the FreeBSD arena. Subscribe to freebsd-announce to receive this newsletter via e-mail.</p> <h3><a href="http://minnie.tuhs.org/FreeBSD-srctree/FreeBSD.html">The Source Code</a></h3> <p>If you like digging your fingers into source code, here is a hypertext version of the FreeBSD <em>kernel</em> source. This is brought to you courtesy of <a href="http://minnie.cs.adfa.oz.au/warren.html">Warren Toomey</a>.</p> <h3><a href="http://www.daemonnews.org/">Daemon News</a></h3> <p>The industry leader in BSD news.</p> <h3><a href="http://www.freebsdzine.org/">The FreeBSD 'zine</a></h3> <p>A monthly collection of easy to read (we hope) articles written by FreeBSD users and administrators just like you.</p> <p>Like FreeBSD itself, this documentation is the product of a volunteer effort. The goals of the project are outlined here, as are the procedures for submitting corrections and new material.</p> <h3><a name="diary" href="http://www.freebsddiary.org/">The FreeBSD Diary</a></h3> <p>The FreeBSD Diary is a collection of how-to entries aimed at UNIX novices. The aim is to provide a set of step-by-step guides to installing and configuring various ports.</p> &footer; </body> </html> <!-- Local Variables: mode: sgml sgml-indent-data: t sgml-omittag: nil sgml-always-quote-attributes: t End: -->