Annotation of wikisrc/guide/index.mdwn, revision 1.34

1.34    ! jdf         1: 
1.1       jdf         2: # The NetBSD Guide
                      3: 
                      4: ## Purpose of this guide
                      5: 
                      6: This guide describes the installation and the configuration of the NetBSD
                      7: operating system as well as the setup and administration of some of its
                      8: subsystems. It primarily addresses people coming from other Unix-like operating
                      9: systems, and aims to be a useful guide in the face of the many small problems
                     10: one encounters when using a new tool.
                     11: 
                     12: This guide is not a Unix tutorial: basic knowledge of some concepts and tools
                     13: is assumed. You should know, for example, what a file and a directory are, and
                     14: how to use an editor. There are plenty of books explaining basic Unix and
                     15: operating system concepts, and you should consult one if you need more
                     16: background information. It is better to choose a general book and avoid titles
                     17: like "Learning Unix-XYZ, version 1.2.3.4 in 10 days", but this is a matter of
                     18: personal taste.
                     19: 
                     20: Originally, the guide has been a book, which was subsequently moved to the wiki
                     21: to make it easier to contribute.
                     22: 
                     23: If you have additions or comments to the guide, but don't want to create an
                     24: account, feel free to post your submissions to the
                     25: [www team](mailto:www@netbsd.org) or the
                     26: [docs mailing list](netbsd-docs@netbsd.org). The text is maintained in
                     27: Markdown, and you can use the button in the top right corner to show the source
                     28: of an article.
                     29: 
                     30: ## Table of Contents
                     31: 
                     32: ***I. About NetBSD***
                     33: 
