head	1.2;
access;
symbols
	V1_6_7:1.2
	V1_6_6:1.2
	V1_6_5:1.2
	V1_6_4:1.2
	V1_6_3:1.2
	V1_6_2:1.2
	V1_6_1:1.2
	V1_6:1.2
	V1_5_2:1.2
	V1_4_1:1.2
	V1_4:1.1
	V1_3_3:1.1;
locks; strict;
comment	@# @;


1.2
date	95.10.06.06.09.27;	author vandys;	state Exp;
branches;
next	1.1;

1.1
date	94.10.05.20.25.49;	author vandys;	state Exp;
branches;
next	;


desc
@Initial RCS checkin of Mike Larson's CDFS
@


1.2
log
@1.4.1 SCSI update
@
text
@
		README for VSTa CDROM Filesystem


Welcome to the CDROM Filesystem for VSTa.

This file contains a short description of the VSTa CDROM filesystem,
instructions for configuring the server, and a list of associated source
files.

Bits and pieces of the CDROM filesystem server were taken from the
following sources: the VSTa wd server and the FreeBSD isofs filesystem
(in particular, iso.h and isofs_rr.h).  In addition, "INSIDE THE ISO-9660
FILESYSTEM FORMAT" (DDJ 12/92) by William Frederick Jolitz and Lynne Greer
Jolitz and the Linux isofs filesystem sources were used as references.  The
rest of the server was written from scratch by Mike Larson (larz@@world.std.com).
The following notice applies to all files in this distribution written by the
author:


    Copyright (C) 1993-1995  Michael A. Larson

    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 1, or (at your option)
    any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software
    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.


Revision History
----------------

VSTa 1.4.1

	Add support for the following Rock Ridge extensions:
	long filenames and Posix attributes.

VSTa 1.3.2

	Initial revision.


CDROM Filesystem Introduction
-----------------------------

The VSTa CDROM Filesystem (CDFS) currently conforms to a subset of
the ISO 9660 standard (see the TODO list below for omissions).

CDFS reads blocks from a device server that supports CDROM devices
(eg, the SCSI/CAM server).

CDFS is started as follows. This can be done from the command line
(assuming the user has sufficient privileges) or from the boot.lst
file. If CDFS is started from the command line, it should be run
in the background.

	cdfs -p device_server:device_name fs/cdfs

For example, assuming that the device server is SCSI/CAM and the
device name is "sr2":

	cdfs -p cam:sr2 fs/cdfs

To actually mount a filesystem, use the following command:

	mount fs/cdfs directory_name

or from etc/fstab:

	fs/cdfs directory_name

"directory_name" is the name of an empty directory (eg., /cdfs).


Source File Description
-----------------------

block.c			- block read/write functions. Adapted from
			  dos/block.c.
cdfs.h			- CDFS specific definitions + some things not
			  in "iso.h".
cdfsdir.c		- directory operations.
cdfserro.c		- print/log CDFS error messages.
cdfsmount.c		- read in the CDROM FS primary descriptor.
cdfsopen.c		- open file processing.
cdfsread.c		- file read operations.
cdfsrrip.c		- CDFS Rock Ridge support.
cdfstime.c		- time conversion functions.
iso.h			- ISO 9660 definitions.
isofs_rr.h		- Rock Ridge definitions.
highsier.h		- High Sierra definitions.
main.c			- main message processing loop + misc. utilities.


TODO
----

Finish support for Rock Ridge extensions.

@


1.1
log
@Initial revision
@
text
@d21 1
a21 1
    Copyright (C) 1993,1994  Michael A. Larson
d41 5
d68 1
a68 1
device name is "sd2":
d70 1
a70 1
	cdfs -p cam:sd2 fs/cdfs
d95 1
d106 1
a106 1
Rock Ridge formatted CDROM's.
@
