 Sample Code Disclaimer

 Copyright  2001 Palm, Inc. or its subsidiaries.  All
 rights reserved.

 You may incorporate this sample code (the "Code") into your applications
 for Palm OS(R) platform products and may use the Code to develop
 such applications without restriction.  The Code is provided to you on
 an "AS IS" basis and the responsibility for its operation is 100% yours.
 PALM, INC. AND ITS SUBSIDIARIES (COLLECTIVELY, "PALM") DISCLAIM
 ALL WARRANTIES, TERMS AND CONDITIONS WITH RESPECT TO THE CODE, EXPRESS,
 IMPLIED, STATUTORY OR OTHERWISE, INCLUDING WARRANTIES, TERMS OR
 CONDITIONS OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE,
 NONINFRINGEMENT AND SATISFACTORY QUALITY.  You are not permitted to
 redistribute the Code on a stand-alone basis and you may only
 redistribute the Code in object code form as incorporated into your
 applications.  TO THE FULL EXTENT ALLOWED BY LAW, PALM ALSO EXCLUDES ANY
 LIABILITY, WHETHER BASED IN CONTRACT OR TORT (INCLUDING NEGLIGENCE), FOR
 INCIDENTAL, CONSEQUENTIAL, INDIRECT, SPECIAL OR PUNITIVE DAMAGES OF ANY
 KIND, OR FOR LOSS OF REVENUE OR PROFITS, LOSS OF BUSINESS, LOSS OF
 INFORMATION OR DATA, OR OTHER FINANCIAL LOSS ARISING OUT OF OR IN
 CONNECTION WITH THE USE OR PERFORMANCE OF THE CODE.  The Code is subject
 to Restricted Rights for U.S. government users and export regulations.
 
 SAMPLE NAME:		HostFS

 FILES:				HostFSDispatch.c, HostFS.c

 DATE:				6/25/2001

 DESCRIPTION:		Source Code

 COMPILER:			Metrowerks CodeWarrior

HostFS is an implementation of a file system on Palm OS that works in
conjunction with the Emulator's "Host Control API" to mount a local directory on
the desktop as a volume/card in Palm OS. Requires a ROM with expansion manager,
which includes all 4.0 ROM images labeled "full".

This sample code is provided to assist developers in understanding the
interfaces necessary to implement a file system library to work in conjunction
with Palm OS Expansion Manager API's.

This sample code is provided as a Metrowerks CodeWarrior project compatible with
Windows. If you need to create the project from Palm OS stationery, perform the
following:

1. Create a CodeWarrior project using Palm OS Application Stationery.

2. Choose to create a C Application

2. Remove Starter.c from the project

3. Add HostFS.c to the project. Add HostFSDispatch.c to the project.

4. Download latest version of Emulator and copy latest version of HostControl.h
to the Incs/Core/System folder of the SDK.

5. Remove StarterCode.lib from project.

6. Remove pre-compiled headers from project

7. Change Project Type to Palm OS Code Resource

8. Set 68k Target->filename to HostFSLib.tmp

9. Set 68k Target->ResType to libr, ResID to 0

10. In C/C++ Language, disable RTTI.

11. In C/C++ Language, enable wchar_t Support.

12. Set Target Name to HostFSLib

13. In the Palm Rez Post Linker, set:

	Mac Resource Files:  HostFS.tmp
	Output File:         HostFS.prc
	Type:                libf
	Creator:             hstf   (You must register your own creator id for any
application)
	Database Name:       HostFS
	Set Reset Bit:       Yes
	Set Backup Bit:      Yes
	Sort Resources By Size:   Yes
	