1.3       jdf        34:  * [[1. What is NetBSD?|guide/intro]]
1.34    ! jdf        35:    * [[1.1. The story of NetBSD|guide/intro#index1h2]]
        !            36:    * [[1.2. NetBSD features|guide/intro#index2h2]]
        !            37:    * [[1.3. Supported platforms|guide/intro#index3h2]]
        !            38:    * [[1.4. NetBSD's target users|guide/intro#index4h2]]
        !            39:    * [[1.5. Applications for NetBSD|guide/intro#index5h2]]
        !            40:    * [[1.6. How to get NetBSD|guide/intro#index6h2]]
1.1       jdf        41: 
                     42: ***II. System installation and related issues***
                     43: 
1.24      jdf        44:  * [[2. Installing NetBSD: Preliminary considerations and preparations|guide/inst]]
1.34    ! jdf        45:    * [[2.1. Preliminary considerations|guide/inst#index1h2]]
        !            46:    * [[2.2. Install preparations|guide/inst#index2h2]]
        !            47:    * [[2.3. Checklist|guide/inst#index3h2]]
1.28      jdf        48:  * [[3. Example installation|guide/exinst]]
1.34    ! jdf        49:    * [[3.1. Introduction|guide/exinst#index1h2]]
        !            50:    * [[3.2. The installation process|guide/exinst#index2h2]]
        !            51:    * [[3.3. Keyboard layout|guide/exinst#index3h2]]
        !            52:    * [[3.4. Starting the installation|guide/exinst#index4h2]]
        !            53:    * [[3.5. MBR partitions|guide/exinst#index5h2]]
        !            54:    * [[3.6. Disklabel partitions|guide/exinst#index6h2]]
        !            55:    * [[3.7. Setting the disk name|guide/exinst#index7h2]]
        !            56:    * [[3.8. Last chance!|guide/exinst#index8h2]]
        !            57:    * [[3.9. The disk preparation process|guide/exinst#index9h2]]
        !            58:    * [[3.10. Choosing the installation media|guide/exinst#index10h2]]
        !            59:    * [[3.11. Extracting sets|guide/exinst#index11h2]]
        !            60:    * [[3.12. System configuration|guide/exinst#index12h2]]
        !            61:    * [[3.13. Finishing the installation|guide/exinst#index13h2]]
1.2       jdf        62:  * [[4. Upgrading NetBSD|guide/upgrading]]
1.34    ! jdf        63:    * [[4.1. Using sysinst|guide/upgrading#index1h2]]
        !            64:    * [[4.2. Using sysupgrade|guide/upgrading#index2h2]]
1.29      jdf        65: 
                     66: ***III. System configuration, administration and tuning***
                     67: 
1.2       jdf        68:  * [[5. The first steps on NetBSD|guide/boot]]
1.34    ! jdf        69:    * [[5.1. Troubleshooting|guide/boot#index1h2]]
        !            70:    * [[5.2. The man command|guide/boot#index2h2]]
        !            71:    * [[5.3. Editing configuration files|guide/boot#index3h2]]
        !            72:    * [[5.4. Login|guide/boot#index4h2]]
        !            73:    * [[5.5. Changing the root password|guide/boot#index5h2]]
        !            74:    * [[5.6. Adding users|guide/boot#index6h2]]
        !            75:    * [[5.7. Shadow passwords|guide/boot#index7h2]]
        !            76:    * [[5.8. Changing the keyboard layout|guide/boot#index8h2]]
        !            77:    * [[5.9. System time|guide/boot#index9h2]]
        !            78:    * [[5.10. Secure Shell ssh(1)|guide/boot#index10h2]]
        !            79:    * [[5.11. Basic configuration in /etc/rc.conf|guide/boot#index11h2]]
        !            80:    * [[5.12. Basic network settings|guide/boot#index12h2]]
        !            81:    * [[5.13. Mounting a CD-ROM|guide/boot#index13h2]]
        !            82:    * [[5.14. Mounting a floppy|guide/boot#index14h2]]
        !            83:    * [[5.15. Installing additional software|guide/boot#index15h2]]
        !            84:    * [[5.16. Security alerts|guide/boot#index16h2]]
        !            85:    * [[5.17. Stopping and rebooting the system|guide/boot#index17h2]]
1.15      jdf        86:  * [[6. Editing|guide/edit]]
1.34    ! jdf        87:    * [[6.1. Introducing vi|guide/edit#index1h2]]
        !            88:    * [[6.2. Configuring vi|guide/edit#index2h2]]
        !            89:    * [[6.3. Using tags with vi|guide/edit#index3h2]]
1.2       jdf        90:  * [[7. The rc.d System|guide/rc]]
1.34    ! jdf        91:    * [[7.1. Basics|guide/rc#index1h2]]
        !            92:    * [[7.2. The rc.d scripts|guide/rc#index2h2]]
        !            93:    * [[7.3. Order/dependencies of start determined by rcorder|guide/rc#index3h2]]
        !            94:    * [[7.4. rc.d scripts of additional services|guide/rc#index4h2]]
        !            95:    * [[7.5. Additional Reading|guide/rc#index5h2]]
1.14      jdf        96:  * [[8. Console drivers|guide/cons]]
1.34    ! jdf        97:    * [[8.1. wscons|guide/cons#index1h2]]
1.2       jdf        98:  * [[9. X|guide/x]]
1.34    ! jdf        99:    * [[9.1. What is X?|guide/x#index1h2]]
        !           100:    * [[9.2. Configuration|guide/x#index2h2]]
        !           101:    * [[9.3. The mouse|guide/x#index3h2]]
        !           102:    * [[9.4. The keyboard|guide/x#index4h2]]
        !           103:    * [[9.5. The monitor|guide/x#index5h2]]
        !           104:    * [[9.6. The video card|guide/x#index6h2]]
        !           105:    * [[9.7. Starting X|guide/x#index7h2]]
        !           106:    * [[9.8. Customizing X|guide/x#index8h2]]
        !           107:    * [[9.9. Other window managers or desktop environments|guide/x#index9h2]]
        !           108:    * [[9.10. Graphical login with xdm|guide/x#index10h2]]
1.17      jdf       109:  * [[10. Linux emulation|guide/linux]]
1.34    ! jdf       110:    * [[10.1. Emulation setup|guide/linux#index1h2]]
        !           111:    * [[10.2. Directory structure|guide/linux#index2h2]]
        !           112:    * [[10.3. Emulating /proc|guide/linux#index3h2]]
        !           113:    * [[10.4. Using Linux browser plugins|guide/linux#index4h2]]
        !           114:    * [[10.5. Further reading|guide/linux#index5h2]]
1.2       jdf       115:  * [[11. Audio|guide/audio]]
1.34    ! jdf       116:    * [[11.1. Basic hardware elements|guide/audio#index1h2]]
        !           117:    * [[11.2. Supported audio cards|guide/audio#index2h2]]
        !           118:    * [[11.3. BIOS settings|guide/audio#index3h2]]
        !           119:    * [[11.4. Configuring the audio device|guide/audio#index4h2]]
        !           120:    * [[11.5. Multiple audio devices|guide/audio#index5h2]]
        !           121:    * [[11.6. Configuring the kernel audio devices|guide/audio#index6h2]]
        !           122:    * [[11.7. Advanced commands|guide/audio#index7h2]]
1.20      jdf       123:  * [[12. Printing|guide/print]]
1.34    ! jdf       124:    * [[12.1. Enabling the printer daemon|guide/print#index1h2]]
        !           125:    * [[12.2. Configuring `/etc/printcap`|guide/print#index2h2]]
        !           126:    * [[12.3. Configuring Ghostscript|guide/print#index3h2]]
        !           127:    * [[12.4. Printer management commands|guide/print#index4h2]]
        !           128:    * [[12.5. Remote printing|guide/print#index5h2]]
1.21      jdf       129:  * [[13. Using removable media|guide/rmmedia]]
1.34    ! jdf       130:    * [[13.1. Reading data CDs with NetBSD|guide/rmmedia#index1h2]]
        !           131:    * [[13.2. Reading multi-session CDs with NetBSD|guide/rmmedia#index2h2]]
        !           132:    * [[13.3. Allowing normal users to access CDs|guide/rmmedia#index3h2]]
        !           133:    * [[13.4. Mounting an ISO image|guide/rmmedia#index4h2]]
        !           134:    * [[13.5. Using video CDs with NetBSD|guide/rmmedia#index5h2]]
        !           135:    * [[13.6. Using audio CDs with NetBSD|guide/rmmedia#index6h2]]
        !           136:    * [[13.7. Creating an MP3 (MPEG layer 3) file from an audio CD|guide/rmmedia#index7h2]]
        !           137:    * [[13.8. Using a CD-R writer with data CDs|guide/rmmedia#index8h2]]
        !           138:    * [[13.9. Using a CD-R writer to create audio CDs|guide/rmmedia#index9h2]]
        !           139:    * [[13.10. Creating an audio CD from MP3s|guide/rmmedia#index10h2]]
        !           140:    * [[13.11. Copying an audio CD|guide/rmmedia#index11h2]]
        !           141:    * [[13.12. Copying a data CD with two drives|guide/rmmedia#index12h2]]
        !           142:    * [[13.13. Using CD-RW rewritables|guide/rmmedia#index13h2]]
        !           143:    * [[13.14. DVD support|guide/rmmedia#index14h2]]
        !           144:    * [[13.15. Creating ISO images from a CD|guide/rmmedia#index15h2]]
        !           145:    * [[13.16. Getting volume information from CDs and ISO images|guide/rmmedia#index16h2]]
        !           146:    * [[13.17. Initializing and using floppy disks|guide/rmmedia#index17h2]]
1.13      jdf       147:  * [[14. The cryptographic device driver (CGD)|guide/cgd]]
1.34    ! jdf       148:    * [[14.1. Overview|guide/cgd#index1h2]]
        !           149:    * [[14.2. Components of the Crypto-Graphic Disk system|guide/cgd#index2h2]]
        !           150:    * [[14.3. Example: encrypting your disk|guide/cgd#index3h2]]
        !           151:    * [[14.4. Example: encrypted CDs/DVDs|guide/cgd#index4h2]]
        !           152:    * [[14.5. Suggestions and Warnings|guide/cgd#index5h2]]
        !           153:    * [[14.6. Further Reading|guide/cgd#index6h2]]
1.12      jdf       154:  * [[15. Concatenated Disk Device (CCD) configuration|guide/ccd]]
1.34    ! jdf       155:    * [[15.1. Install physical media|guide/ccd#index1h2]]
        !           156:    * [[15.2. Configure Kernel Support|guide/ccd#index2h2]]
        !           157:    * [[15.3. Disklabel each volume member of the CCD|guide/ccd#index3h2]]
        !           158:    * [[15.4. Configure the CCD|guide/ccd#index4h2]]
        !           159:    * [[15.5. Initialize the CCD device|guide/ccd#index5h2]]
        !           160:    * [[15.6. Create a 4.2BSD/UFS filesystem on the new CCD device|guide/ccd#index6h2]]
        !           161:    * [[15.7. Mount the filesystem|guide/ccd#index7h2]]
1.31      jdf       162:  * [[16. NetBSD RAIDframe|guide/raidframe]]
1.34    ! jdf       163:    * [[16.1. RAIDframe Introduction|guide/raidframe#index1h2]]
        !           164:    * [[16.2. Setup RAIDframe Support|guide/raidframe#index2h2]]
        !           165:    * [[16.3. Example: RAID-1 Root Disk|guide/raidframe#index3h2]]
1.16      jdf       166:  * [[17. NetBSD Logical Volume Manager (LVM) configuration|guide/lvm]]
1.34    ! jdf       167:    * [[17.1. Anatomy of NetBSD Logical Volume Manager|guide/lvm#index1h2]]
        !           168:    * [[17.2. Install physical media|guide/lvm#index2h2]]
        !           169:    * [[17.3. Configure Kernel Support|guide/lvm#index3h2]]
        !           170:    * [[17.4. Configure LVM on a NetBSD system|guide/lvm#index4h2]]
        !           171:    * [[17.5. Disklabel each physical volume member of the LVM|guide/lvm#index5h2]]
        !           172:    * [[17.6. Create Physical Volumes|guide/lvm#index6h2]]
        !           173:    * [[17.7. Create Volume Group|guide/lvm#index7h2]]
        !           174:    * [[17.8. Create Logical Volume|guide/lvm#index8h2]]
        !           175:    * [[17.9. Example: LVM with Volume groups located on raid1|guide/lvm#index9h2]]
1.18      jdf       176:  * [[18. Pluggable Authentication Modules (PAM)|guide/pam]]
1.34    ! jdf       177:    * [[18.1. About|guide/pam#index1h2]]
        !           178:    * [[18.2. Introduction|guide/pam#index2h2]]
        !           179:    * [[18.3. Terms and conventions|guide/pam#index3h2]]
        !           180:    * [[18.4. PAM Essentials|guide/pam#index4h2]]
        !           181:    * [[18.5. PAM Configuration|guide/pam#index5h2]]
        !           182:    * [[18.6. PAM modules|guide/pam#index6h2]]
        !           183:    * [[18.7. PAM Application Programming|guide/pam#index7h2]]
        !           184:    * [[18.8. PAM Module Programming|guide/pam#index8h2]]
        !           185:    * [[18.9. Sample PAM Application|guide/pam#index9h2]]
        !           186:    * [[18.10. Sample PAM Module|guide/pam#index10h2]]
        !           187:    * [[18.11. Sample PAM Conversation Function|guide/pam#index11h2]]
        !           188:    * [[18.12. Further Reading|guide/pam#index12h2]]
1.4       jdf       189:  * [[19. Tuning NetBSD|guide/tuning]]
1.34    ! jdf       190:    * [[19.1. Introduction|guide/tuning#index1h2]]
        !           191:    * [[19.2. Tuning Considerations|guide/tuning#index2h2]]
        !           192:    * [[19.3. Visual Monitoring Tools|guide/tuning#index3h2]]
        !           193:    * [[19.4. Monitoring Tools|guide/tuning#index4h2]]
        !           194:    * [[19.5. Network Tools|guide/tuning#index5h2]]
        !           195:    * [[19.6. Accounting|guide/tuning#index6h2]]
        !           196:    * [[19.7. Kernel Profiling|guide/tuning#index7h2]]
        !           197:    * [[19.8. System Tuning|guide/tuning#index8h2]]
        !           198:    * [[19.9. Kernel Tuning|guide/tuning#index9h2]]
1.2       jdf       199:  * [[20. NetBSD Veriexec subsystem|guide/veriexec]]
1.34    ! jdf       200:    * [[20.1. How it works|guide/veriexec#index1h2]]
        !           201:    * [[20.2. Signatures file|guide/veriexec#index2h2]]
        !           202:    * [[20.3. Strict levels|guide/veriexec#index3h2]]
        !           203:    * [[20.4. Veriexec and layered file systems|guide/veriexec#index4h2]]
        !           204:    * [[20.5. Kernel configuration|guide/veriexec#index5h2]]
1.10      jdf       205:  * [[21. Bluetooth on NetBSD|guide/bluetooth]]
1.34    ! jdf       206:    * [[21.1. Introduction|guide/bluetooth#index1h2]]
        !           207:    * [[21.2. Supported Hardware|guide/bluetooth#index2h2]]
        !           208:    * [[21.3. System Configuration|guide/bluetooth#index3h2]]
        !           209:    * [[21.4. Human Interface Devices|guide/bluetooth#index4h2]]
        !           210:    * [[21.5. Personal Area Networking|guide/bluetooth#index5h2]]
        !           211:    * [[21.6. Serial Connections|guide/bluetooth#index6h2]]
        !           212:    * [[21.7. Audio|guide/bluetooth#index7h2]]
        !           213:    * [[21.8. Object Exchange|guide/bluetooth#index8h2]]
        !           214:    * [[21.9. Troubleshooting|guide/bluetooth#index9h2]]
1.7       jdf       215:  * [[22. Miscellaneous operations|guide/misc]]
1.34    ! jdf       216:    * [[22.1. Installing the boot manager|guide/misc#index1h2]]
        !           217:    * [[22.2. Deleting the disklabel|guide/misc#index2h2]]
        !           218:    * [[22.3. Speaker|guide/misc#index3h2]]
        !           219:    * [[22.4. Forgot root password?|guide/misc#index4h2]]
        !           220:    * [[22.5. Password file is busy?|guide/misc#index5h2]]
        !           221:    * [[22.6. Adding a new hard disk|guide/misc#index6h2]]
        !           222:    * [[22.7. How to rebuild the devices in /dev|guide/misc#index7h2]]
1.1       jdf       223: 
                    224: ***IV. Networking and related issues***
                    225: 
1.32      jdf       226:  * [[23. Introduction to TCP/IP Networking|guide/net-intro]]
1.34    ! jdf       227:    * [[23.1. Audience|guide/net-intro#index1h2]]
        !           228:    * [[23.2. Supported Networking Protocols|guide/net-intro#index2h2]]
        !           229:    * [[23.3. Supported Media|guide/net-intro#index3h2]]
        !           230:    * [[23.4. TCP/IP Address Format|guide/net-intro#index4h2]]
        !           231:    * [[23.5. Subnetting and Routing|guide/net-intro#index5h2]]
        !           232:    * [[23.6. Name Service Concepts|guide/net-intro#index6h2]]
        !           233:    * [[23.7. Next generation Internet protocol - IPv6|guide/net-intro#index7h2]]
1.30      jdf       234:  * [[24. Setting up TCP/IP on NetBSD in practice|guide/net-practice]]
1.34    ! jdf       235:    * [[24.1. A walk through the kernel configuration|guide/net-practice#index1h2]]
        !           236:    * [[24.2. Overview of the network configuration files|guide/net-practice#index2h2]]
        !           237:    * [[24.3. Connecting to the Internet with a modem|guide/net-practice#index3h2]]
        !           238:    * [[24.4. Creating a small home network|guide/net-practice#index4h2]]
        !           239:    * [[24.5. Setting up an Internet gateway with IPNAT|guide/net-practice#index5h2]]
        !           240:    * [[24.6. Setting up a network bridge device|guide/net-practice#index6h2]]
        !           241:    * [[24.7. A common LAN setup|guide/net-practice#index7h2]]
        !           242:    * [[24.8. Connecting two PCs through a serial line|guide/net-practice#index8h2]]
        !           243:    * [[24.9. IPv6 Connectivity & Transition via 6to4|guide/net-practice#index9h2]]
1.9       jdf       244:  * [[25. The Internet Super Server inetd
                    245:  Allowing and denying hosts - /etc/hosts.allow, /etc/hosts.deny|guide/inetd]]
1.34    ! jdf       246:    * [[25.1. Overview|guide/inetd#index1h2]]
        !           247:    * [[25.2. What is inetd?|guide/inetd#index2h2]]
        !           248:    * [[25.3. Configuring inetd - /etc/inetd.conf|guide/inetd#index3h2]]
        !           249:    * [[25.4. Services - /etc/services|guide/inetd#index4h2]]
        !           250:    * [[25.5. Protocols - /etc/protocols|guide/inetd#index5h2]]
        !           251:    * [[25.6. Remote Procedure Calls (RPC) - /etc/rpc|guide/inetd#index6h2]]
        !           252:    * [[25.7. Adding a Service|guide/inetd#index7h2]]
        !           253:    * [[25.8. When to use or not to use inetd|guide/inetd#index8h2]]
        !           254:    * [[25.9. Other Resources|guide/inetd#index9h2]]
1.19      jdf       255:  * [[26. The Domain Name System|guide/dns]]
1.34    ! jdf       256:    * [[26.1. DNS Background and Concepts|guide/dns#index1h2]]
        !           257:    * [[26.2. The DNS Files|guide/dns#index2h2]]
        !           258:    * [[26.3. Using DNS|guide/dns#index3h2]]
        !           259:    * [[26.4. Setting up a caching only name server|guide/dns#index4h2]]
1.22      jdf       260:  * [[27. Mail and news|guide/mail]]
1.34    ! jdf       261:    * [[27.1. postfix|guide/mail#index1h2]]
        !           262:    * [[27.2. fetchmail|guide/mail#index2h2]]
        !           263:    * [[27.3. Reading and writing mail with mutt|guide/mail#index3h2]]
        !           264:    * [[27.4. Strategy for receiving mail|guide/mail#index4h2]]
        !           265:    * [[27.5. Strategy for sending mail|guide/mail#index5h2]]
        !           266:    * [[27.6. Advanced mail tools|guide/mail#index6h2]]
        !           267:    * [[27.7. News with tin|guide/mail#index7h2]]
1.6       jdf       268:  * [[28. Introduction to the Common Address Redundancy Protocol (CARP)|guide/carp]]
1.34    ! jdf       269:    * [[28.1. CARP Operation|guide/carp#index1h2]]
        !           270:    * [[28.2. Configuring CARP|guide/carp#index2h2]]
        !           271:    * [[28.3. Enabling CARP Support|guide/carp#index3h2]]
        !           272:    * [[28.4. CARP Example|guide/carp#index4h2]]
        !           273:    * [[28.5. Advanced CARP configuration|guide/carp#index5h2]]
        !           274:    * [[28.6. Forcing Failover of the Master|guide/carp#index6h2]]
        !           275:    * [[28.7. License|guide/carp#index7h2]]
1.23      jdf       276:  * [[29. Network services|guide/net-services]]
1.34    ! jdf       277:    * [[29.1. The Network File System (NFS)|guide/net-services#index1h2]]
        !           278:    * [[29.2. The Network Time Protocol (NTP)|guide/net-services#index2h2]]
1.1       jdf       279: 
                    280: ***V. Building the system***
                    281: 
1.8       jdf       282:  * [[30. Obtaining the sources|guide/fetch]]
1.34    ! jdf       283:    * [[30.1. Preparing directories|guide/fetch#index1h2]]
        !           284:    * [[30.2. Terminology|guide/fetch#index2h2]]
        !           285:    * [[30.3. Downloading tarballs|guide/fetch#index3h2]]
        !           286:    * [[30.4. Fetching by CVS|guide/fetch#index4h2]]
        !           287:    * [[30.5. Sources on CD (ISO)|guide/fetch#index5h2]]
1.11      jdf       288:  * [[31. Crosscompiling NetBSD with build.sh|guide/build]]
1.34    ! jdf       289:    * [[31.1. Building the crosscompiler|guide/build#index1h2]]
        !           290:    * [[31.2. Configuring the kernel manually|guide/build#index2h2]]
        !           291:    * [[31.3. Crosscompiling the kernel manually|guide/build#index3h2]]
        !           292:    * [[31.4. Crosscompiling the kernel with build.sh|guide/build#index4h2]]
        !           293:    * [[31.5. Crosscompiling the userland|guide/build#index5h2]]
        !           294:    * [[31.6. Crosscompiling the X Window System|guide/build#index6h2]]
        !           295:    * [[31.7. Changing build behaviour|guide/build#index7h2]]
1.2       jdf       296:  * [[32. Compiling the kernel|guide/kernel]]
1.34    ! jdf       297:    * [[32.1. Requirements and procedure|guide/kernel#index1h2]]
        !           298:    * [[32.2. Installing the kernel sources|guide/kernel#index2h2]]
        !           299:    * [[32.3. Creating the kernel configuration file|guide/kernel#index3h2]]
        !           300:    * [[32.4. Building the kernel manually|guide/kernel#index4h2]]
        !           301:    * [[32.5. Building the kernel using build.sh|guide/kernel#index5h2]]
        !           302:    * [[32.6. Installing the new kernel|guide/kernel#index6h2]]
        !           303:    * [[32.7. If something went wrong|guide/kernel#index7h2]]
1.2       jdf       304:  * [[33. Updating an existing system from sources|guide/updating]]
1.34    ! jdf       305:    * [[33.1. Manual build and update procedure|guide/updating#index1h2]]
        !           306:    * [[33.2. Using sysinst|guide/updating#index2h2]]
        !           307:    * [[33.3. Using sysbuild and sysupgrade|guide/updating#index3h2]]
        !           308:    * [[33.4. More details about the updating of configuration and startup files|guide/updating#index4h2]]
1.27      jdf       309:  * [[34. Building NetBSD installation media|guide/inst-media]]
1.34    ! jdf       310:    * [[34.1. Creating custom install or boot floppies for your architecture e.g. i386|guide/inst-media#index1h2]]
        !           311:    * [[34.2. Creating a custom install or boot CD with build.sh|guide/inst-media#index2h2]]
1.1       jdf       312: 
                    313: ## Guide history
                    314: 
                    315: This guide was born as a collection of sparse notes that Federico Lupi, the
                    316: original author of the NetBSD Guide, wrote mostly for himself. When he realized
                    317: that they could be useful to other NetBSD users he started collecting them and
                    318: created the first version of the guide using the groff formatter. In order to
                    319: "easily" get a wider variety of output formats (e.g. HTML and
                    320: PostScript/PDF), he made the "mistake" of moving to SGML/DocBook, which
1.6       jdf       321: was the format of the sources. Maintainership was picked up by the NetBSD
1.1       jdf       322: project and its developers later, and the format was changed to XML/DocBook
                    323: later due to better tools and slightly more knowhow on customisations.
                    324: 
1.7       jdf       325: In 2012/2013, the guide was converted in a Google Code-In task by Mingzhe Wang
                    326: (wmzhere) to Markdown. In early 2013, it was integrated to the NetBSD wiki,
                    327: along with removing old chapters, restricting numbering schemes and some
                    328: reformulations.
                    329: 
                    330: You can still get the
                    331: [old version of the Guide](http://netbsd.org/docs/guide), which is not
                    332: maintained anymore.
1.1       jdf       333: 
                    334: ## Acknowledgements
                    335: 
                    336: The NetBSD Guide was originally written by Federico Lupi who managed the
                    337: sources, coordinated updates, and merged all contributions on his own. Since
                    338: then, it has been updated and maintained by the NetBSD www team. The Guide has
                    339: progressed thanks to the contributions of many people who have volunteered their
                    340: time and effort, supplied material and sent in suggestions and corrections.
                    341: 
                    342: ### Original acknowledgements
                    343: 
                    344: Federico's original credits are:
                    345: 
                    346: * Paulo Aukar
                    347: * Grant Beattie, converted to XML DocBook.
                    348: * Manolo De Santis, Audio Chapter
                    349: * Eric Delcamp, Boot Floppies
                    350: * Hubert Feyrer, who contributed
                    351: [[Introduction to TCP/IP Networking|guide/net-intro]] including Next
                    352: generation Internet protocol - IPv6 and the section
                    353: [[IPv6 Connectivity & Transition via 6to4|guide/net-practice#ipv6-6to4]]
                    354: He also helped with the SGML to XML transition.
                    355: * Jason R. Fink
                    356: * Daniel de Kok, audio and linux chapters fixes.
                    357: * Reinoud Koornstra, CVS chapter and rebuilding `/dev` in the Misc chapter.
                    358: * Brian A. Seklecki [lavalamp@burghcom.com](mailto:lavalamp@burghcom.com), who
                    359: contributed the CCD Chapter.
                    360: * Guillain Seuillot
                    361: * Martti Kuparinen, RAIDframe documentation.
                    362: * David Magda
                    363: 
                    364: ### Current acknowledgements
                    365: 
                    366: This document is currently maintained by the NetBSD www team. Thanks to their
                    367: efforts, the document is kept up to date and available online at all times. In
                    368: addition, special thanks go to (in alphabetical order):
                    369: 
                    370: * Hubert Feyrer, for getting the guide up to speed for NetBSD 2.0, and for
                    371: making numerous improvements to all chapters.
                    372: * Jason R. Fink, for maintaining this document and integrating changes.
                    373: * Andreas Hallman, for his information in
                    374: [[Tunneling 6to4 through an IPFilter firewall|guide/net-practice#chap-net-practice-ipv6-6to4-ipf]]
                    375: * Joel Knight for the
                    376: [[Introduction to the Common Address Redundancy Protocol (CARP)|guide/carp]].
                    377: See below for for the accompanying license.
                    378: * Daniel de Kok, for constant contributions of new chapters, maintenance of
                    379: existing chapters and his translation work.
                    380: * Hiroki Sato, for allowing us to build PDF and PS versions of this document.
                    381: * Jan Schaumann, for maintenance work and `www/htdocs` management.
                    382: * Lubomir Sedlacik, for some details on using CGD for swap in
                    383: [[Suggestions and Warnings|guide/cgd#suggestions]]
                    384: * Dag-Erling Smørgrav, for the article on
                    385: [[Pluggable Authentication Modules (PAM)|guide/pam]]. See below for the
                    386: accompanying license.
                    387: * Florian Stöhr, for
                    388: [[Example: encrypted CDs/DVDs|guide/cgd#cryptocds]]
                    389: 
                    390: 
                    391: ### Licenses
                    392: 
                    393: #### Federico Lupi's original license of this guide
                    394: 
                    395: Redistribution and use in source and binary forms, with or without modification,
                    396: are permitted provided that the following conditions are met:
                    397: 
                    398: 1. Redistributions of source code must retain the above copyright notice, this
                    399: list of conditions and the following disclaimer.
                    400: 2. Redistributions in binary form must reproduce the above copyright notice,
                    401: this list of conditions and the following disclaimer in the documentation
                    402: and/or other materials provided with the distribution.
                    403: 3. All advertising materials mentioning features or use of this software must
                    404: display the following acknowledgement: This product includes software developed
                    405: by Federico Lupi for the NetBSD Project.
                    406: 4. The name of the author may not be used to endorse or promote products
                    407: derived from this software without specific prior written permission.
                    408: 
                    409: THIS SOFTWARE IS PROVIDED BY THE AUTHOR "AS IS" AND ANY EXPRESS OR IMPLIED
                    410: WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
                    411: MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT
                    412: SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
                    413: EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
                    414: OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
                    415: INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
                    416: CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
                    417: IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY
                    418: OF SUCH DAMAGE.
                    419: 
                    420: #### The NetBSD Developers
                    421: 
                    422: Copyright © 1999, 2000, 2001, 2002 Federico Lupi
                    423: 
1.6       jdf       424: Copyright © 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013 The NetBSD Foundation
1.1       jdf       425: 
                    426: All brand and product names used in this guide are or may be trademarks or registered trademarks of their respective owners.
                    427: 
                    428: NetBSD® is a registered trademark of The NetBSD Foundation, Inc.

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