File System

The AMX/FS^TM File System is a full-featured, high performance, MS-DOS^® compatible file system. Designed for use with AMX^TM and KwikNet^® in real-time embedded applications, AMX/FS allows multiple tasks to manipulate files concurrently.

The AMX/FS File System is available for many different target processors. For each processor family, KADAK supports software development toolsets from one or more of the industry's best known tool vendors. Each AMX/FS implementation is exercised by KADAK on hardware platforms which can support a RAM drive and for which the prerequisite AMX board support is available.

Introduction to AMX/FS

The AMX/FS File System is provided as a library of C procedures which permit multiple tasks to concurrently manipulate files.

The file system can be easily configured to meet your particular disk requirements using the AMX Configuration Builder. Simple commands instruct the Builder to create a File System Configuration Module which defines the logical disk drives and selects the RAM disk, PC BIOS, floppy or IDE device drivers in various combinations. No AMX/FS library reconstruction or creation is necessary.

AMX/FS Drivers

A RAM disk device driver is included. For embedded PC applications with AMX 86, a device driver which uses the standard PC BIOS floppy and hard disk services is also provided.

Optional floppy and IDE disk device drivers, ready for use with PC compatible hardware interfaces, can be readily ported to meet your device requirements.

Alternatively, you can easily adapt the RAM disk driver or the shell driver provided with AMX/FS to create your own custom device driver.

AMX/FS File Services

The AMX/FS library provides a wide range of file services from which to choose. Many of the services are optional and, if not used, will not even be present in your final system. The following lists summarize all of the AMX/FS procedures which are accessible to the user.
 

File System Control Services

	fjfserrfn		Install a task Error Handler
	fjfserrno		Fetch AMX/FS error code
	fjfsfatal		AMX/FS fatal trap
	fjfsfault		AMX/FS fault trap
	fjfsperror		Record (log) an AMX/FS error
	fjfssignin		Register to use AMX/FS
	fjfssignout		Renounce use of AMX/FS

Drive Access Services

	fjdrvabort		Abort all operations on a drive
	fjdrvclose		Close (unmount) a disk drive
	fjdrvget		Fetch task's current drive number
	fjdrvgetcwd		Fetch task's current working directory
	fjdrvnfree		Determine free space on a drive
	fjdrvopen		Open (mount) a disk drive
	fjdrvparse		Parse a drive name
	fjdrvset		Set task's default drive

Directory Access Services

	fjchdir		Change current working directory
	fjmkdir		Make a directory
	fjrmdir		Remove (delete) a directory

File Access Services

	fjchsize		Change size of (grow or shrink) a file
	fjclose		Close a file
	fjeof		Test if file pointer is at end of file
	fjfattr		Get or set file attributes
	fjffdone		Finished a file find search
	fjfffirst		Find first occurrence of a matching file
	fjffnext		Find next occurrence of a matching file
	fjflush		Flush a file to disk
	fjfstat		Fetch status of an open file
	fjlseek		Move current file pointer
	fjopen		Open a file
	fjread		Read from a file
	fjremove		Remove a file (synonym for fjunlink)
	fjrename		Rename a file or directory
	fjstat		Fetch status of a named file
	fjtell		Fetch current file pointer
	fjunlink		Unlink (delete) a file
	fjwrite		Write to a file

Format Services

	fjfmtfloppy		Format a floppy diskette
	fjfmtram		Format (initialize) a preconfigured RAM Disk
	fjfmtxram		Create and format (initialize) a RAM Disk

Miscellaneous Services

	fjisdir		Check if path is a directory
	fjisvol		Check if path is a volume (drive)
	fjmkfs		Make a file system on a drive
	fjmkpath		Concatenate a pathname and filename

String Format Services

	fj_itoa		Format an int as a string
	fj_ltoa		Format a long as a string
	fj_sprintf		Format a string
	fj_stoa		Format a short int as a string
	fj_strjust		Copy and justify a string

Additional Materials

You can also download the complete AMX/FS Reference Manual. The AMX/FS User's Guide describes how to use the AMX/FS File System an incorporate it into your AMX application. The AMX/FS Tool Guide describes how AMX/FS is used with each of the software development toolsets supported by KADAK.