`Dosfsys`

DOS filesystem manager

Dosfsys has been deprecated. Use the Fatfsys utility instead, which offers full support for FAT32, long filenames, and more.

Syntax:

Dosfsys [-S|-s] [-eLmt] [-T timeout]
        [dos_drive=qnx_drive[,R]]... &

Dosfsys -i [-n node] [dos_drive_path]... 

Dosfsys -o [-n node]

Dosfsys -x [-n node]

Options:

-e: Set the execute bits for user, group, and other for all DOS files.
-i: Get drive information from the Dosfsys manager on the specified node. If no node number is specified, the local Dosfsys manager is queried.
-L: Allow Windows 95 long filenames to be read.
-m: Suspend adoption of the indicated drives; display only the drives that would be adopted.
-n node: The node the Dosfsys manager resides on.
-o: For each device, display the names of any files that are currently open.
-s: Scan the /dev directory for drives to adopt.
-S: Same as -s, except the drives are adopted as read-only.
-t: Translate and truncate QNX filenames.
-T timeout: Timeout for internal cache invalidation for removable media. (In seconds; default and minimum is 2 seconds).
-x: Cause the Dosfsys manager on the specified node to exit. If no node is specified, the local Dosfsys manager is used.
dos_drive: A DOS drive letter, ranging from a to z.
dos_drive_path: The full name of the adopted DOS drive (defaults: /dos/a for a drive, /dos/b for b drive, etc.)
qnx_drive[,R]: The name of the QNX drive or file to open (e.g. /dev/hd0t4). The drive or file can be local or it can reside on another node in the network. If the optional ,R is specified, the DOS drive will be mounted as a read-only drive.

Description:

The Dosfsys filesystem manager provides transparent access to DOS files and directories that reside on a DOS disk. Dosfsys can support up to eight drives.

The Dosfsys manager uses block-special files hosted by the Fsys or Blkfsys managers for its access to real devices. One of these managers and the appropriate driver(s) must be running before Dosfsys is started.

You can create files on DOS disks, read them, write to them, and delete them with QNX programs. You can also create, read, and delete directories on DOS disks with standard QNX utilities, such as mkdir, ls, and rmdir. Standard QNX utilities will work with DOS files, provided that the DOS file structure allows for the functionality required by the utility.

Your own programs will also be able to process DOS files just as they process QNX files, by using the standard I/O functions such as open(), read(), write(), close(), seek(), etc. When you read DOS directories, they'll be presented to you in QNX format.

The -i option lets you get information about the currently adopted DOS drives. The -o option lets you see the names of any files that are currently open. The -x option terminates the Dosfsys server -- no new open() requests will be accepted and the server will terminate once all active files (i.e. files that are still open) are closed.

If you don't specify -i, -o, or -x, Dosfsys will start up and try to adopt the specified drives.

To start or terminate the Dosfsys server, you must be logged in as the superuser (root).

Unless otherwise specified on the command line, Dosfsys will adopt up to eight drives. DOS primary partitions (/dev/hd0t1, /dev/hd0t4, /dev/hd0t6, ...) and extended partitions (/dev/hd0t1.1, /dev/hd0t1.2, ...) are mounted starting at drive C (/dos/c). Floppy drives are mounted as follows:

Raw floppy device	Dosfsys mount point
`/dev/fd0`	`/dos/a`
`/dev/fd1`	`/dos/b`

The Microsoft Windows 95 release has added support for long filenames that are not limited to the traditional DOS "cccccccc.xxx" filename convention. Dosfsys has support to handle existing Windows 95 files with "long" filenames when the -L option is specified. Dosfsys does not support creating files with long filenames -- the file must already exist.

Examples:

Scan the /dev directory and mount the corresponding drives:

    Dosfsys &

    Dosfsys -s &

The above forms are the norm for most environments.

Adopt drivea as /dos/a (read-only) and //8/disks/drivec as /dos/c:

    Dosfsys a=drivea,R c=//8/disks/drivec &

Adopt /dev/fd0 as /dos/a and /dev/hd0t4 as /dos/c:

    Dosfsys a=/dev/fd0 c=/dev/hd0t4  &

Files:

Dosfsys closes its standard input, standard output, and standard error after it completes its startup initializations.

Dosfsys adopts files in the pathname prefix tree of the node it is being run on. Usually these will appear under the directory /dos. See description for more detail.

Exit status:

If an error occurs at startup, Dosfsys displays an appropriate error message, then exits with one of the following exit codes:

1: Exit due to signal.
2: Can't register name.
3: Can't create proxy.
4: Can't register drive prefix.
5: Can't set up timer.
6: Invalid command-line option(s).
7: Error mounting drive.
8: Not enough memory for buffers.
9: Invalid drive specifier.
10: No drive specified on the command line.
11: Can't attach to file descriptor table.

Caveats:

Dosfsys will not work with media that has a sector size larger than 512 bytes.