Content-type: text/html Man page of mkmanifest

mkmanifest

Section: User Commands (1)
Index Return to Main Contents
 

NAME

mkmanifest - mtools utility to create a shell script to restore UNIX file names from DOS  

SYNOPSIS

mkmanifest [files]


 

OPTIONS

None
 

OPERANDS

A list of UNIX file names to be converted to DOS name format.
 

DESCRIPTION

The mkmanifest command creates a shell script that aids in the restore of UNIX file names that were overwritten by DOS file name restrictions. DOS file names are uppercase only, cannot exceed 8 character names, 3 character extensions and, does not support device names or illegal characters.

Not all UNIX file names are supported in the DOS world. The mtools commands may have to change UNIX names to fit the DOS file name conventions. Most commands provide the verbose option (-v), that displays new file names if they have been changed. The following table shows some examples of file name conversions:


UNIX nameDOS nameReason for the change

thisisatestTHISISATfile name too long
file.stuffFILE.STUextension too long
prn.txtXRN.TXTPRN is a device name
.abcX.ABCnull file name
hot+coldHOTXCOLDillegal character


 

EXIT STATUS

The following exit values are returned: Success. Failure.
 

EXAMPLES

Assume you have the following UNIX files that you want to copy to a DOS diskette using the mcopy command.

very_long_name 2.many.dots illegal: good.c prn.dev Capital

The mcopy command converts these file names to the following:

very_lon 2xmany.dot illegalx good.c xprn.dev capital

To restore the previous file names, use the mkmanifest command as follows: mkmanifest very_long_name 2.many.dots illegal: \
                           good.c prn.dev Capital > manifest

The previous mkmanifest command line produces the following: mv very_lon very_long_name mv 2xmany.dot 2.many.dots mv illegalx illegal: mv xprn.dev prn.dev mv capital Capital

The good.c file name did not require conversion, hence it was not included in the output.

If these files were copied from diskette to another UNIX system, and you wanted to restore the original names, retain a copy of the manifest file (captured output) so that it can be used to convert the file names again.
 

FILES

Executable file
 

SEE ALSO

Commands: mcopy(1), mtools(1)


 

Index

NAME
SYNOPSIS
OPTIONS
OPERANDS
DESCRIPTION
EXIT STATUS
EXAMPLES
FILES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 02:42:44 GMT, October 02, 2010