First cut at loongson installation notes.

8 files changed, 258 insertions, 0 deletions

diff --git a/distrib/notes/loongson/contents b/distrib/notes/loongson/contents
new file mode 100644
index 00000000000..a78e7829b96
--- /dev/null
+++ b/distrib/notes/loongson/contents
@@ -0,0 +1,34 @@
+dnl	$OpenBSD: contents,v 1.1 2010/02/03 17:10:44 miod Exp $
+TopPart
+
+OpenBSDdistsets
+
+OpenBSDbsd
+
+OpenBSDrd
+dnl not yet...
+dnl OpenBSDcd
+
+DistributionDescription(eleven)
+
+OpenBSDbase(47742339,128402380)
+
+OpenBSDcomp(19899514,66786294)
+
+OpenBSDetc(516201,1376199)
+
+OpenBSDgame(2667467,5978240)
+
+OpenBSDman(8226904,30048572)
+
+OpenBSDmisc(2935447,9912406)
+
+OpenBSDxbase(10844908,30932044)
+
+OpenBSDxetc(76099,282509)
+
+OpenBSDxfont(35584217,43728442)
+
+OpenBSDxserv(5776670,15092362)
+
+OpenBSDxshare(2766294,14738211)
diff --git a/distrib/notes/loongson/features b/distrib/notes/loongson/features
new file mode 100644
index 00000000000..790233fbeb1
--- /dev/null
+++ b/distrib/notes/loongson/features
@@ -0,0 +1,40 @@
+dnl	$OpenBSD: features,v 1.1 2010/02/03 17:10:44 miod Exp $
+dnl
+dnl This file lists almost all the conditional features of this port,
+dnl which are used to provide accurate installation notes.
+dnl
+dnl Information about the installer script features should be in sync with
+dnl	src/distrib/loongson/ramdisk/install.md
+dnl and the list files in
+dnl	src/distrib/loongson/ramdisk/list
+dnl
+dnl ====
+dnl
+dnl architecture name (for the packages directory)
+define({:-MACHINE_ARCH-:},mips64el)dnl
+dnl
+dnl define if /sbin/kbd exists on the media
+define({:-MDKBD-:},)dnl
+dnl
+dnl define if serial consoles need to be enabled in /etc/ttys
+dnl (i.e. md_consoleinfo is not empty)
+define({:-MDSERCONS-:},)dnl
+dnl
+dnl define if SMP kernels are provided
+define({:-MDSMP-:},)dnl
+dnl
+dnl define if shared libraries are provided
+define({:-MDSO-:},1)dnl
+dnl
+dnl define if some media have timezone information (TZ in their list)
+define({:-MDTZ-:},1)dnl
+dnl
+dnl define if glass console is possible
+dnl (XXX does not imply availablity of X servers though)
+define({:-MDX-:},1)dnl
+dnl
+dnl define if the X server can't start until machdep.allow_aperture is set
+define({:-MDXAPERTURE-:},)dnl
+dnl
+dnl define if the X server can start without a configuration file
+define({:-MDXDM-:},)dnl
diff --git a/distrib/notes/loongson/hardware b/distrib/notes/loongson/hardware
new file mode 100644
index 00000000000..bad80b65b5e
--- /dev/null
+++ b/distrib/notes/loongson/hardware
@@ -0,0 +1,12 @@
+dnl	$OpenBSD: hardware,v 1.1 2010/02/03 17:10:44 miod Exp $
+dnl When more than one model is supported, turn this into a list...
+The following machines are supported by OpenBSD/MACHINE:
+
+	Lemote Yeeloong (8.9" and 10.1" models)
+	  all onboard devices (keyboard, trackpad, display, SD card reader,
+	  USB ports, Ethernet adapter, wireless network adapter) are
+	  supported except for the audio controller;
+	  suspend/resume and battery information are not supported yet.
+dnl	Gdium Liberty 1000
+dnl
+dnl XXX give a list of tested USB devices too
diff --git a/distrib/notes/loongson/install b/distrib/notes/loongson/install
new file mode 100644
index 00000000000..0842abc7e0d
--- /dev/null
+++ b/distrib/notes/loongson/install
@@ -0,0 +1,93 @@
+dnl	$OpenBSD: install,v 1.1 2010/02/03 17:10:44 miod Exp $
+OpenBSDInstallPrelude
+
+dnl Describe netboot?
+Booting the installation media:
+
+The easiest way to boot into the OpenBSD installer is to copy the bsd.rd
+installation kernel to the main linux partition, and boot from it.
+
+Assuming the installation kernel has been copied to /boot/bsd.rd on the
+Linux system, at the PMON prompt, enter:
+
+    PMON> boot /dev/fs/ext2@wd0/boot/bsd.rd
+
+to boot the installation kernel.
+
+Alternatively, if your particular PMON flavour supports `fat' filesystems,
+you can boot the kernel from an usb key with:
+
+dnl check syntax
+    PMON> boot /dev/fs/msdos@usb0:/bsd.rd
+
+OpenBSDInstallPart2
+
+OpenBSDInstallPart3(,"sd0 for USB storage, or wd0 for internal storage
+	(either a disk drive or an SSD)")
+
+OpenBSDInstallPart4
+
+OpenBSDInstallMBRPart1
+
+dnl not until we have boot blocks... and then we'll probably need to
+dnl add text to mention the necessary little boot partition...
+dnl OpenBSDInstallMBRPart2
+	The fdisk(8) utility will be invoked to let you edit your MBR
+	partitioning.  The current MBR partitions defined will be
+	displayed and you will be allowed to modify them, and add new
+	partitions.
+
+	After your OpenBSD MBR partition has been setup, the real
+	partition setup can follow.
+
+OpenBSDInstallPart5({:-
+	If you have left Linux partitions defined on the disk, these will
+	usually show up as partition 'i', 'j' and so on.-:})
+
+OpenBSDInstallPart6({:-CD-ROM, -:})
+
+OpenBSDURLInstall
+
+OpenBSDCDROMInstall
+
+OpenBSDDISKInstall({:-"wdN" or -:},,{:-, Linux (ext2) or MS-DOS-:})
+
+OpenBSDCommonInstall
+
+dnl usb tape drives anyone?
+dnl OpenBSDTAPEInstall
+dnl
+OpenBSDInstallWrapup
+
+	As the OpenBSD/MACHINE port is very new, there is not yet a proper
+	bootloader. In addition to these steps, you will need, for the time
+	being, to copy the kernel image to the Linux partition and boot
+	from it. This annoyance is being worked on and should disappear
+	very soon.
+
+	After the installation is complete, you should add an OpenBSD
+	entry to the boot menu to be able to boot OpenBSD more easily.
+
+	The boot menu contents are found in /boot/boot.cfg on the Linux
+	partition. To add an OpenBSD entry, simply add a new entry in the
+	file, such as:
+
+	title OpenBSD
+		kernel /dev/fs/ext2@wd0/boot/bsd
+		args ""
+
+	In the example above, /dev/fs/ext2@wd0/boot/bsd is the PMON path
+	to the kernel image.
+
+	You may make OpenBSD the default option by changing the ``default''
+	line near the top of the file. The value on this line is the index
+	of the default entry, starting at zero. So if you added the OpenBSD
+	entry as the fourth entry in the file, it would become the default
+	choice with:
+
+	default 3
+
+	The timeout until the default choice is selected, in seconds, can be
+	modified on the ``timeout'' line.
+
+OpenBSDCongratulations
diff --git a/distrib/notes/loongson/prep b/distrib/notes/loongson/prep
new file mode 100644
index 00000000000..967842323a6
--- /dev/null
+++ b/distrib/notes/loongson/prep
@@ -0,0 +1,56 @@
+dnl	$OpenBSD: prep,v 1.1 2010/02/03 17:10:44 miod Exp $
+Most MACHINE systems are shipped with a Linux system installed on the disk
+drive or SSD.  This system will likely use two partitions, one for the
+system and applications, and another for the user data. OpenBSD will in turn
+need its own MBR partition.
+
+If there is no unpartitioned space left on the disk, it will be necessary to
+shrink and recreate the data partition; before installing OpenBSD/MACHINE,
+you should make sure any important data on this partition is backed up.
+
+If you intend to only use OpenBSD on your machine, please note that, at this
+point, it is necessary to keep an ext2 or ext3 Linux partition, to be able
+to boot the system.
+
+dnl
+Before you install your system, you should familiarize yourself with PMON,
+the open source firmware and bootloader of your machine.
+
+Entering PMON:
+dnl maybe lemote specific, does gdium use a boot menu too?
+    Upon powerup, or after a reset, a splash screen is displayed while PMON
+    initializes, and then a text mode boot menu appears.
+
+    At this menu, you can either select one of the sytems to boot with the
+    arrows keys and press enter, or abort the countdown sequence and get to
+    the PMON commandline by hitting `c'.
+
+    PMON command are entered at the ``PMON>'' prompt; you may correct typos
+    using the backspace key, and retrieve previous commands from the history
+    using Ctrl-P. Unfortunately, there is no cursor shape displayed, which
+    can make command line editing quite tedious.
+
+PMON file path concepts:
+
+    The filenames used by PMON always mention explicitely the location of
+    the filesystem they refer to, as well as the filesystem type. They
+    are constructed as
+    	/dev/fs/<filesystem type>@<device name>/<path wihtin the filesystem>
+
+dnl On the Lemote Yeeloong,
+    The internal storage (either a disk drive or an SSD) is `wd0'.
+dnl On the Gdium Liberty, the G-Key slot is `usbg0'.
+    Devices connected to the USB ports are named `usb0', `usb1', etc, in the
+    order PMON discovers them. At any time the ``devls'' command will list
+    the devices you can boot from. Note that it is not possible to boot from
+    the SD card reader.
+
+    Supported filesystems are `ext2', for Linux ext2 and ext3 filesystem
+    partition, and `iso9660' for CD-ROM.
+dnl Your particular PMON version might
+dnl also have some support for FAT-formatted USB keys using `fat' as the
+dnl filesystem type.
+
+    As an example, the /boot/vmlinux file on the first partition of the
+    hard disk becomes
+	/dev/fs/ext2@wd0/boot/vmlinux
diff --git a/distrib/notes/loongson/upgrade b/distrib/notes/loongson/upgrade
new file mode 100644
index 00000000000..a0d02197f82
--- /dev/null
+++ b/distrib/notes/loongson/upgrade
@@ -0,0 +1,2 @@
+dnl	$OpenBSD: upgrade,v 1.1 2010/02/03 17:10:44 miod Exp $
+OpenBSDUpgrade({:-your usual boot device-:})
diff --git a/distrib/notes/loongson/whatis b/distrib/notes/loongson/whatis
new file mode 100644
index 00000000000..90db52317a7
--- /dev/null
+++ b/distrib/notes/loongson/whatis
@@ -0,0 +1,5 @@
+dnl	$OpenBSD: whatis,v 1.1 2010/02/03 17:10:44 miod Exp $
+
+OpenBSD/MACHINE runs on the Lemote Yeeloong MIPS-based netbooks.
+dnl OpenBSD/MACHINE runs on various Loonson processor-based systems, such
+dnl as the popular Lemote Yeeloong and Gdium Liberty netbooks.
diff --git a/distrib/notes/loongson/xfer b/distrib/notes/loongson/xfer
new file mode 100644
index 00000000000..79512365fb0
--- /dev/null
+++ b/distrib/notes/loongson/xfer
@@ -0,0 +1,16 @@
+dnl	$OpenBSD: xfer,v 1.1 2010/02/03 17:10:44 miod Exp $
+Installation is supported from several media types, including:
+
+	CD-ROM
+	FFS partitions (for upgrades only)
+	DOS (FAT) partitions
+	EXT2 partitions
+	FTP
+	HTTP
+
+OpenBSDXferShortPrelude
+
+dnl usb tape drives anyone?
+dnl OpenBSDXferBareTape(xbase xetc xfont xserv xshare)
+dnl
+OpenBSDXferFFS