<!DOCTYPE HTML PUBLIC "-//FreeBSD//DTD HTML 4.01 Transitional-Based Extension//EN" [
<!ENTITY base CDATA "..">
<!ENTITY date "$FreeBSD$">
<!ENTITY title "Books and Articles Online">
<!ENTITY % navinclude.docs "INCLUDE">

<!ENTITY url.articles "../doc/en_US.ISO8859-1/articles">
<!ENTITY url.books "../doc/en_US.ISO8859-1/books">
]>

<html>
&header;

	<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 (BZip2, Zip) from the <a
	      href="ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/">FreeBSD FTP site</a>.</p>

	    <p>Archived copies of the &os; documentation (articles,
	      books, and textinfo manuals) are also available online at
	      <a href="http://docs.FreeBSD.org/doc/">http://docs.FreeBSD.org/doc/</a>.</p>

	    <p>This documentation is provided and maintained by the <a
	      href="&base;/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="&url.books;/dev-model/index.html">A project
  	      model for the FreeBSD project</a> (dev-model)<br>
            A formal study of the organization of the FreeBSD project.</p>

	    <p><a href="&url.books;/faq/index.html">The FreeBSD FAQ</a>
	        (faq)<br>
	      Frequently Asked Questions, and answers, covering all
		aspects of FreeBSD.</p>

	    <p><a href="&url.books;/handbook/index.html">The FreeBSD Handbook</a>
	        (handbook)<br>
	      A constantly evolving, comprehensive resource for FreeBSD
		users.</p>

	    <p><a href="&url.books;/developers-handbook/index.html">The
	        FreeBSD Developers' Handbook</a> (developers-handbook)<br>
	      For people who want to develop software for FreeBSD (and not
	        just people who are developing FreeBSD itself).</p>

	    <p><a href="&url.books;/arch-handbook/index.html">The
	        FreeBSD Architecture Handbook</a> (arch-handbook)<br>
	      For FreeBSD system developers.  This book covers the
		architectural details of many important FreeBSD kernel
		subsystems.</p>

	    <p><a href="&url.books;/porters-handbook/index.html">The Porter's
	        Handbook</a> (porters-handbook)<br>
	      Essential reading if you plan on providing a port of a third
		party piece of software.</p>

	    <p><a href="&url.books;/pmake/index.html">The PMake Tutorial</a>
	        (pmake)<br>
	      A tutorial for the <em>make</em> utility.  This book is essential
		reading for anyone who wants to understand all the details of using
		<em>make</em> of reading and writing makefiles.</p>

	    <p><a href="&url.books;/design-44bsd/index.html">Chapter 2
	        of "The Design and Implementation of the 4.4BSD Operating
	        System"</a> (design-44bsd)<br>
	      Donated by Addison-Wesley, provides a design overview of 4.4BSD,
		from which FreeBSD was originally derived.</p>

	    <p><a href="&url.books;/corp-net-guide/index.html">Chapter
	        8 of "The FreeBSD Corporate Networker's Guide"</a>
	        (corp-net-guide)<br>
	      Donated by Addison-Wesley, provides an in-depth look at using
	        FreeBSD to provide printing services to Windows, NT, and Novell
	        hosts.</p>

	    <p><a href="&url.books;/fdp-primer/index.html">The FreeBSD
	        Documentation Project Primer for New Contributors</a>
	        (fdp-primer)<br>
	      Everything you need to know in order to start contributing to the
		FreeBSD Documentation Project.</p>

	    <a name="ARTICLES"></a><h3>Articles</h3>

	<!-- Articles are sorted by pathname -->

	    <p><a href="&url.articles;/5-roadmap/index.html">The
	        Roadmap for 5-STABLE</a> (5-roadmap)<br>
	      Describes medium-term development and release engineering
	        plans leading to the 5-STABLE branch point.  This
	        article is primarily of historical interest.</p>

          <p><a href="&url.articles;/bsdl-gpl/index.html">Why you should use
              a BSD style license for your Open Source Project</a> (bsdl-gpl)<br>
              Describes the benefits of releasing code under a BSD
	      license.</p>

          <p><a href="&url.articles;/building-products/index.html">Building
              Products with FreeBSD</a> (building-products)<br>
              How FreeBSD can help you build a better product.</p>

	    <p><a href="&url.articles;/casestudy-argentina.com/index.html">Argentina.com : A Case Study</a> (casestudy-argentina.com)<br>
	      How FreeBSD helped a large ISP in Latin America.</p>

	    <p><a href="&url.articles;/checkpoint/index.html">Integration
	        of Checkpoint VPN-1/Firewall-1 and FreeBSD IPsec</a>
	        (checkpoint)<br>
	      How to configure Checkpoint VPN-1/Firewall-1 and FreeBSD
	        IPsec.</p>

	    <p><a href="&url.articles;/committers-guide/index.html">The
	        Committer's Guide</a> (committers-guide)<br>
		Introductory information for FreeBSD committers.</p>

	    <p><a href="&url.articles;/compiz-fusion/index.html">Installing
		and using Compiz Fusion</a> (compiz-fusion)<br>
                How to install and use the Compiz Fusion composite window
		manager under FreeBSD.</p>

	    <p><a href="&url.articles;/console-server/index.html">Console
	        Server Tutorial</a> (console-server)<br>
	      How to setup a FreeBSD based console server with a cheap
	        multi-port serial card.</p>

	    <p><a href="&url.articles;/contributing/index.html">Contributing
	        to FreeBSD</a> (contributing)<br>
	      How to contribute to the FreeBSD Project.</p>

	    <p><a href="&url.articles;/contributing-ports/index.html">
	        Contributing to the FreeBSD Ports Collection</a>
	        (contributing-ports)<br>
	      How to help maintain the FreeBSD Ports Collection.</p>

	    <p><a href="&url.articles;/contributors/index.html">The
	        List of FreeBSD Contributors</a> (contributors)<br>
	      A list of organizations and individuals who have helped
	        enhance FreeBSD.</p>

	    <p><a href="&url.articles;/cups/index.html">CUPS on &os;</a>
	      (cups)<br>
	      How to setup CUPS with &os;.</p>

	    <p><a href="&url.articles;/custom-gcc/index.html">Using
		newer version of GCC and binutils with the &os; Ports
		Collection</a> (custom-gcc)<br>
	      How to use newer versions of the GCC compilers and
	      binutils from the &os; ports tree.  Custom GCC
	      are also discussed.</p>

	    <p><a href="&url.articles;/cvs-freebsd/index.html">Setting up a
	        CVS repository - The FreeBSD way</a> (cvs-freebsd)<br>
	      How to set up a CVS repository that uses the same CVSROOT
	        infrastructure as the FreeBSD project.</p>

	    <p><a href="&url.articles;/cvsup-advanced/index.html">CVSup
	        Advanced Points</a> (cvsup-advanced)<br>
	      An article with some tips about the subtleties of
	        CVSup.</p>

	    <p><a href="&url.articles;/dialup-firewall/index.html">Dialup
		firewalling with FreeBSD</a> (dialup-firewall)<br>
	      How to set up a firewall using PPP and ipfw over a dialup link
		with dynamically assigned IP addresses.</p>

	    <p><a href="&url.articles;/diskless-x/index.html">Creating
	        a diskless X server</a> (diskless-x)<br>
	      How to create a diskless X server.</p>

	    <p><a href="&url.articles;/euro/index.html">The Euro symbol
	        on FreeBSD</a> (euro)<br>
	      How to configure FreeBSD and related applications to display the
	        Euro symbol.</p>

	    <p><a href="&url.articles;/explaining-bsd/index.html">Explaining
		BSD</a> (explaining-bsd)<br>
	      An answer to the question ``What is BSD?''</p>

	    <p><a href="&url.articles;/fbsd-from-scratch/index.html">FreeBSD
		From Scratch</a> (fbsd-from-scratch)<br>
	      How to automatically compile, install and configure a system from
	        scratch (i.e. to an empty file system), including your favorite
	        ports.</p>

	    <p><a href="&url.articles;/filtering-bridges/index.html">Filtering
		Bridges</a> (filtering-bridges)<br>
	      Configuring firewalls and filtering on FreeBSD hosts acting as
		bridges rather than routers.</p>

	    <p><a href="&url.articles;/fonts/index.html">Fonts and
	        FreeBSD</a> (fonts)<br>
	      A description of the various font technologies in FreeBSD, and
		how to use them with different programs.</p>

	    <p><a href="&url.articles;/formatting-media/index.html">Formatting
	        media on FreeBSD</a> (formatting-media)<br>
	      How to slice, partition, and format fixed and removable media on
		FreeBSD.</p>

	    <p><a href="&url.articles;/freebsd-questions/index.html">How
	        to get the best results from the FreeBSD-questions mailing list</a>
	        (freebsd-questions)<br>
	      Tips and tricks to help you maximize the chances of getting
		useful information from the -questions mailing list.</p>

	    <p><a href="&url.articles;/freebsd-update-server/index.html">Build
	        Your Own FreeBSD Update Server</a>
	        (freebsd-update-server)<br>
	      Using a FreeBSD Update server allows a system
		administrator to perform fast updates for a number of
		machines from a local mirror.</p>

	    <p><a href="&url.articles;/geom-class/index.html">Writing
	        a GEOM Class</a> (geom-class)<br>
	      A guide to GEOM internals, and writing your own class.</p>

	    <p><a href="&url.articles;/gjournal-desktop/index.html">Implementing
	        UFS journaling on a desktop PC</a> (gjournal-desktop)<br>
	      A guide to create UFS partitions configured with journaling
		for desktop use.</p>

	    <p><a href="&url.articles;/hats/index.html">Working with Hats</a>
	        (hats)<br>
	      A committer's guide to working with ``hats'' (other
	        committers with authority over specific areas of
		FreeBSD).</p>

	    <p><a href="&url.articles;/hubs/index.html">Mirroring FreeBSD</a>
	        (hubs)
	      <br>The all in one guide for mirroring the FreeBSD website,
	        CVSup servers, FTP servers, and more.</p>

	    <p><a href="&url.articles;/ipsec-must/index.html">Independent
		Verification of IPsec Functionality in FreeBSD</a>
	        (ipsec-must)<br>
	      A method for experimentally verifying IPsec
		functionality.</p>

	    <p><a href="&url.articles;/laptop/index.html">FreeBSD on Laptops</a>
	        (laptop)<br>
	      Information about running FreeBSD on a laptop.</p>

	    <p><a href="&url.articles;/ldap-auth/index.html">LDAP Authentication</a>
		(ldap-auth)<br>
	      A practical guide about setting up an LDAP server on
		&os; and how to use it for authenticating users.</p>

	    <p><a href="&url.articles;/linux-comparison/index.html">FreeBSD: An Open Source Alternative to Linux</a>
	        (linux-comparison)<br>
	      A white paper explaining the differences between Linux
	        and FreeBSD.</p>

	    <p><a href="&url.articles;/linux-emulation/index.html">Linux emulation in &os;</a>
		(linux-emulation)<br>
	      A technical description about the internals of the Linux
		emulation layer in &os;.</p>

	    <p><a href="&url.articles;/linux-users/index.html">&os; Quickstart Guide for Linux Users</a>
		(linux-users)<br>
	      An introductionary guide for the users that came from Linux.</p>

	    <p><a href="&url.articles;/mailing-list-faq/index.html">Frequently
		Asked Questions About The FreeBSD Mailing Lists</a>
		(mailing-list-faq)<br>
	      How to best use the mailing lists, such as how to help
		avoid frequently-repeated discussions.</p>

	    <p><a href="&url.articles;/mh/index.html">An MH Primer</a>
	        (mh)<br>
	      An introduction to using the MH mail reader on
		FreeBSD.</p>

	    <p><a href="&url.articles;/multi-os/index.html">Using
	        FreeBSD with other operating systems</a> (multi-os)<br>
	      How to install FreeBSD alongside one or more different operating
		systems on the same computer.</p>

	    <p><a href="&url.articles;/nanobsd/index.html">Introduction
                to NanoBSD</a> (nanobsd)<br>
	      Information about the NanoBSD tools, which can be used to
	      create FreeBSD system images for embedded applications,
	      suitable for use on a Compact Flash card (or other mass
	      storage medium).</p>

	    <p><a href="&url.articles;/new-users/index.html">FreeBSD
	        First Steps</a> (new-users)<br>
	      For people coming to FreeBSD and &unix; for the first
		time.</p>

	    <p><a href="&url.articles;/p4-primer/index.html">Perforce
	      in FreeBSD Development</a> (p4-primer)<br>
	      A guide to the Perforce version control system.  It also
	      describes how to manage experimental projects with the
	      FreeBSD Perforce server.</p>

	    <p><a href="&url.articles;/pam/index.html">Pluggable
	        Authentication Modules</a> (pam)<br>
	      A guide to the PAM system and modules under
	        FreeBSD.</p>

	    <p><a href="&url.articles;/portbuild/index.html">Package
		building procedures</a> (portbuild)<br>
	      Describes the approach used by the FreeBSD port
	        manager team to regularly build ports into packages.
	        It describes the portbuild cluster, as well as the tools
	        needed to do incremental, experimental, and official release
	        package builds.</p>

	    <p><a href="&url.articles;/pr-guidelines/index.html">FreeBSD
		Problem Report Handling Guidelines</a> (pr-guidelines)<br>
	      Recommended practices for handling FreeBSD problem
		reports.</p>

	    <p><a href="&url.articles;/problem-reports/index.html">Writing
	        FreeBSD Problem Reports</a> (problem-reports)<br>
	      How to best formulate and submit a problem report to the
	        FreeBSD Project.</p>

	    <p><a href="&url.articles;/pxe/index.html">PXE booting
		FreeBSD</a> (pxe)<br>
	      How to create an Intel PXE server using FreeBSD, and how to
		configure a FreeBSD client to boot from a PXE server.</p>

	    <p><a href="&url.articles;/rc-scripting/index.html">Practical
		rc.d scripting in BSD</a> (rc-scripting)<br>
	      A guide to writing new rc.d scripts and understanding those
		already written.</p>

	    <p><a href="&url.articles;/relaydelay/index.html">FreeBSD as
		a greylist mail server</a> (relaydelay)<br>
	       Implementing a greylist mail server on FreeBSD
		using Sendmail, MySQL, Perl and the relaydelay
		software.  This is an excellent method to use in the
		fight against spam.</p>

	    <p><a href="&url.articles;/releng/index.html">FreeBSD
		Release Engineering</a> (releng)<br>
	      Describes the approach used by the FreeBSD release
		engineering team to make production quality releases of the
		FreeBSD Operating System. It describes the tools available
		for those interested in producing customized FreeBSD releases
		for corporate rollouts or commercial productization.</p>

	    <p><a href="&url.articles;/releng-packages/index.html">FreeBSD
		Release Engineering for Third Party Packages</a>
	        (releng-packages)<br>
	      Describes the approach used by the FreeBSD
	        ports management team to produce a high quality package set
	        suitable for official FreeBSD release media.  This document is
	        a work in progress, but eventually it will cover the process
	        used to build a clean package set on the FreeBSD.org "Ports
	        Cluster", how to configure any other set of machines as a
	        ports cluster, how to split up the packages for the release
	        media, and how to verify that a package set is
	        consistent.</p>

	    <p><a href="&url.articles;/remote-install/index.html">Remote
		Installation of the &os; Operating System without a
		Remote Console</a> (remote-install)<br>
	      Describes the remote installation of the &os; operating
	      system when the console of the remote system is
	      unavailable.</p>

	    <p><a href="&url.articles;/serial-uart/index.html">Serial
		and UART devices</a> (serial-uart)<br>
	      Detailed information about the use of serial ports on FreeBSD,
		including several multi-port serial cards.</p>

	    <p><a href="&url.articles;/solid-state/index.html">FreeBSD
	        and Solid State Devices</a> (solid-state)<br>
	      The use of solid state disk devices in FreeBSD.</p>

	    <p><a href="&url.articles;/storage-devices/index.html">Storage Devices</a>
	        (storage-devices)<br>
	      Detailed information about using storage devices with FreeBSD,
		including ESDI disks, and SCSI disks, tape drives, and CDROM
		drives.</p>

	    <p><a href="&url.articles;/version-guide/index.html">Choosing the
		FreeBSD Version That Is Right For You</a> (version-guide)<br>
	      How to decide which version of FreeBSD is right for your
		needs.  Topics include the releases, branches, the difference
		between -CURRENT and -STABLE, and the current scheduling goals
		of the project.</p>

	    <p><a href="&url.articles;/vinum/index.html">Bootstrapping
	       Vinum: A Foundation for Reliable Servers</a> (vinum)<br>
	       A gentle introduction to failure-resilient servers and
		step-by-step instructions for building one with Vinum.</p>

	    <p><a href="&url.articles;/vm-design/index.html">Design
	      elements of the FreeBSD VM system</a> (vm-design)<br>
	      An easy to follow description of the design of the FreeBSD
	        virtual memory system.</p>

	    <p><a href="&url.articles;/zip-drive/index.html">Zip-drives
	        and FreeBSD</a> (zip-drive)<br>
	      How to format, mount, and use an Iomega Zip (SCSI, IDE, or
		parallel) Drive on FreeBSD.</p>


    <h2>On other web sites</h2>

    <p>Various independent efforts have also produced a great deal of useful
      information about FreeBSD.</p>

    <h3>Articles</h3>

    <ul>
      <li>
	<p>Niels Jorgensen has authored an academic study on the
	  dynamics of the FreeBSD development process: <a
	  href="http://www.ruc.dk/~nielsj/research/publications/freebsd.pdf">
	  ``Putting it All in the Trunk, Incremental Software
	  Development in the FreeBSD Open Source Project''</a>
	  [Information Systems Journal (2001) 11, 321-336].</p>
      </li>

      <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.tldp.org/HOWTO/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://www.nber.org/amd.html">Getting started with AMD on
	    FreeBSD</a></p>
      </li>
