# $Id: README,v 1.1 1994/04/18 10:48:50 deraadt Exp $

Sparc Binary Snapshot #2: Tue Mar 29 02:58:07 MST 1994	src: Mar 22.
Sparc Binary Snapshot #3: Mon Apr 18 02:48:08 MDT 1994	src: Apr 16.

Initial test versions of a NetBSD/sparc binaries install are available
at
	ftp.iastate.edu:/pub/netbsd/NetBSD-current/binaries/sparc
	sun-lamp.cs.berkeley.edu:pub/NetBSD/arch/sparc
	ftp.wonderland.org:NetBSD/arch/sparc		[UK]
	ftp.informatik.tu-muenchen.de:\
	    /pub/comp/os/bsd/NetBSD/NetBSD-current/binaries/sparc
and many other NetBSD mirror sites. Some mirror sites may take a day
or two to catch up.

The NetBSD/sparc port runs on sun4c class machines, ie. the
SS 1, 1+, 2, IPC, IPX, SLC, and ELC. it does not run on the
server-series machines, or the SS10-series machines.

The ftp directory contains a number of very large .tar.gz files in there,
as well as this document and a helper install script.

NOTE: THESE INSTRUCTIONS MAY CHANGE WITH EACH SNAPSHOT.

Until there are better instructions written, here's a rough idea:

1.  format and partition the disk using sunos. yup, NetBSD/sparc uses
    sunos disk labels. i am running a quantum 105 with these partition
    sizes:
    a:    28140        0    4.2BSD     1024  8192    16   # (Cyl.    0 - 133)
    b:    16170    28140    unused        0     0         # (Cyl.  134 - 210)
    c:   204540        0    unused        0     0         # (Cyl.    0 - 973)
    g:   160230    44310    4.2BSD     1024  8192    16   # (Cyl.  211 - 973)

    Filesystem               512-blocks    Used   Avail Capacity  Mounted on
    /dev/sd0a              26090   18846    4634    80%    /
    /dev/sd0g             149444  131496    3002    98%    /usr
    amd:43                     0       0       0   100%    /home
    gecko:/usr/src       1549722  851783  542966    61%    /usr/src
    komodo:/usr/local     269346  243428   -1016   100%    /usr/local
    newt:/newt.usera     1128328  836910  178584    82%    /tmp_mnt/newt/newt.usera

2.  newfs it using sunos. yup, the filesystem format is identical.
    UFS hasn't changed much over the years. (If you can, there is
    a performance benefit from newfs'ing using NetBSD.)

3.  put a SunOS /boot program in the root partition, and use
    "installboot" to cause it to work. the "installboot" man page
    says to do something like this: say you are running SunOS, and
    the drive you are installing NetBSD/sparc on is currently at
    /dev/sd1. You have made the filesystems on that drive already.
	# mount /dev/sd1a /mnt
	# cp /boot /mnt/boot
	# cd /usr/mdec
	# ./installboot -vlt /mnt/boot bootsd /dev/rsd1a

4.  extract the provided *.tar.gz files and dev.cpio.gz onto the disk.
    the file "install.sh" will help you do this.

    (the file dev.tar.gz is included, but is of limited use because
    SunOS tar is not capable of extracting device nodes from tar
    archives.)

    mount your partition(s) in a proper tree starting at /mnt.
    In the same directory as your *.tar.gz and *.cpio.gz files are, run
    "./install.sh". (Now you may cut the head off the chicken and
    spray the blood over your walls and ceiling.)

    If you have done anything weird with partitions, take this moment
    to ensure that etc/fstab is corrent for your disk layout.

5.  the install script puts both the standard kernels in /mnt, and
    links netbsd to netbsd-sd0. the filesystem images do NOT contain
    these kernels. The same /etc/fstab file will work with either kernel.

    the kernel "netbsd-sd0" expects your root drive to be at the standard
    sunos sd0/scsi-id#3 location. "netbsd-sd1" maps scsi-id#1 to be sd0.

6.  your rom may need some setup. make sure you boot from `new command mode'.
    If your machine comes up and gives you a `>' prompt instead of `ok', type:
        >n
        ok setenv sunmon-compat? false
        ok
    this is needed because netbsd cannot handle the old-mode yet,
    and will firework on you.

    you cannot use the security modes of the sparc rom. sorry, same
    problem as above.
	ok setenv security-mode none

7.  if needed, swap your scsi id's. now try a reboot. initially I'd
    suggest you boot "-bs", then try multiuser after that. if you boot
    single-user the netbsd incantation for making root read-write
    is "mount -u /dev/sd0a /". alternatively, the command reboot is
    found in /sbin.

8.  to boot from netbsd by default, tell something like this to your
    rom.
	>n
	ok setenv boot-from sd(0,0,0)netbsd
	ok

please let me know of any errors in these instructions or in the
archives. if so i'll correct them.

good luck.

<deraadt@fsa.ca>