File:  [NetBSD Developer Wiki] / wikisrc / guide / index_bare
Revision 1.5: download - view: text, annotated - select for diffs
Sun Mar 10 02:18:51 2013 UTC (7 years, 6 months ago) by jdf
Branches: MAIN
CVS tags: HEAD
Remove license information from the index article, add it to the pam article (it
is already in the carp article).

    1: # The NetBSD Guide
    2: 
    3: ## Purpose of this guide
    4: 
    5: This guide describes the installation and the configuration of the NetBSD
    6: operating system as well as the setup and administration of some of its
    7: subsystems. It primarily addresses people coming from other Unix-like operating
    8: systems, and aims to be a useful guide in the face of the many small problems
    9: one encounters when using a new tool.
   10: 
   11: This guide is not a Unix tutorial: basic knowledge of some concepts and tools
   12: is assumed. You should know, for example, what a file and a directory are, and
   13: how to use an editor. There are plenty of books explaining basic Unix and
   14: operating system concepts, and you should consult one if you need more
   15: background information. It is better to choose a general book and avoid titles
   16: like "Learning Unix-XYZ, version 1.2.3.4 in 10 days", but this is a matter of
   17: personal taste.
   18: 
   19: Originally, the guide has been a book, which was subsequently moved to the wiki
   20: to make it easier to contribute.
   21: 
   22: If you have additions or comments to the guide, but don't want to create an
   23: account, feel free to post your submissions to the
   24: [www team](mailto:www@netbsd.org) or the
   25: [docs mailing list](netbsd-docs@netbsd.org). The text is maintained in
   26: Markdown, and you can use the button in the top right corner to show the source
   27: of an article.
   28: 
   29: ## Table of Contents
   30: %%TOC%%
   31: 
   32: ## Guide history
   33: 
   34: This guide was born as a collection of sparse notes that Federico Lupi, the
   35: original author of the NetBSD Guide, wrote mostly for himself. When he realized
   36: that they could be useful to other NetBSD users he started collecting them and
   37: created the first version of the guide using the groff formatter. In order to
   38: "easily" get a wider variety of output formats (e.g. HTML and
   39: PostScript/PDF), he made the "mistake" of moving to SGML/DocBook, which
   40: was the format of the sources. Maintainership was picked up by the NetBSD
   41: project and its developers later, and the format was changed to XML/DocBook
   42: later due to better tools and slightly more knowhow on customisations.
   43: 
   44: In 2012/2013, the guide was converted in a Google Code-In task by Mingzhe Wang
   45: (wmzhere) to Markdown. In early 2013, it was integrated to the NetBSD wiki,
   46: along with removing old chapters, restricting numbering schemes and some
   47: reformulations.
   48: 
   49: You can still get the
   50: [old version of the Guide](http://netbsd.org/docs/guide), which is not
   51: maintained anymore.
   52: 
   53: ## Bibliography
   54: 
   55:  * [AeleenFrisch] Aeleen Frisch. Copyright © 1991. O'Reilly & Associates. *Essential System Administration*.
   56:  * [CraigHunt] Craig Hunt. Copyright © 1993. O'Reilly & Associates. *TCP/IP Network Administration*.
   57:  * [RFC1034] P. V. Mockapetris. Copyright © 1987. *RFC 1034: Domain names - concepts and facilities*.
   58:  * [RFC1035] P. V. Mockapetris. Copyright © 1987. *RFC 1035: Domain names - implementation and specification*.
   59:  * [RFC1055] J. L. Romkey. Copyright © 1988. *RFC 1055: Nonstandard for transmission of IP datagrams over serial lines: SLIP*.
   60:  * [RFC1331] W. Simpson. Copyright © 1992. *RFC 1331: The Point-to-Point Protocol (PPP) for the Transmission of Multi-protocol Datagrams over Point-to-Point Links*.
   61:  * [RFC1332] G. McGregor. Copyright © 1992. *RFC 1332: The PPP Internet Protocol Control Protocol (IPCP)*.
   62:  * [RFC1933] R. Gilligan and E. Nordmark. Copyright © 1996. *RFC 1933: Transition Mechanisms for IPv6 Hosts and Routers*.
   63:  * [RFC2004] C. Perkins. Copyright © 1996. *RFC 2003: IP Encapsulation within IP*.
   64:  * [RFC2401] S. Kent and R. Atkinson. Copyright © 1998. *RFC 2401: Security Architecture for the Internet Protocol*.
   65:  * [RFC2411] R. Thayer, N. Doraswamy, and R. Glenn. Copyright © 1998. *RFC 2411: IP Security Document Roadmap*.
   66:  * [RFC2461] T. Narten, E. Nordmark, and W. Simpson. Copyright © 1998. *RFC 2461: Neighbor Discovery for IP Version 6 (IPv6)*.
   67:  * [RFC2529] B. Carpenter and C. Jung. Copyright © 1999. *RFC 2529: Transmission of IPv6 over IPv4 Domains without Explicit Tunnels*.
   68:  * [RFC3024] G. Montenegro. Copyright © 2001. *RFC 3024: Reverse Tunneling for Mobile IP*.
   69:  * [RFC3027] M. Holdrege and P. Srisuresh. Copyright © 2001. *RFC 3027: Protocol Complications with the IP Network Address Translator*.
   70:  * [RFC3056] B. Carpenter and K. Moore. Copyright © 2001. *RFC 3056: Connection of IPv6 Domains via IPv4 Clouds*.
   71: 
   72: ## Acknowledgements
   73: 
   74: The NetBSD Guide was originally written by Federico Lupi who managed the
   75: sources, coordinated updates, and merged all contributions on his own. Since
   76: then, it has been updated and maintained by the NetBSD www team. The Guide has
   77: progressed thanks to the contributions of many people who have volunteered their
   78: time and effort, supplied material and sent in suggestions and corrections.
   79: 
   80: ### Original acknowledgements
   81: 
   82: Federico's original credits are:
   83: 
   84:  * Paulo Aukar
   85:  * Grant Beattie, converted to XML DocBook.
   86:  * Manolo De Santis, Audio Chapter
   87:  * Eric Delcamp, Boot Floppies
   88:  * Hubert Feyrer, who contributed
   89:    [[Introduction to TCP/IP Networking|guide/net-intro]] including Next
   90:    generation Internet protocol - IPv6 and the section
   91:    [[IPv6 Connectivity & Transition via 6to4|guide/net-practice#ipv6-6to4]]
   92:    He also helped with the SGML to XML transition.
   93:  * Jason R. Fink
   94:  * Daniel de Kok, audio and linux chapters fixes.
   95:  * Reinoud Koornstra, CVS chapter and rebuilding `/dev` in the Misc chapter.
   96:  * Brian A. Seklecki [lavalamp@burghcom.com](mailto:lavalamp@burghcom.com), who
   97:    contributed the CCD Chapter.
   98:  * Guillain Seuillot
   99:  * Martti Kuparinen, RAIDframe documentation.
  100:  * David Magda
  101: 
  102: ### Current acknowledgements
  103: 
  104: This document is currently maintained by the NetBSD www team. Thanks to their
  105: efforts, the document is kept up to date and available online at all times. In
  106: addition, special thanks go to (in alphabetical order):
  107: 
  108:  * Hubert Feyrer, for getting the guide up to speed for NetBSD 2.0, and for
  109:    making numerous improvements to all chapters.
  110:  * Jason R. Fink, for maintaining this document and integrating changes.
  111:  * Andreas Hallman, for his information in
  112:    [[Tunneling 6to4 through an IPFilter firewall|guide/net-practice#chap-net-practice-ipv6-6to4-ipf]]
  113:  * Joel Knight for the
  114:    [[Introduction to the Common Address Redundancy Protocol (CARP)|guide/carp]].
  115:    See below for for the accompanying license.
  116:  * Daniel de Kok, for constant contributions of new chapters, maintenance of
  117:    existing chapters and his translation work.
  118:  * Hiroki Sato, for allowing us to build PDF and PS versions of this document.
  119:  * Jan Schaumann, for maintenance work and `www/htdocs` management.
  120:  * Lubomir Sedlacik, for some details on using CGD for swap in
  121:    [[Suggestions and Warnings|guide/cgd#suggestions]]
  122:  * Dag-Erling Smrgrav, for the article on
  123:    [[Pluggable Authentication Modules (PAM)|guide/pam]]. See below for the
  124:    accompanying license.
  125:  * Florian Sthr, for
  126:    [[Example: encrypted CDs/DVDs|guide/cgd#cryptocds]]
  127: 
  128: 
  129: ### Licenses
  130: 
  131: #### Federico Lupi's original license of this guide
  132: 
  133: Redistribution and use in source and binary forms, with or without modification,
  134: are permitted provided that the following conditions are met:
  135: 
  136:  1. Redistributions of source code must retain the above copyright notice, this
  137:     list of conditions and the following disclaimer.
  138:  2. Redistributions in binary form must reproduce the above copyright notice,
  139:     this list of conditions and the following disclaimer in the documentation
  140:     and/or other materials provided with the distribution.
  141:  3. All advertising materials mentioning features or use of this software must
  142:     display the following acknowledgement: This product includes software developed
  143:     by Federico Lupi for the NetBSD Project.
  144:  4. The name of the author may not be used to endorse or promote products
  145:     derived from this software without specific prior written permission.
  146: 
  147: THIS SOFTWARE IS PROVIDED BY THE AUTHOR "AS IS" AND ANY EXPRESS OR IMPLIED
  148: WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
  149: MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT
  150: SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
  151: EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
  152: OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  153: INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  154: CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
  155: IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY
  156: OF SUCH DAMAGE.
  157: 
  158: #### The NetBSD Developers
  159: 
  160: Copyright  1999, 2000, 2001, 2002 Federico Lupi
  161: 
  162: Copyright  2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013 The NetBSD Foundation
  163: 
  164: All brand and product names used in this guide are or may be trademarks or registered trademarks of their respective owners.
  165: 
  166: NetBSD is a registered trademark of The NetBSD Foundation, Inc.

CVSweb for NetBSD wikisrc <wikimaster@NetBSD.org> software: FreeBSD-CVSweb