NAME

mkmanifest − mtools utility to create a shell script to restore UNIX filenames from DOS

SYNOPSIS

mkmanifest [files]

FLAGS

None

PARAMETERS

filesA 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 filenames that were overwritten by DOS filename restrictions.  DOS filenames are uppercase only, cannot exceed 8 character names, 3 character extensions and, does not support device names or illegal characters. 

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

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 filenames to the following:

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

To restore the previous filenames, 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 filename 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 filenames again. 

EXIT VALUES

The following exit values are returned:

0Success

1Failure

FILES

/usr/bin/mtools/mkmanifest
Executable file

RELATED INFORMATION

Commands: mcopy(1), mtools(1)