About this Document............................................2 What is NetBSD?................................................2 Changes Between The NetBSD 3.0 release and 3.0.1 update........3 Kernel......................................................3 Networking..................................................4 File system.................................................4 Libraries...................................................4 Security....................................................4 Miscellaneous...............................................5 acorn26 specific............................................5 amiga specific..............................................5 hp300 specific..............................................5 i386 specific...............................................5 m68k specific...............................................5 mips specific...............................................5 powerpc specific............................................6 sparc specific..............................................6 xen specific................................................6 Changes Between The NetBSD 2.0 and 3.0 Releases................6 Supported platforms and machines............................6 Supported devices...........................................6 Kernel......................................................8 Networking..................................................9 File system.................................................9 Libraries...................................................9 Security...................................................10 System administration and user tools.......................10 Miscellaneous..............................................10 sun3 specific..............................................11 The Future of NetBSD..........................................11 Sources of NetBSD.............................................11 NetBSD 3.0.1 Release Contents.................................11 NetBSD/sun3 subdirectory structure.........................13 Binary distribution sets...................................13 NetBSD/sun3 System Requirements and Supported Devices.........15 Supported hardware.........................................15 Getting the NetBSD System on to Useful Media..................16 Creating boot/install tapes................................16 Boot/Install from NFS server...............................16 Install/Upgrade from CD-ROM................................17 Install/Upgrade via FTP....................................17 Preparing your System for NetBSD installation.................17 Installing the NetBSD System..................................18 Installing from tape.......................................18 Installing from NFS........................................19 Installing from SunOS......................................20 Booting the Miniroot.......................................20 Miniroot install program...................................20 Post installation steps.......................................21 Upgrading a previously-installed NetBSD System................23 Compatibility Issues With Previous NetBSD Releases............25 Issues affecting an upgrade from NetBSD 2.1 and older......25 Using online NetBSD documentation.............................25 Administrivia.................................................26 Thanks go to..................................................26 We are........................................................31 Legal Mumbo-Jumbo.............................................37 The End.......................................................43
This document describes the installation procedure for
It is available in four different formats titled
is one of
less(1)pager utility programs. This is the format in which the on-line man pages are generally presented.
You are reading the HTML version.
The NetBSD Operating System is a fully functional Open Source UNIX-like operating system derived from the University of California, Berkeley Networking Release 2 (Net/2), 4.4BSD-Lite, and 4.4BSD-Lite2 sources. NetBSD runs on fifty four different system architectures (ports), featuring seventeen machine architectures across fifteen distinct CPU families, and is being ported to more. The NetBSD3.0.1 release contains complete binary releases for many different system architectures. (A few ports are not fully supported at this time and are thus not part of the binary distribution. For information on them, please see the NetBSD web site at http://www.NetBSD.org/.)
NetBSD is a completely integrated system. In addition to its highly portable, high performance kernel, NetBSD features a complete set of user utilities, compilers for several languages, the X Window System, firewall software and numerous other tools, all accompanied by full source code.
NetBSD is a creation of the members of the Internet community. Without the unique cooperation and coordination the net makes possible, it's likely that NetBSD wouldn't exist.
The NetBSD 3.0.1 update is the first security/critical update of the NetBSD 3.0 release branch. This represents a selected subset of fixes deemed critical in nature for stability or security reasons.
These fixes will also appear in future releases (NetBSD 3.1 etc), together with other less-critical fixes and feature enhancements.
Specific updates are as follows:
wdc(4): after a reset don't wait for drives to come ready if there are no drives (fixes a 30s hang after resume).
wd(4)for 1 and 2TB disks.
azalia(4)when a connection list has invalid NIDs.
aic(4): work around an rbus resource allocation problem so cards work again.
twe(4): fix a memory leak in the TWEIO_GET_PARAM ioctl.
usb(4): Allow a NULL pointer as argument to usb_get_next_event(), and don't allocate a "struct usb_event" on stack in usb_add_event().
sysctl(2)before passing it to
vslock(9). This prevents a local DOS (SA2006-013).
pmatch(9)expression which should catch all present and future seagate drives larger than 200GB for the WD_QUIRK_FORCE_LBA48 quirks.
bridge(4)structs are initialized to 0.
sigaction(2)to setup automatic disposal of child processes after daemonizing
rpc.statd(8). This is more portable and avoids zombie
rpc.statd(8)processes after an NFS client running e.g. Mac OS X shuts down.
pam_nologin(8): use the class of the user, not then default class, when checking for nologin and ignorelogin login.conf(5) capabilities.
pam_unix(8): fix an uninitialized variable, and remove some unreachable code.
rnd(4)code probing for the Intel hardware RNG to avoid false detections (SA2006-009).
mail(1)creates record file with insecure umask (SA2006-007).
fast_ipsec(4)stack that renders the IPSec anti-replay service ineffective under certain circumstances (SA2006-011).
pam_securetty(8): don't issue a different message for root login on an insecure terminal.
sh(1)expand "$@" correctly again.
wdc(4), especially the deferral of drive probe.
The NetBSD3.0 release provides numerous significant functional enhancements, including support for many new devices, integration of hundreds of bug fixes, new and updated kernel subsystems, and many user-land enhancements. The result of these improvements is a stable operating system fit for production use that rivals most commercially available systems.
It is impossible to completely summarize a year of development that went into the NetBSD3.0.1 release. Some highlights include:
iteide(4): driver for ITE 8212 IDE controller.
ixpide(4): driver for ATI IXP series chipset IDE controller.
pdcsata(4): driver for Promise SATA150 (aka PDC203xx) controllers.
ipw(4): driver for Intel PRO/Wireless 2100.
iwi(4): driver for Intel PRO/Wireless 2200AG/2915ABG.
rtw(4): driver for Realtek RTL8180L IEEE 802.11b wireless network.
vge(4): driver for VIA VT612X Gigabit Ethernet controller.
xge(4): driver for Neterion Xframe-I 10 gigabit Ethernet.
cdce(4): driver for CDC USB Ethernet.
atu(4): driver for Atmel AT76C50x based 802.11b wireless network interfaces.
uep(4): driver for eGalax USB touchpanel controller.
ugensa(4): driver for USB generic serial adapter, which currently supports CDMA Wireless PC Card.
auixp(4): driver for ATI IXP series chipset audio controller.
auacer(4): driver for ALi M5455 audio controller.
azalia(4): driver for High Definition Audio controller.
spif(4): driver for Sun SUNW,spif multi-port Sbus card.
viaide(4)now supports nForce2 Ultra 400, nForce3 250 IDE and SATA, and nForce4 IDE and SATA controllers.
viaide(4)also supports VIA VT6421 SATA RAID controller though drives on the controller need to be configured into RAID/JOBS sets via its BIOS.
siside(4)now supports SiS 180 and 741 SATA controllers.
artsata(4), which is the Intel i31244 Serial ATA disk controller driver, now supports DPA mode.
satalink(4)now supports Silicon Image 3512 SATA.
piixide(4)now supports Intel 82801FB/FR (ICH6/6R) IDE and SATA, 82801FBM SATA, 82801G (ICH7) IDE and SATA, and i6300ESB IDE and SATA controllers. Also added basic support for RAID0 and RAID1 for the Adaptec HostRAID format as found on the Intel 6300ESB on-board RAID.
stge(4)now works on big-endian machines including sparc64 with hardware checksums.
aac(4)now supports Adaptec SATA RAID 2810SA.
mpt(4)now supports LSI Logic FC919x SCSI controllers.
spc(4)now has support for Fujitsu MB87030-based PCMCIA SCSI controller.
bge(4)now supports Broadcom BCM5788, BCM5705K, BCM5721, and BCM5751M Gigabit Ethernet controllers, and has 802.3x flow control support.
hme(4)now have hardware checksums support.
wm(4)now supports TCPv4 hardware transmit segment offload.
wm(4)now supports more Intel Gigabit Ethernet chips and 64bit PCI DMA transfer,
re(4)now supports Corega CG-LAPCIGT Gigabit Ethernet, and RTL8169 based CardBus Ethernet interfaces, including NetGear GA-511.
ex(4)now supports 3Com 3c920B-EMB-WNM Integrated Fast Ethernet.
sk(4)now supports Belkin Gigabit Desktop Network card.
bce(4)now supports Broadcom BCM4401-B0 Ethernet.
tl(4)now supports Compaq Netelligent 10 T/2 PCI UTP/Coax Controller.
wi(4)now supports SMC2531W-B EliteConnect Wireless Adapter.
fxp(4)now supports Intel 82801FB (ICH6) 10/100 Ethernet.
tlp(4)now supports LinkSys PCMPC200 Cardbus Ethernet and ASIX AX88140A/AX88141 chipsets.
atw(4)ADMtek ADM8211 802.11 wireless network driver.
auich(4)now supports nForce2 Ultra 400, nForce3 250 MCP-T AC-97, nForce4, Intel ICH7, and Intel 6300ESB audio controllers.
auvia(4)now supports suspend and resume.
puc(4)now supports VS-Com PCI-210H 2S/1P card, VScom PCI-200 2S card, and ADDI-DATA APCI-7800 8-port serial adapter.
uftdi(4)now supports Sealevel Systems' uftdi-based USB-Serial adapter.
uvscom(4)now supports SUNTAC U-Cable type A4 USB serial adapter.
pms(4)now supports synaptics touchpad.
lm(4)now supports iTE IT8705f and Winbond 83627THF environment monitor controllers.
ehci(4)USB 2.0 controllers.
uax(4)ASIX AX88172 USB Ethernet driver has been replaced by
axe(4)driver derived from FreeBSD.
vnd(4)pseudo-device now support compressed image.
statvfs(2)family of system calls.
ptm(4), pty/98 pty multiplexor device.
swwdog(4), a software watchdog timer facility.
compat_darwin(8)emulation now supports MacOS X.3 binaries.
wscons(9), the machine-independent console framework. Additionally sparc64 port switched to a XFree86 based X server and now supports the cg6, mach64 and ffb/afb framebuffers with acceleration.
pollts(2)synchronous I/O multiplexing system calls.
gif(4)interface to bridges.
tap(4), the virtual Ethernet device.
ppp(4)has been updated to 2.4.3.
gre(4)now supports tunneling of the IPv6 Protocol.
fss(4), file system snapshot support has been added.
fsck_ext2fs(8)also handles them and supports conversion from old file systems.
memmem(3)to libc, which is API compatible with the functions in FreeBSD and Linux.
syslogd(8), mostly from FreeBSD.
fsck(8)now has a progress meter option.
dump(8)now supports file system snapshots.
sockstat(1), which lists open sockets.
seq(1), a utility which prints a sequence of numbers, derived from Plan 9.
audio(9)interface is improved. Added capability of audio software filter pipeline, which makes it easy for hardware drivers to add encoding support or sample rates support.
Kernel interfaces have continued to be refined, and more subsystems and device drivers are shared among the different ports. You can look for this trend to continue.
This is the eighth major release of NetBSD/sun3.
The NetBSD Foundation has been incorporated as a non-profit organization. Its purpose is to encourage, foster and promote the free exchange of computer software, namely the NetBSD Operating System. The foundation will allow for many things to be handled more smoothly than could be done with our previous informal organization. In particular, it provides the framework to deal with other parties that wish to become involved in the NetBSD Project.
The NetBSD Foundation will help improve the quality of NetBSD by:
We intend to begin narrowing the time delay between releases. Our ambition is to provide a full release every six to eight months.
We hope to support even more hardware in the future, and we have a rather large number of other ideas about what can be done to improve NetBSD.
We intend to continue our current practice of making the NetBSD-current development source available on a daily basis.
We intend to integrate free, positive changes from whatever sources submit them, providing that they are well thought-out and increase the usability of the system.
Above all, we hope to create a stable and accessible system, and to be
responsive to the needs and desires of
users, because it is for
and because of them that
The root directory of the NetBSD3.0.1 release is organized as follows:
In addition to the files and directories listed above, there is one directory per architecture, for each of the architectures for which NetBSD3.0.1 has a binary distribution.
The source distribution sets can be found in subdirectories of the
subdirectory of the distribution tree.
They contain the complete sources to the system.
The source distribution sets are as follows:
All the above source sets are located in the
subdirectory of the distribution tree.
The source sets are distributed as compressed tar files.
Except for the
set, which is traditionally unpacked into
all sets may be unpacked into
with the command:
#( cd / ; tar -zxpf - ) < set_name.tgz
In each of the source distribution set directories, there are files which contain the checksums of the files in the directory:
The MD5 digest is the safest checksum, followed by the POSIX checksum. The other two checksums are provided only to ensure that the widest possible range of system can check the integrity of the release files.
sun3subdirectory of the distribution:
.../NetBSD-3.0.1/sun3/. It contains the following files and directories:
.morefile contains underlined text using the
more(1)conventions for indicating italic and bold display.
sun3/binary/setssubdirectory of the NetBSD3.0.1 distribution tree, and are as follows:
/usr/include) and the various system libraries (except the shared libraries, which are included as part of the base set). This set also includes the manual pages for all of the utilities it contains, as well as the system call and library manual pages.
/etcand in several other places. This set must be installed if you are installing the system from scratch, but should not be used if you are upgrading.
/netbsd. You must install this distribution set.
groff(1), all related programs, and their manual pages.
NetBSD maintains its own set of sources for the X Window System in order to assure tight integration and compatibility. These sources are based on XFree86, and tightly track XFree86 releases. They are currently equivalent to XFree86 4.4.0. Binary sets for the X Window System are distributed with NetBSD. The sets are:
The sun3 binary distribution sets are distributed as gzipped tar files
named with the extension
The instructions given for extracting the source sets work equally
well for the binary sets, but it is worth noting that if you use that
method, the filenames stored in the sets are relative and therefore
the files are extracted
below the current directory.
Therefore, if you want to extract the binaries into your system, i.e.
replace the system binaries with them, you have to run the
command from the root directory (
) of your system.
This utility is used only in a Traditional method installation.
There is a collection of Sun3 and Sun3X kernels in the
subdirectory of the
The ones named
contain a root file system image and should only be used for the
The others are included for convenience.
(Most people will want to use
Please note that these kernels are simply gzipped and are not tar archives.
NetBSD/sun3 3.0.1 runs on most Sun3 machines, including:
Note that NetBSD/sun3 now includes support for `Sun3X' machines, which used to be supported with a separate NetBSD/sun3x distribution.
The minimal configuration requires 4 MB of RAM and about 80 MB of disk space. To install the entire system requires much more disk space (approx. 100 MB additional space is necessary for full sources). To run X or compile the system, more RAM is recommended. Good performance requires 8 MB of RAM, or 16 MB when running the X Window System.
Here is a table of recommended HD partition sizes for a full install:
|Partition||Suggested||+ X||Needed||+ X|
|/ (root)||20 MB||20 MB||15 MB||15 MB|
|/usr||175 MB||205 MB||75 MB||105 MB|
|/var||20 MB||20 MB||5 MB||5 MB|
As you may note, the recommended size of
is 100 MB greater than
This is to leave room for a kernel source and compile tree as
you will probably want to compile your own kernel.
is large and bulky to accommodate all people).
Note that the sun3 installation procedure uses a miniroot image which is placed into the swap area of the disk. The swap partition must be at least as large as the miniroot image (10 MB).
If it's not on this list, there is no support for it in this release.
Installation is supported from several media types, including:
The procedure for transferring the distribution sets onto installation media depends on the type of media. Instructions for each type of media are given below.
In order to create installation media, you will need all the files in the directory
The boot tape is created as follows:
# cd .../NetBSD-3.0.1/sun3/installation/tapeimage
# sh MakeBootTape /dev/nrst0
The install tape is created as follows:
# cd .../NetBSD-3.0.1/sun3/installation/tapeimage
# sh MakeInstallTape /dev/nrst0
If the tapes do not work as expected, you may need to explicitly
set the EOF mark at the end of each tape segment.
It may also be necessary to use the
this argument is incompatible with the
Consult the tape-related manual pages on the system where the tapes are
created for more details.
If you are using a
system as the boot-server, have a look at
manual page for guidelines on how to proceed with this.
If the server runs another operating system, consult the
documentation that came with it (i.e.
When instructed to boot over the network, your sun3 expects to be
able to download a second stage bootstrap program via
it has acquired its IP address through
It will attempt to download a file using a name derived from the
machine's recently acquired IP address,
and in the case of sun3x machines, an extension which corresponds to the
(It may be handy to have a hexadecimal
calculator for this next step.)
The filename is created by
converting the machine's assigned IP address into hexadecimal,
most-significant octet first, using uppercase characters for the
non-decimal (A-F) digits.
sun3x machines use a filename suffix of
For example, a sun3 which has been assigned IP address 126.96.36.199
will make an
and a sun3x will try
Normally, this file
is a symbolic link to the
program, which should
be located in a place where the
daemon can find it.
(Remember, many TFTP daemons run in a chroot'ed environment.)
The netboot program may be found in the install directory of this distribution.
The netboot program will query a bootparamd server to find the
NFS server address and path name for its root, and then load a
kernel from that location.
The server should have a copy of the netbsd-rd kernel in the root area
for your client (no other files are needed in the client root) and
on the server
should have an entry for your client and its root directory.
The client will need access to the miniroot image, which can be
provided using NFS or remote shell.
If you will be installing NetBSD on several clients, it may be useful to know that you can use a single NFS root for all the clients as long as they only use the netbsd-rd kernel. There will be no conflict between clients because the RAM-disk kernel will not use the NFS root. No swap file is needed; the RAM-disk kernel does not use that either.
.../install(which you get via FTP). Once you have booted netbsd-rd (the RAM-disk kernel) and loaded the miniroot, you can load any of the distribution sets over the net using FTP. The install program in the miniroot automates the work required to configure the network interface and transfer the files.
The preparations for this installation/upgrade method are easy; all
you make sure that there's some FTP site from which you can retrieve
distribution when you're about to install or upgrade.
You need to know the numeric IP address of that site, and, if it's not on
a network directly connected to the machine on which you're installing
you need to know the numeric IP address of the
router closest to the
Finally, you need to know the numeric IP address of the
Sun3 machines usually need little or no preparation before installing NetBSD, other than the usual, well advised precaution of backing up all data on any attached storage devices.
You will need to know the SCSI target ID of the drive on which you will install NetBSD.
sd2, target 2 is
It might be a good time to run the diagnostics on your Sun3.
First, attach a terminal to the
serial port, then set the
switch to the Diagnostic position, and power-on the machine.
The Diag. switch setting forces console interaction to occur on ttya.
Note that the 3/80 has a
diag switch you can set at
the PROM monitor prompt.
To turn on diag boot mode, do:
q 70b 12
To return to normal boot mode, do:
q 70b 6.
The console location (ttya, ttyb, or keyboard/display) is controlled
by address 0x1F in the EEPROM, which you can examine and change in
the PROM monitor by entering
followed by a numeric value (or
if you don't want to change it).
Console values are:
Installing NetBSD is a relatively complex process, but if you have this document in hand it should not be too difficult.
There are several ways to install NetBSD onto your disk. If your machine has a tape drive the easiest way is Installing from tape (details below). If your machine is on a network with a suitable NFS server, then Installing from NFS is the next best method. Otherwise, if you have another Sun machine running SunOS you can initialize the disk on that machine and then move the disk. (Installing from SunOS is not recommended.)
The first example will use the tape on SCSI target 4, where the
second will use SCSI target 5.
is the monitor prompt.
After the tape loads, you should see many lines of configuration messages, and then the following `welcome' screen:
Welcome to the NetBSD/sun3 RAMDISK root!
This environment is designed to do only three things: 1: Partition your disk (use the command: edlabel /dev/rsd0c) 2: Copy a miniroot image into the swap partition (/dev/rsd0b) 3: Reboot (using the swap partition, i.e. /dev/sd?b).
Note that the sun3 firmware cannot boot from a partition located more than 1 GB from the beginning of the disk, so the swap partition should be completely below the 1 GB boundary.
Copying the miniroot can be done several ways, allowing the source of the miniroot image to be on any of these: boot tape, NFS server, TFTP server, rsh server
The easiest is loading from tape, which is done as follows: mt -f /dev/nrst0 rewind mt -f /dev/nrst0 fsf 2 dd bs=32k if=/dev/nrst0 of=/dev/rsd0b (For help with other methods, please see the install notes.)
To reboot using the swap partition, first use "halt", then at the PROM monitor prompt use a command like: b sd(,,1) -s
To view this message again, type: cat /.welcome
Copy the miniroot as described in the welcome message, and reboot from that just installed miniroot. See the section entitled Booting the miniroot for details.
First, at the Sun PROM monitor prompt, enter a boot command using the network interface as the boot device. On desktop machines this is le, and ie on the others. Examples:
>b le() -s
>b ie() -s
After the boot program loads the RAMDISK kernel, you should see the welcome screen as shown in the Installing from tape section above. You must configure the network interface before you can use any network resources. For example the command:
ssh> ifconfig le0 inet 188.8.131.52 up
will bring up the network interface with that address. The next step is to copy the miniroot from your server. This can be done using either NFS or remote shell. (In the examples that follow, the server has IP address 184.108.40.206.) You may then need to add a default route if the server is on a different subnet:
ssh> route add default 220.127.116.11 1
You can look at the route table using:
ssh> route show
Now mount the NFS file system containing the miniroot image:
ssh> mount -r 18.104.22.168:/server/path /mnt
The procedure is simpler if you have space for an expanded (not compressed) copy of the miniroot image. In that case:
ssh> dd if=/mnt/miniroot of=/dev/rsd0b bs=8k
Otherwise, you will need to use
to expand the miniroot image while copying.
This is tricky because the
(small shell) does not handle
Instead, you first run the reader in the background with its input set
and then run the other program in the foreground with its output to
The result looks like this:
ssh> run -bg dd if=/dev/pipe of=/dev/rsd0b obs=8k
ssh> run -o /dev/pipe zcat /mnt/install/miniroot.gz
To load the miniroot using rsh to the server, you would use a pair of commands similar to the above. Here is another example:
ssh> run -b dd if=/dev/pipe of=/dev/rsd0b obs=8k
ssh> run -o /dev/pipe rsh 22.214.171.124 zcat miniroot.gz
First, boot SunOS and place the miniroot file onto the hard drive. If you do not have gzip for SunOS, you will need to decompress the image elsewhere before you can use it.
Next, bring SunOS down to single user mode to insure that nothing will be using the swap space on your drive. To be extra safe, reboot the machine into single-user mode rather than using the shutdown command.
Now copy the miniroot image onto your swap device (here
with the command
gzip -dc miniroot.gz | dd of=/dev/rsd0b obs=32k
or if you have already decompressed the miniroot
dd if=miniroot.gz of=/dev/rsd0b obs=32k
Finally, reboot the machine and instruct the ROM to boot from the swap device as described in the next section.
b' of the disk with SCSI target ID=0 then the PROM boot command would be:
>b sd(0,0,1) -s
With SCSI target ID=2, the PROM is:
>b sd(0,10,1) -s
The numbers in parentheses above are:
The miniroot's install program will:
foo.bar.org. If, during the process of configuring the network interfaces, you make a mistake, you will be able to re-configure that interface by simply selecting it for configuration again.
First-time installation on a system through a method other than the
installation program is possible, but strongly discouraged.
Once you've got the operating system running, there are a few things you need to do in order to bring the system into a properly configured state, with the most important ones described below.
If you or the installation software haven't done any configuration of
the system will drop you into single user mode on first reboot with the
and with the root file system
When the system asks you to choose a shell, simply press
to get to a
If you are asked for a terminal type, respond with
(or whatever is appropriate for your terminal type)
You may need to type one of the following commands to get your delete key
to work properly, depending on your keyboard:
# stty erase '^h'
# stty erase '^?'
At this point, you need to configure at least one file in the
You will need to mount your root file system read/write with:
# /sbin/mount -u -w /
Change to the
directory and take a look at the
Modify it to your tastes, making sure that you set
so that your changes will be enabled and a multi-user boot can
Default values for the various programs can be found in
where some in-line documentation may be found.
More complete documentation can be found in
directory is on a separate partition and you do not know how to use
you will have to mount your
partition to gain access to
Do the following:
# mount /usr
# export TERM=vt220
If you have
on a separate partition, you need to repeat that step for it.
After that, you can edit
When you have finished, type
at the prompt to
leave the single-user shell and continue with the multi-user boot.
Other values that need to be set in
for a networked environment are
furthermore add an
along the lines of
or, if you have
To enable proper hostname resolution, you will also want to add an
file or (if you are feeling a little more adventurous) run
for more information.
Instead of manually configuring network and naming service,
DHCP can be used by setting
Other files in
that may require modification or setting up include
After reboot, you can log in as
at the login prompt.
Unless you've set a password in
is no initial password.
If you're using the machine in a networked environment,
you should create an account for yourself (see below) and protect it and the
account with good passwords.
By default, root login from the network is disabled (even via
One way to become root over the network is to log in as a different
user that belongs to group
to become root.
Unless you have connected an unusual terminal device as the console
you can just press
when it prompts for
command to add accounts to your system.
if you want to edit the password database.
If you have installed the X Window System, look at the files in
Don't forget to add
to your path in your shell's dot file so that you have access to the X binaries.
If you wish to install any of the software freely available for UNIX-like systems you are strongly advised to first check the NetBSD package system. This automatically handles any changes necessary to make the software run on NetBSD, retrieval and installation of any other packages on which the software may depend, and simplifies installation (and deinstallation), both from source and precompiled binaries.
3.0.1/sun3/Allsubdir. You can install them with the following commands under
# PKG_PATH=ftp://ftp.NetBSD.org/pub/NetBSD/packages/3.0.1/sun3/All # export PKG_PATH # pkg_add -v tcsh # pkg_add -v bash # pkg_add -v perl # pkg_add -v apache # pkg_add -v kde # pkg_add -v mozilla ...
If you are using
then replace the first two lines with the following:
# setenv PKG_PATH ftp://ftp.NetBSD.org/pub/NetBSD/packages/3.0.1/sun3/All ...
The above commands will install the Tenex-csh and Bourne Again shell, the Perl programming language, Apache web server, KDE desktop environment and the Mozilla web browser as well as all the packages they depend on.
/usr/pkgsrc(though other locations work fine), with the commands:
# mkdir /usr/pkgsrc
#( cd /usr/pkgsrc ; tar -zxpf - ) < pkgsrc.tar.gz
After extracting, see the
files in the extraction directory (e.g.
for more information.
/etc/mail/aliasesto forward root mail to the right place. Don't forget to run
/etc/mail/sendmail.cffile will almost definitely need to be adjusted; files aiding in this can be found in
/usr/share/sendmail. See the
READMEfile there for more information. If you prefer postfix as MTA, adjust
/etc/rc.localto run any local daemons you use.
/etcfiles are documented in section 5 of the manual; so just invoking
# man 5 filename
is likely to give you more information on these files.
It is possible to easily upgrade your existing NetBSD/sun3 system using the upgrade program in the miniroot. If you wish to upgrade your system by this method, simply select the upgrade option once the miniroot has booted. The upgrade program with then guide you through the procedure. The upgrade program will:
Using the miniroot's upgrade program is the preferred method of upgrading your system.
However, it is possible to upgrade your system manually. To do this, follow the following procedure:
# /sbin/fsck -pf
# /sbin/mount -a -t nonfs
/usr/shareon an NFS server, you will want to mount those file systems as well. To do this, you will need to enable the network:
# sh /etc/rc.d/network start
the) base binary set:
# cd /
# pax -zrvpe -f Ar /path/to/base.tgz
# cd /usr/mdec
# cp -p ./ufsboot /mnt/ufsboot
#sync ; sleep 1 ; sync
# /usr/sbin/installboot -v /dev/rsd0a bootxx /ufsboot
# cd /
# pax -zrvpe -f path_to_set
Users upgrading from previous versions of NetBSD may wish to bear the following problems and compatibility issues in mind when upgrading to NetBSD3.0.1.
/etc/pam.dwith appropriate configuration files for the Pluggable Authentication Modules (PAM) because you will not be able to login any more otherwise. Using postinstall as described below will take care of this. Please refer to http://www.netbsd.org/guide/en/chap-pam.html for documentation about PAM.
The following issues can generally be resolved by extracting the etc set into a temporary directory and running postinstall:
postinstall -s /path/to/etc.tgz check postinstall -s /path/to/etc.tgz fix
Issues fixed by postinstall:
/etcneed upgrading. These include:
The following issues need to be resolved manually:
Documentation is available if you first install the manual
(documentation) are denoted by
Some examples of this are
The section numbers group the topics into several categories, but three are of primary interest: user commands are in section 1, file formats are in section 5, and administrative information is in section 8.
The man command is used to view the documentation on a topic, and is started by entering man[ section] topic. The brackets  around the section should not be entered, but rather indicate that the section is optional. If you don't ask for a particular section, the topic with the lowest numbered section name will be displayed. For instance, after logging in, enter
# man passwd
to read the documentation for
To view the documentation for
# man 5 passwd
If you are unsure of what man page you are looking for, enter
where subject-word is your topic of interest; a list of possibly related man pages will be displayed.
If you've got something to say, do so! We'd like your input. There are various mailing lists available via the mailing list server at majordomo@NetBSD.org. To get help on using the mailing list server, send mail to that address with an empty body, and it will reply with instructions.
There are various mailing lists set up to deal with comments and questions about this release. Please send comments to: netbsd-comments@NetBSD.org.
To report bugs, use the
command shipped with
and fill in as much information about the problem as you can.
Good bug reports include lots of details.
Additionally, bug reports can be sent by mail to:
is encouraged, however, because bugs reported with it
are entered into the
bugs database, and thus can't slip through
There are also port-specific mailing lists, to discuss aspects of each port of NetBSD. Use majordomo to find their addresses, or visit http://www.NetBSD.org/MailingLists/. If you're interested in doing a serious amount of work on a specific port, you probably should contact the `owner' of that port (listed below).
If you'd like to help with this effort, and have an idea as to how you could be useful, send us mail or subscribe to: netbsd-help@NetBSD.org.
As a favor, please avoid mailing huge documents or files to these mailing lists. Instead, put the material you would have sent up for FTP or WWW somewhere, then mail the appropriate list about it, or, if you'd rather not do that, mail the list saying you'll send the data to those who want it.
Keith Bostic Ralph Campbell Mike Karels Marshall Kirk McKusick
for their ongoing work on BSD systems, support, and encouragement.
AMD - Advanced Micro Devices, Inc. ASA Computers Aaron Wall ABE Masayuki AboveNet Communications, Inc. Achim Grolms Adam Kasper Adaptec Advanced System Products, Inc. Akihiro IIJIMA Alex Poylisher Algorithmics, Ltd. Alistair Crooks Allegro Networks Aloys Keller Andreas Berg Andreas Jellinghaus Andrew Brown Andrew Gillham Andy Hagans Antonio Larripa Arend Harrewijne Armijn Hemel Atsushi YOKOYAMA Avalon Computer Systems Bay Area Internet Solutions Ben Collver Benoit Lepage Bernhard Moellemann Bill Coldwell Bill Sommerfeld Bill Squier Brad Salai Brains Corporation, Japan Brian Carlstrom Brian McGroarty Brian Mitchell Canada Connect Corporation Carl Shapiro Castor Fu Central Iowa (Model) Railroad Charles Conn Charles D. Cranor Charles M. Hannum Chris Legrow Chris Townsend Christer O. Andersson Christopher G. Demetriou Christos Zoulas Chuck Silvers Cologne Chip AG Computer und Literatur Verlag Computertechnik Krienke & Nolte Computing Services Department, The University of Liverpool Convert Tools Co-operative Research Centre for Enterprise Distributed Curt Sampson DAYOMON from Japan Damicon Kraa, Finland Daniel de Kok Dave Burgess Dave Rand Dave Tyson David Brownlee Dayton Clark Demon Internet, UK Derek Fellion Digital Equipment Corporation Distributed Processing Technology Distro Jockey Douglas J. Trainor Dr.ir. F.W. Dillema Easynet, UK Ed Braaten Edward Richley emuty Eric and Rosemary Spahr Erik Berls Erik E. Fair Erkki Ruohtula Ernst Lehmann Espen Randen Ewald Kicker Florent Parent Frank Kardel Free Hardware Foundation Front Range *BSD User Group FUKAUMI Naoki Gan Uesli Starling Garth R. Patil Geert Hendrickx (ghen) Geert Jan de Groot GK Meier Gordon Zaft Grant Beattie Greg Gingerich Greg Girczyc Guenther Grau HP Sweden Hanno Wagner Hans Huebner Harald Koerfgen Haroon Khalid Harry McDonald Hauke Fath Heiko W. Rupp Herb Peyerl Hernani Marques Madeira Hidekichi Ookubo Hideyuki Kido Hisashi Fujinaka Holger Weiss Hubert Feyrer IBM Corporation IMAI Kiyoshi Innovation Development Enterprises of America Intel Internet Software Consortium Internet Users Forever IKI Interoute Telecommunications, UK JNUG (raised at JNUG meeting & BOF August 2005) James Bursa James Chacon Jan Joris Vereijken Jason Birnschein Jason Brazile Jason R. Thorpe Jeff Rizzo Jeff Woodall - Portland, OR Jens Schoenfeld Jim Wise Joachim Nink Joachim Thiemann Joel CARNAT John Heasley John Kohl John P. Refling Jonathan P. Kay Jordan K. Hubbard Jorgen Lundman Karl Wagner Kenji Hisazumi Kenneth Alan Hornstein Kenneth P. Stox Kevin Keith Woo Kevin Sullivan Klaus Lichti Kimmo Suominen Korea BSD User Forum Krister Waldfridsson Kwok Ng Lars Mathiassen Lehmanns Fachbochhandlung Lex Wennmacher LinuxFest Northwest Luke Maurits Luke Mewburn MS Macro System GmbH, Germany Maki Kato Marc Tooley Marcus Wyremblewski Mark Brinicombe Mark Houde Mark Perkins Mark S. Thomas Mason Loring Bliss Martin Cernohorsky Martin J. Ekendahl Matt Dainty Matt Thomas Matthew Jacob Matthew Sporleder Matthias Scheler Mattias Karlsson Mel Kravitz Michael Graff Michael "Kvedulv" Moll Michael L. Hitch Michael Richardson Michael Thompson Michael W. James Mike Price Mirko Thiesen (Thiesi) Murphy Software BV, Netherlands Neil J. McRae Noah M. Keiserman Norman R. McBride Numerical Aerospace Simulation Facility, NASA Ames Research Olaf "Rhialto" Seibert Oliver Cahagne Oppedahl & Larson LLP Palle Lyckegaard Paul Ripke Paul Southworth Pawel Rogocz Pearson Education Perry E. Metzger Petar Bogdanovic Peter C. Wallace Peter J. Bui Peter Postma Petri T. Koistinen Phil Thomas Piermont Information Systems Inc. Pierre-Philipp Braun Precedence Technologies Ltd Public Access Networks Corporation Ralph Campbell Randy Ray Real Weasel Reinoud Zandijk Renewed Health Company Richard Nelson Rob Windsor Robert Pankratz Robert Thille Roland Lichti Ross Harvey Ryan Campbell SDF Public Access Unix, Inc. 501(c)(7) SMC Networks Inc. Salient Systems Inc. Sander van Dijk Scott Ellis Scott Kaplan Scott Walters Sean Davis Simon Burge Soren Jacobsen Soren Jorvang Stephen Borrill Stephen Early Steve Allen Steve Wadlow Steven M. Bellovin SunROOT# Project Sylvain Schmitz Takahiro Kambe TAKEUCHI Yoji Tamotsu Kanoh Tasis Michalakopoulos (Athens, Greece) Tatoku Ogaito Ted Lemon Ted Spradley The Names Database The NetBSD Mission The People's Republic of Ames Thierry Lacoste Thierry Laronde Thomas Runge Thor Lancelot Simon Tim Law Timo Scholer Tino Hanich Tino Wildenhain Tom Coulter Tom Ivar Helbekkmo Tom Lyon Tomas Dabasinskas Torsten Harenberg Toru Nishimura Toshiba Turbocat's Development Tyler Sarna UTN Web Directory VMC Harald Frank, Germany Warped Communications, Inc. Wasabi Systems, Inc. Whitecross Database Systems Ltd. William Gnadt Worria Affordable Web Hosting Worria Web Hosting wwwTrace Traceroute Server Directory Yusuke Yokota Zach Metzinger
(If you're not on that list and should be, tell us! We probably were not able to get in touch with you, to verify that you wanted to be listed.)
(in alphabetical order)
|The NetBSD core group:|
|Valeriy E. Ushakov||uwe@NetBSD.org|
|The portmasters (and their ports):|
|Frank van der Linden||fvdl@NetBSD.org||amd64|
|Frank van der Linden||fvdl@NetBSD.org||i386|
|Jun-ichiro itojun Hagino||itojun@NetBSD.org||evbsh3|
|Jun-ichiro itojun Hagino||itojun@NetBSD.org||mmeye|
|The NetBSD 3.0.1 Release Engineering team:|
|Jun-ichiro itojun Hagino||itojun@NetBSD.org|
|Robert V. Baron||rvb@NetBSD.org|
|Mason Loring Bliss||mason@NetBSD.org|
|D'Arcy J.M. Cain||darcy@NetBSD.org|
|Chris G. Demetriou||cgd@NetBSD.org|
|Tracy Di Marco White||gendalia@NetBSD.org|
|Michael van Elst||mlelstv@NetBSD.org|
|Jason R. Fink||jrf@NetBSD.org|
|Simon J. Gerraty||sjg@NetBSD.org|
|Brian C. Grayson||bgrayson@NetBSD.org|
|Jun-ichiro itojun Hagino||itojun@NetBSD.org|
|Charles M. Hannum||mycroft@NetBSD.org|
|Michael L. Hitch||mhitch@NetBSD.org|
|Christian E. Hopps||chopps@NetBSD.org|
|Love Hörnquist Åstrand||lha@NetBSD.org|
|Lonhyn T. Jasinskyj||lonhyn@NetBSD.org|
|Min Sik Kim||minskim@NetBSD.org|
|Daniel de Kok||daniel@NetBSD.org|
|Kentaro A. Kurahone||kurahone@NetBSD.org|
|Johnny C. Lam||jlam@NetBSD.org|
|Martin J. Laubach||mjl@NetBSD.org|
|Frank van der Linden||fvdl@NetBSD.org|
|Jared D. McNeill||jmcneill@NetBSD.org|
|Neil J. McRae||neil@NetBSD.org|
|Juan Romero Pardines||xtraeme@NetBSD.org|
|Julio M. Merino Vidal||jmmv@NetBSD.org|
|Jeremy C. Reed||reed@NetBSD.org|
|Tyler R. Retzlaff||rtr@NetBSD.org|
|Heiko W. Rupp||hwr@NetBSD.org|
|Karl Schilke (rAT)||rat@NetBSD.org|
|Thor Lancelot Simon||tls@NetBSD.org|
|Ian Lance Taylor||ian@NetBSD.org|
|Mike M. Volokhov||mishka@NetBSD.org|
|Brian R. Gaekeemail@example.com|
All product names mentioned herein are trademarks or registered trademarks of their respective owners.
The following notices are required to satisfy the license terms of the software that we have mentioned in this document:
This product includes software developed by the University of
California, Berkeley and its contributors.
This product includes software developed by the University of California, Berkeley and its contributors.