add notes for for OpenBSD/palm still a bit rough, but it's a start

parts from and "seems ok" marex@

9 files changed, 215 insertions, 3 deletions

diff --git a/distrib/notes/Makefile b/distrib/notes/Makefile
index ff51e548243..62d928eb395 100644
--- a/distrib/notes/Makefile
+++ b/distrib/notes/Makefile
@@ -1,4 +1,4 @@
-#	$OpenBSD: Makefile,v 1.33 2009/05/12 21:06:48 miod Exp $
+#	$OpenBSD: Makefile,v 1.34 2009/10/02 07:26:15 jasper Exp $
 
 NOPROG=
 NOMAN=
@@ -19,8 +19,8 @@ all:	$(TARG)
 allarchs:
 	@cd $(.CURDIR); \
 	for arch in alpha amd64 armish aviion hp300 hppa i386 landisk \
-	    luna88k mac68k macppc mvme68k mvme88k sgi socppc sparc sparc64 \
-	    vax zaurus; \
+	    luna88k mac68k macppc mvme68k mvme88k palm sgi socppc sparc \
+	    sparc64 vax zaurus; \
 	do ${MAKE} M=$$arch; done
 
 $(TARG): $(DEP)
diff --git a/distrib/notes/palm/contents b/distrib/notes/palm/contents
new file mode 100644
index 00000000000..e5411675918
--- /dev/null
+++ b/distrib/notes/palm/contents
@@ -0,0 +1,34 @@
+dnl	$OpenBSD: contents,v 1.1 2009/10/02 07:26:15 jasper Exp $
+TopPart
+
+OpenBSDdistsets
+
+OpenBSDbsd
+
+OpenBSDrd
+dnl not yet...
+dnl Cocoboot
+
+DistributionDescription(eleven)
+
+OpenBSDbase(47742339,128402380)
+
+OpenBSDcomp(19899514,66786294)
+
+OpenBSDetc(516201,1376199)
+
+OpenBSDgame(2667467,5978240)
+
+OpenBSDman(8226904,30048572)
+
+OpenBSDmisc(2935447,9912406)
+
+dnl OpenBSDxbase(10844908,30932044)
+
+dnl OpenBSDxetc(76099,282509)
+
+dnl OpenBSDxfont(35584217,43728442)
+
+dnl OpenBSDxserv(5776670,15092362)
+
+dnl OpenBSDxshare(2766294,14738211)
diff --git a/distrib/notes/palm/features b/distrib/notes/palm/features
new file mode 100644
index 00000000000..76275f6a4f4
--- /dev/null
+++ b/distrib/notes/palm/features
@@ -0,0 +1,40 @@
+dnl	$OpenBSD: features,v 1.1 2009/10/02 07:26:15 jasper 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/palm/ramdisk/install.md
+dnl and the list files in
+dnl	src/distrib/palm/ramdisk/list
+dnl
+dnl ====
+dnl
+dnl architecture name (for the packages directory)
+define({:-MACHINE_ARCH-:},arm)dnl
+dnl
+dnl define if /sbin/kbd exists on the media
+define({:-MDKBD-:},)dnl
+dnl
+dnl define if serial consoles needs to be enabled in /etc/ttys
+dnl (i.e. md_consoleinfo is not empty)
+define({:-MDSERCONS-:},1)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/palm/hardware b/distrib/notes/palm/hardware
new file mode 100644
index 00000000000..4628e270b5f
--- /dev/null
+++ b/distrib/notes/palm/hardware
@@ -0,0 +1,10 @@
+dnl	$OpenBSD: hardware,v 1.1 2009/10/02 07:26:15 jasper Exp $
+The following Palm PDA models are supported by OpenBSD:
+
+	Tungsten T|5
+	Tungsten T|X
+	LifeDrive
+	Zire 72
+
+In addition to the on-board devices (keyboard, display panel, MMC/SD/SDIO
+GPIO, and serial ports), many USB devices are supported.
diff --git a/distrib/notes/palm/install b/distrib/notes/palm/install
new file mode 100644
index 00000000000..f5218f056e1
--- /dev/null
+++ b/distrib/notes/palm/install
@@ -0,0 +1,43 @@
+dnl     $OpenBSD: install,v 1.1 2009/10/02 07:26:15 jasper Exp $
+OpenBSDInstallPrelude
+
+An OpenBSD/palm installation will use the PalmOS to bootstrap itself.
+Although this has be done manually, upon each reboot.
+
+After the SD card and USB hub have been setup, reset the device, wait
+untill it's finished booting.
+
+Hit the reset button on the device, wait till it reboots, pop in the SD
+card with bootloader and kernel, run 'Cocoboot' and hit the 'Boot'
+button.
+
+OpenBSDInstallPart2
+
+OpenBSDInstallPart3(,"sd0")
+
+OpenBSDInstallPart4
+
+OpenBSDInstallMBRPart1
+
+OpenBSDInstallMBRPart2(indeed)
+
+OpenBSDInstallPart5
+
+OpenBSDInstallPart6({:-CD-ROM, -:})
+
+OpenBSDURLInstall
+
+OpenBSDCDROMInstall
+
+OpenBSDDISKInstall({:-"wdN" or -:},,{:-, Linux (ext2) or MS-DOS-:})
+
+OpenBSDCommonInstall
+
+OpenBSDInstallWrapup
+
+OpenBSDCongratulations
+
+        Please keep in mind that upon reseting the device the clock will
+        be resetted too. Even if you correctly set the time in PalmOS,
+        OpenBSD will not pick this up. So it is strongly advised to use
+        ntpd(1).
diff --git a/distrib/notes/palm/prep b/distrib/notes/palm/prep
new file mode 100644
index 00000000000..38a12b9f3d3
--- /dev/null
+++ b/distrib/notes/palm/prep
@@ -0,0 +1,63 @@
+dnl     $OpenBSD: prep,v 1.1 2009/10/02 07:26:15 jasper Exp $
+
+There are several things that need to be done in order to install
+OpenBSD/MACHINE .
+
+In case we'll be installing on the SD card driven by PXAMCI, We'll need
+like 8 Mb FAT16 formated partition at the begining of the card, that'll
+be for the bootloader running for PalmOS and will contain also the
+kernel binary. We can create this partition by for example running
+fdisk(8).  Once we have the partition ready, we have to create a
+filesystem on it. Achieve that by running:
+
+        $ newfs_msdos <device>
+
+where '<device>' is the new partition we just created. Now mount the
+partition and create directories '/PALM' and '/PALM/Launcher'. Once
+done, copy the bootloader binary called 'cocoboot.prc' into
+'/PALM/Launcher' and the kernel binary with RAMDISK into '/zImage'. The
+'cocoboot.prc' file can be obtained by downloading the file like so:
+
+        $ ftp http://marex.hackndev.com/OpenBSD/cocoboot.prc
+
+This step is needed as cocoboot cannot be distributed with OpenBSD since
+it's licensed under the GPL.
+Of course, you can operate with 'cocoboot.conf' and make the bootloader
+pick a proper kernel name, but that's up to users comfort and beyond the
+scrope of this document. You need to be sure to copy the kernel with
+RAMDISK, otherwise the installer won't be there and you won't be able to
+install, but instead you'll end with kernel debugger shell complaining
+there is no boot device.
+
+Now we need to setup the USB part. Many Palm models don't support USB
+host by default, but it's mainly a software limitation of PalmOS. The
+only problem with USB is that the device doesn't supply the VBUS.
+Therefore you'll need a USB A to A converted and a powered USB hub. Now,
+connect the power supply to the hub, connect the cable that normally
+goes between the PC and the hub into one side of the A to A converter
+and the USB data cable for Palm to the other side of the A to A
+converter. So the port of the USB hub that normally is connected to a
+USB host is now connected to Palm's USB port. Here's a simple
+schematics:
+
+.------.
+| Palm |]-------=[ A to A converter ]=--------------=[ USB hub ]
+'------'
+
+Now that everything's ready, plug the USB cable into Palm if you haven't
+done so yet.
+
+When booting OpenBSD on at least the Tungsten T|5 model, make sure the
+following items are taken care of, or the internal uhub(4) will be
+disabled.
+
+        - Boot OpenBSD directly after resetting the device, before it
+          goes to sleep mode.
+        - Always reset the device before booting OpenBSD.
+        - If the power adapter is plugged into the UART cable, booting
+          may also fail. Best way to work around this is to boot OpenBSD
+          with the power cable removed, and plug the cable back in once
+          OpenBSD has been booted.
+
+Failing to comply with the above items may result not being able to use
+the keyboard, network interfaces, etc.
diff --git a/distrib/notes/palm/upgrade b/distrib/notes/palm/upgrade
new file mode 100644
index 00000000000..6458e51251a
--- /dev/null
+++ b/distrib/notes/palm/upgrade
@@ -0,0 +1,2 @@
+dnl	$OpenBSD: upgrade,v 1.1 2009/10/02 07:26:15 jasper Exp $
+OpenBSDUpgrade({:-your usual boot device-:})
diff --git a/distrib/notes/palm/whatis b/distrib/notes/palm/whatis
new file mode 100644
index 00000000000..bc3bc9e46d1
--- /dev/null
+++ b/distrib/notes/palm/whatis
@@ -0,0 +1,5 @@
+dnl	$OpenBSD: whatis,v 1.1 2009/10/02 07:26:15 jasper Exp $
+
+OpenBSD/MACHINE runs on PDAs made by Palm with an ARM PXA2xx processor.
+Currently models supported include the Tungsten T|5, T|X, LifeDrive and
+the Zire 72.
diff --git a/distrib/notes/palm/xfer b/distrib/notes/palm/xfer
new file mode 100644
index 00000000000..598b78e79b3
--- /dev/null
+++ b/distrib/notes/palm/xfer
@@ -0,0 +1,15 @@
+dnl	$OpenBSD: xfer,v 1.1 2009/10/02 07:26:15 jasper Exp $
+Installation is supported from several media types, including:
+
+	CD-ROM
+	DOS (FAT) partitions
+	FFS partitions (for upgrades only)
+	Remote NFS partition
+	FTP
+	HTTP
+
+OpenBSDXferShortPrelude
+
+OpenBSDXferNFS
+
+OpenBSDXferFFS