Return to index_bare CVS log

Up to [NetBSD Developer Wiki] / wikisrc / guide

Annotation of wikisrc/guide/index_bare, revision 1.7

1.1       jdf         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: 
1.4       jdf        19: Originally, the guide has been a book, which was subsequently moved to the wiki
1.1       jdf        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: 
1.4       jdf        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
1.1       jdf        42: later due to better tools and slightly more knowhow on customisations.
                     43: 
1.4       jdf        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
1.3       jdf        47: reformulations.
                     48: 
                     49: You can still get the
1.4       jdf        50: [old version of the Guide](http://netbsd.org/docs/guide), which is not
1.3       jdf        51: maintained anymore.
1.1       jdf        52: 
                     53: ## Bibliography
                     54: 
                     55:  * [RFC1933] R. Gilligan and E. Nordmark. Copyright © 1996. *RFC 1933: Transition Mechanisms for IPv6 Hosts and Routers*.
                     56:  * [RFC2004] C. Perkins. Copyright © 1996. *RFC 2003: IP Encapsulation within IP*.
                     57:  * [RFC2529] B. Carpenter and C. Jung. Copyright © 1999. *RFC 2529: Transmission of IPv6 over IPv4 Domains without Explicit Tunnels*.
                     58:  * [RFC3056] B. Carpenter and K. Moore. Copyright © 2001. *RFC 3056: Connection of IPv6 Domains via IPv4 Clouds*.
                     59: 
                     60: ## Acknowledgements
                     61: 
1.4       jdf        62: The NetBSD Guide was originally written by Federico Lupi who managed the
                     63: sources, coordinated updates, and merged all contributions on his own. Since
                     64: then, it has been updated and maintained by the NetBSD www team. The Guide has
                     65: progressed thanks to the contributions of many people who have volunteered their
1.1       jdf        66: time and effort, supplied material and sent in suggestions and corrections.
                     67: 
                     68: ### Original acknowledgements
                     69: 
                     70: Federico's original credits are:
                     71: 
                     72:  * Paulo Aukar
                     73:  * Grant Beattie, converted to XML DocBook.
                     74:  * Manolo De Santis, Audio Chapter
                     75:  * Eric Delcamp, Boot Floppies
                     76:  * Hubert Feyrer, who contributed
1.4       jdf        77:    [[Introduction to TCP/IP Networking|guide/net-intro]] including Next
1.1       jdf        78:    generation Internet protocol - IPv6 and the section
                     79:    [[IPv6 Connectivity & Transition via 6to4|guide/net-practice#ipv6-6to4]]
                     80:    He also helped with the SGML to XML transition.
                     81:  * Jason R. Fink
                     82:  * Daniel de Kok, audio and linux chapters fixes.
                     83:  * Reinoud Koornstra, CVS chapter and rebuilding `/dev` in the Misc chapter.
1.4       jdf        84:  * Brian A. Seklecki [lavalamp@burghcom.com](mailto:lavalamp@burghcom.com), who
1.1       jdf        85:    contributed the CCD Chapter.
                     86:  * Guillain Seuillot
                     87:  * Martti Kuparinen, RAIDframe documentation.
                     88:  * David Magda
                     89: 
                     90: ### Current acknowledgements
                     91: 
1.4       jdf        92: This document is currently maintained by the NetBSD www team. Thanks to their
                     93: efforts, the document is kept up to date and available online at all times. In
1.1       jdf        94: addition, special thanks go to (in alphabetical order):
                     95: 
1.4       jdf        96:  * Hubert Feyrer, for getting the guide up to speed for NetBSD 2.0, and for
1.1       jdf        97:    making numerous improvements to all chapters.
                     98:  * Jason R. Fink, for maintaining this document and integrating changes.
                     99:  * Andreas Hallman, for his information in
                    100:    [[Tunneling 6to4 through an IPFilter firewall|guide/net-practice#chap-net-practice-ipv6-6to4-ipf]]
                    101:  * Joel Knight for the
1.4       jdf       102:    [[Introduction to the Common Address Redundancy Protocol (CARP)|guide/carp]].
1.1       jdf       103:    See below for for the accompanying license.
1.4       jdf       104:  * Daniel de Kok, for constant contributions of new chapters, maintenance of
1.1       jdf       105:    existing chapters and his translation work.
                    106:  * Hiroki Sato, for allowing us to build PDF and PS versions of this document.
                    107:  * Jan Schaumann, for maintenance work and `www/htdocs` management.
                    108:  * Lubomir Sedlacik, for some details on using CGD for swap in
                    109:    [[Suggestions and Warnings|guide/cgd#suggestions]]
                    110:  * Dag-Erling Smørgrav, for the article on
1.4       jdf       111:    [[Pluggable Authentication Modules (PAM)|guide/pam]]. See below for the
1.1       jdf       112:    accompanying license.
                    113:  * Florian Stöhr, for
                    114:    [[Example: encrypted CDs/DVDs|guide/cgd#cryptocds]]
                    115: 
                    116: 
                    117: ### Licenses
                    118: 
                    119: #### Federico Lupi's original license of this guide
                    120: 
1.4       jdf       121: Redistribution and use in source and binary forms, with or without modification,
1.1       jdf       122: are permitted provided that the following conditions are met:
                    123: 
1.4       jdf       124:  1. Redistributions of source code must retain the above copyright notice, this
1.1       jdf       125:     list of conditions and the following disclaimer.
1.4       jdf       126:  2. Redistributions in binary form must reproduce the above copyright notice,
                    127:     this list of conditions and the following disclaimer in the documentation
1.1       jdf       128:     and/or other materials provided with the distribution.
1.4       jdf       129:  3. All advertising materials mentioning features or use of this software must
                    130:     display the following acknowledgement: This product includes software developed
1.1       jdf       131:     by Federico Lupi for the NetBSD Project.
1.4       jdf       132:  4. The name of the author may not be used to endorse or promote products
1.1       jdf       133:     derived from this software without specific prior written permission.
                    134: 
1.4       jdf       135: THIS SOFTWARE IS PROVIDED BY THE AUTHOR "AS IS" AND ANY EXPRESS OR IMPLIED
                    136: WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
                    137: MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT
                    138: SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
                    139: EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
                    140: OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
                    141: INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
                    142: CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
                    143: IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY
1.1       jdf       144: OF SUCH DAMAGE.
                    145: 
                    146: #### The NetBSD Developers
                    147: 
                    148: Copyright © 1999, 2000, 2001, 2002 Federico Lupi
                    149: 
1.2       jdf       150: Copyright © 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013 The NetBSD Foundation
1.1       jdf       151: 
                    152: All brand and product names used in this guide are or may be trademarks or registered trademarks of their respective owners.
                    153: 
                    154: NetBSD® is a registered trademark of The NetBSD Foundation, Inc.