-----------------------------------------------------------------------
PAO for FreeBSD 2.2.8-RELEASE
Tatsumi Hosokawa <hosokawa@jp.FreeBSD.org>, Tokyo Japan
$Id: README,v 1.1.1.1.2.1.2.1.4.2.2.5 1999/04/05 12:06:49 toshi Exp $
-----------------------------------------------------------------------

This package contains the PC-card device drivers, the manager daemon,
and the maintainance utilities for FreeBSD 2.2.8-RELEASE.

-----------------------------------------------------------------------

If you have already installed PAO from PAO boot.flp, please read
UPGRADE-FROM-PAO-BOOTFLP file.

-----------------------------------------------------------------------
			      Attention

This package is alpha-test package.  If you use this package, please
report to <hosokawa@jp.FreeBSD.org> if possible, whether it works or
not, what environment you're using, what problem has happened, how to
avoid this probem, etc.  Patches are more welcome.  Please put "[PAO]"
on the head of the "Subject:" to pick it up easily.  If you can drive
new cards, please send me the patches and pccard.conf.  Thanks!
-----------------------------------------------------------------------

The URL of PAO homepage is,

     http://www.jp.FreeBSD.org/PAO/

If you want to know the "current" status of this package, please visit
here.

-----------------------------------------------------------------------

    *Note* If you want to install PAO package on a new laptop machine,
    or if you want to upgrade FreeBSD on your laptop machine, you can
    use PAO boot.flp to install FreeBSD and PAO package.  Installing
    PAO package by using PAO boot.flp is very easier compared to the
    way I described below.  Please read PAO webpage
    (http://www.jp.FreeBSD.org/PAO/) for details.

To install:

1. Extract this package into somewhere (we use /usr/src here)

	# cd /usr/src
	# tar xvfz "package directory"/PAO-19990405.tar.gz

2. Backup original /sys file if needed

	# cd /usr/src
	# mkdir sys.ORG
	# cd sys.ORG
	# (chdir ../sys ; tar cf - .) | tar xvf -

   or

	# cd /usr/src/PAO/release
	# make backup-sys

3. Apply kernel-patch to kernel source tree

	# cd /usr/src/sys
	# patch -p2 < PAO/release/sys-pao.diff

   or

	# cd /usr/src/PAO/release
	# make patch

4. Copy new include files to /usr/include

	# cd /usr/src/sys/i386/include
	# cp apm_bios.h if_cnwioctl.h clock.h cpu.h scc.h wavelan.h /usr/include/machine
	# cp /usr/src/sys/pccard/*.h /usr/include/pccard

   or

	# cd /usr/src/PAO/release
	# make install-include

5. Modify kernel config file for your environment

   /usr/src/sys/i386/conf/PAO_ALL is sample configuration file I'm
   using on Toshiba Libretto 50CT (/usr/src/sys/i386/conf/PAO is
   "small" config file that has commented out some devices that is
   separated from sys.patch. e.g. hss, scc, wfd, and wlp).

   * Don't remove "pseudo-device card 1" and "device pcic0" !

	# cd /usr/src/sys/i386/conf
	# cp PAO_ALL "your config file name"
	# vi "your config file name"

6. Compile your kernel

	# config "your config file name"
	# cd ../../compile/"your config file name"
	# make depend
	# make
	# make install

7. Compile the manager daemon and the utilities and install them (and
   replace apm(8) and shutdown(8) with new version)

	# cd /usr/src/PAO/usr.sbin
	# make
	# make install
	# cd /usr/src/PAO/sbin
	# make
	# make install

   or

	# cd /usr/src/PAO/release
	# make tools
	# make install-tools

8. Create device files for your pccard slots and APM BIOS

	# cd /dev
	# sh MAKEDEV card0
	# sh MAKEDEV card1
	# sh MAKEDEV card2
	# sh MAKEDEV card3
	# sh MAKEDEV apm

   or

	# cd /usr/src/PAO/release
	# make devices

9. Install PC-card configuration file and other /etc files.

	PAO/release/etc/pccard.conf.sample is sample config file
	currently I'm using on my laptops.

	# cp /usr/src/PAO/release/etc/pccard.conf.sample /etc/pccard.conf
	# cd /etc
	# mv rc.conf rc.conf.orig
	# cp /usr/src/PAO/release/etc/rc.conf /etc
	# cp /usr/src/PAO/release/etc/rc.pccard /etc
	# cp /usr/src/PAO/release/etc/pccard_ether /etc
	# cp /usr/src/PAO/release/etc/pccard_ether_remove /etc

	or 

	# cd /usr/src/PAO/release/etc
	# make install

10. Edit /etc/rc.conf (Please read FAQ)

	# vi /etc/rc.conf

Thanks to:

Andrew McRae <amcrae@cisco.com> (for the original pccard package)
Nate Williams <nate@sri.MT.net>
Atsuo Ohki <ohki@gssm.otsuka.tsukuba.ac.jp>
Gardner Buchanan <gbuchanan@shl.com> (for sn driver)
Jim Binkley <jrb@cs.pdx.edu> (for wlp driver)
Takeshi OHASHI <ohashi@mickey.ai.kyutech.ac.jp> (for scc driver)
Yoshihisa NAKAGAWA <y-nakaga@ccs.mt.nec.co.jp> (for scc driver)
NetBSD/pc98 porting staff (for ncv/stg drivers)
Koichi Matsuda (for ncv/stg drivers)
Naofumi Honda (for ncv/stg drivers)
Members of BSD-nomads Mailing List
	Especially,
	Naoki Hamada <nao@tom-yam.or.jp> (for ep driver)
	Hidetoshi Kimura <h-kimura@tokyo.se.fujitsu.co.jp> (for aic driver)
	T. Matsutsuka <matsu@cs.titech.ac.jp> (for spc driver)
	Hidetoshi Kimura <h-kimura@tokyo.se.fujitsu.co.jp> (for fe driver)
	DOTEGUCHI Masahiro <xdote@rp.open.cs.fujitsu.co.jp> (for pccard daemon)
	Akihiro Hirano <hirano@dsp.cl.nec.co.jp>
	Kunikazu Yoda <yoda@ais.kudpc.kyoto-u.ac.jp>
	Toshihisa Eto <eto@ai.cs.fujitsu.co.jp>
	Hajimu UMEMOTO <ume@iabs.hitachi.co.jp>
	KUROSAWA Takahiro <kurosawa@sail.t.u-tokyo.ac.jp>
	ODA, Kazutoshi <okaz@yggdrasil.forus.or.jp>
	Atsushi Furuta <furuta@sra.co.jp> (for ncv/stg drivers)
	Jun-ichirou Ito <itojun@itojun.org> (ep multicasting etc.)
	Paul Borman (BSDI) (cnw driver)
	Kenjiro Cho <kjc@csl.sony.co.jp> (cnw driver)

And many alpha-testers....

Tatsumi Hosokawa