Annotation of wikisrc/guide/index_bare, revision 1.4
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: * [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:
1.4 ! jdf 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
1.1 jdf 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
1.4 ! jdf 89: [[Introduction to TCP/IP Networking|guide/net-intro]] including Next
1.1 jdf 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.
1.4 ! jdf 96: * Brian A. Seklecki [lavalamp@burghcom.com](mailto:lavalamp@burghcom.com), who
1.1 jdf 97: contributed the CCD Chapter.
98: * Guillain Seuillot
99: * Martti Kuparinen, RAIDframe documentation.
100: * David Magda
101:
102: ### Current acknowledgements
103:
1.4 ! jdf 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
1.1 jdf 106: addition, special thanks go to (in alphabetical order):
107:
1.4 ! jdf 108: * Hubert Feyrer, for getting the guide up to speed for NetBSD 2.0, and for
1.1 jdf 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
1.4 ! jdf 114: [[Introduction to the Common Address Redundancy Protocol (CARP)|guide/carp]].
1.1 jdf 115: See below for for the accompanying license.
1.4 ! jdf 116: * Daniel de Kok, for constant contributions of new chapters, maintenance of
1.1 jdf 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 Smørgrav, for the article on
1.4 ! jdf 123: [[Pluggable Authentication Modules (PAM)|guide/pam]]. See below for the
1.1 jdf 124: accompanying license.
125: * Florian Stöhr, for
126: [[Example: encrypted CDs/DVDs|guide/cgd#cryptocds]]
127:
128:
129: ### Licenses
130:
131: #### Federico Lupi's original license of this guide
132:
1.4 ! jdf 133: Redistribution and use in source and binary forms, with or without modification,
1.1 jdf 134: are permitted provided that the following conditions are met:
135:
1.4 ! jdf 136: 1. Redistributions of source code must retain the above copyright notice, this
1.1 jdf 137: list of conditions and the following disclaimer.
1.4 ! jdf 138: 2. Redistributions in binary form must reproduce the above copyright notice,
! 139: this list of conditions and the following disclaimer in the documentation
1.1 jdf 140: and/or other materials provided with the distribution.
1.4 ! jdf 141: 3. All advertising materials mentioning features or use of this software must
! 142: display the following acknowledgement: This product includes software developed
1.1 jdf 143: by Federico Lupi for the NetBSD Project.
1.4 ! jdf 144: 4. The name of the author may not be used to endorse or promote products
1.1 jdf 145: derived from this software without specific prior written permission.
146:
1.4 ! jdf 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
1.1 jdf 156: OF SUCH DAMAGE.
157:
158: #### Networks Associates Technology's license on the PAM article
159:
160: Copyright (c) 2001-2003 Networks Associates Technology, Inc.
161: All rights reserved.
162: This software was developed for the FreeBSD Project by ThinkSec AS and
163: Network Associates Laboratories, the Security Research Division of
164: Network Associates, Inc. under DARPA/SPAWAR contract N66001-01-C-8035
165: ("CBOSS"), as part of the DARPA CHATS research program.
166: Redistribution and use in source and binary forms, with or without
167: modification, are permitted provided that the following conditions
168: are met:
169: 1. Redistributions of source code must retain the above copyright
170: notice, this list of conditions and the following disclaimer.
171: 2. Redistributions in binary form must reproduce the above copyright
172: notice, this list of conditions and the following disclaimer in the
173: documentation and/or other materials provided with the distribution.
174: 3. The name of the author may not be used to endorse or promote
175: products derived from this software without specific prior written
176: permission.
177: THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS "AS IS" AND
178: ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
179: IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
180: ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
181: FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
182: DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
183: OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
184: HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
185: LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
186: OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
187: SUCH DAMAGE.
188:
189: #### Joel Knight's license on the CARP article
190:
191: Copyright (c) 2005 Joel Knight <enabled@myrealbox.com\>
192: Permission to use, copy, modify, and distribute this documentation for
193: any purpose with or without fee is hereby granted, provided that the
194: above copyright notice and this permission notice appear in all copies.
195: THE DOCUMENTATION IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL
196: WARRANTIES WITH REGARD TO THIS DOCUMENTATION INCLUDING ALL IMPLIED
197: WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE
198: AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
199: DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
200: PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
201: TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
202: PERFORMANCE OF THIS DOCUMENTATION
203:
204: #### The NetBSD Developers
205:
206: Copyright © 1999, 2000, 2001, 2002 Federico Lupi
207:
1.2 jdf 208: Copyright © 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013 The NetBSD Foundation
1.1 jdf 209:
210: All brand and product names used in this guide are or may be trademarks or registered trademarks of their respective owners.
211:
212: NetBSD® is a registered trademark of The NetBSD Foundation, Inc.
CVSweb for NetBSD wikisrc <wikimaster@NetBSD.org> software: FreeBSD-CVSweb
![[BACK]](/icons/back.gif){kind=icon}
Return to index_bare CVS log ![[TXT]](/icons/text.gif){kind=icon}
![[DIR]](/icons/dir.gif){kind=icon}
Up to [NetBSD Developer Wiki] / wikisrc / guide