<!--
      <li>
	<p><a href="http://ezine.daemonnews.org/200010/blueprints.html">Dynamic
	    Kernel Linker (KLD) Facility Programming Tutorial</a>.</p>
      </li>

      <li>
	<p><a href="http://ezine.daemonnews.org/200007/newbus-intro.html">How to
	    Write Kernel Drivers with Newbus</a>.</p>
      </li>
-->
      <li>
	<p><em>Writing an ISA device driver</em>.  This document has been
	imported into <a
	href="&url.books;/arch-handbook/index.html">The FreeBSD
	Architecture Handbook</a>.</p>
      </li>

      <li>
	<p><em>FreeBSD Assembly Language Programming Tutorial</em>.  This
	document has been imported into <a
	href="&url.books;/developers-handbook/index.html">The FreeBSD
	Developer's Handbook</a>.</p>
      </li>

      <li>
	<p><a href="http://software.intel.com/sites/oss/pdfs/profiling_debugging_freebsd_kernel_321772.pdf">Profiling
	    and Debugging the FreeBSD Kernel</a></p>
      </li>

      <li>
	<p><a href="http://software.intel.com/sites/oss/pdfs/debugging_buffer_overruns_322486.pdf">Debugging
	    Buffer Overruns in the FreeBSD Kernel</a></p>
      </li>

      <li>
	<p><a href="http://www.cfcl.com/rdm/split_DNS.html">Setting up
	    Split DNS on FreeBSD 4.1</a></p>
      </li>

      <li>
        <p><a href="http://people.FreeBSD.org/~fsmp/SMP/SMP.html">The
          SMP support page</a> contains information on the SMP support
          in FreeBSD 4.X and earlier.</p>
      </li>

      <li>
        <p>Appendix A from the college textbook
          <i>Operating Systems Concepts</i> by Silberschatz, Galvin and
          Gagne has been made available online in
          <a href="http://www.wiley.com/college/silberschatz6e/0471417432/pdf/bsd.pdf">PDF format</a>.
          The appendix is dedicated to FreeBSD and offers a good
          introduction to FreeBSD's internals.</p>
      </li>

     </ul>

&footer;

</body>
</html>
