
    This is a virtual floppy disk driver for Windows NT platform.
    Copyright (C) 2003 Kenji Kato

    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 2 of the License, 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., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

    The GNU General Public License is also available from:
    http://www.gnu.org/copyleft/gpl.html

    This program borrows a lot of code from Bo Brant's 'filedisk' program,
    especially where it concerns NT/2000/XP compatibility and ntifs.h stuff.
    'filedisk' program is available from http://www.acc.umu.se/~bosse/

FILES

    vfd.sys
	Virtual FD kernel-mode driver.

    vfd.exe
	Virtual FD control program (console version).

    vfdwin.exe
	Virtual FD control program (GUI version).

HISTORY
    16-04-2003  Initial Release
    27-04-2003  vfdwin.exe 1.01 -- Fixed a few bugs in user interface

INSTALLATION

    Just copy these three files into a directory on a local drive.

    !!! NOTE !!!
    Device drivers cannot be started from a network drive.  Make sure that
    at least the driver file (vfd.sys) is located on a local drive.

USAGE - VFD.EXE

	vfd.exe <command> [<options...>]

    You can use following commands with vfd.exe.

	vfd.exe install [<driver path>] [/AUTO]
		Install the device driver, i.e. create neccessary entries in the
	  	system registry to start the device driver.

		<driver path> is the path of the device driver file.
		When it is omitted, "vfd.sys" in the same directory as vfd.exe is
		assumed.  Make sure that <driver path> points to a local drive.

		/AUTO switch installs the driver in auto-start mode, i.e. the
		driver starts automatically during the system start up.
		This switch does *NOT* cause the driver to start automatically
		after the installation.
		When /AUTO is not specified, the driver must be started manually
		either with vfd.exe or vfdmount.exe.

		Installation will fail if the driver is already installed.
		If you want to change the driver path or the start mode, uninstall
		it and then re-install it with different options.

		!!! NOTE !!!
		Administrative privilege is required to install a device driver
		on a Windows NT platform.
 
	vfd.exe remove
		Uninstall the device driver, i.e. delete registry entries created
		during the driver installation.
	  	This does *not* delete the driver file itself.

		If the driver is running, this command attempts to stop it before
		uninstalling it.

		!!! NOTE !!!
		Administrative privilege is required to uninstall a device driver
		on a Windows NT platform.
 
	vfd.exe start
		Start the device driver.
		If the driver is not installed, this command attempts to install it
		with default settings (which is equivalent to "vfd.exe install"
		without an option).

		This command will fail if the driver is already running.

		!!! NOTE !!!
		At least Power User privilege is required to start a device driver
		on a Windows NT platform.  If you are goint to use Virtual FD as
		regular users, make sure to install the driver with "/auto" option
		so that you don't have to manually start the driver.

	vfd.exe stop
		Stop the device driver.
		If an image is mounted to the Virtual FD drive, this command attempts
                to unmount it before stopping the driver.

		!!! NOTE !!!
		At least Power User privilege is required to stop a device driver
		on a Windows NT platform.

	vfd.exe mount [<image file>] [/L:drive] [ /RO | /720 | /144 | /288 ]
		Mount an existing image file as a virtual floppy disk,
		or create a new (unformatted) file and mount it.

		<image file> is a path to the image file to mount.
		If the file exists, the file size must be one of the following:
		    737,280 bytes ( 720KB)
		  1,474,560 bytes (1.44MB)
		  2,949,120 bytes (2.88MB)

		If the existing file has read-only attribute, the image is mounted
		as a write-protected media.

		If the file does not exist, a new file with specified path and size
		is created before mounted.

		If you do not specify <image file>, this command attempts to mount
		most recently mounted image file.

		/L: option specifies a drive letter to assign to the Virtual FD drive.
                Default is the first available letter.

		/RO switch mounts the image file as a write-protected media, even
		if the file does not have read-only attribute.
		You cannot specify this switch when creating a new image.

		/720, /144 and /288 switches specify the file size to create.
		You have to specify one of these when <image file> does not exist.
		When <image file> exists, these are simply ignored.

		If the driver is not running, this command attempts to start it.

	vfd.exe umount
		Unmount currently mounted image file.

		If any program is using the Virtual FD drive, unmount operatoin
		may fail.

	vfd.exe stat
		Query current configuration and status of the Virtual FD driver.

        vfd.exe help [command]
                Shows vfd.exe command line help.

