-----------------------------------------------------------------------
PAO-970603 for FreeBSD 2.2.2-RELEASE
Tatsumi Hosokawa <hosokawa@jp.FreeBSD.org>, Tokyo Japan
-----------------------------------------------------------------------

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

-----------------------------------------------------------------------
			      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 has been moved to,

     http://Makefile.ORG/FreeBSD/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 at /usr/src

	# cd /usr/src
	# tar xvfz "package directory"/PAO-970603.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-970603/2.2.2-RELEASE
	# make backup-sys

3. Apply kernel-patch to kernel source tree

	# cd /usr/src
	# patch -p0 < PAO-970603/2.2.2-RELEASE/sys.patch

   or

	# make patch

4. Copy new include files to /usr/include

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

   or

	# make install-include

5. Modify kernel config file for your environment

   /usr/src/sys/i386/conf/PAO is sample configuration file I'm using
   on Toshiba Libretto 30.

   * Don't remove "controller crd0" and "device pcic0" !

	# cd /usr/src/sys/i386/conf
	# cp PAO "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-970603/usr.sbin
	# make
	# make install
	# cd /usr/src/PAO-970603/sbin
	# make
	# make install

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-970603/2.2.2-RELEASE
	# make devices

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

	PAO-970603/2.2.2-RELEASE/etc/pccard.conf.sample is sample
	config file currently I'm using on my laptops.

	# cp /usr/src/PAO-970603/2.2.2-RELEASE/etc/pccard.conf.sample /etc/pccard.conf
	# cd /etc
	# mv rc.conf rc.conf.orig
	# cp /usr/src/PAO-970603/2.2.2-RELEASE/etc/rc.conf /etc
	# cp /usr/src/PAO-970603/2.2.2-RELEASE/etc/rc.pccard /etc
	# cp /usr/src/PAO-970603/2.2.2-RELEASE/etc/pccard_ether /etc
	# cp /usr/src/PAO-970603/2.2.2-RELEASE/etc/pccard_ether_remove /etc

	or 

	# cd /usr/src/PAO-970603/2.2.2-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.)

And many alpha-testers....

Tatsumi Hosokawa
