mkmanifest(1) — Commands
NAME
mkmanifest − mtools utility to create a shell script to restore UNIX file names from DOS
SYNOPSIS
mkmanifest [files]
OPTIONS
None
OPERANDS
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 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 name | DOS name | Reason for the change |
| thisisatest | THISISAT | file name too long |
| file.stuff | FILE.STU | extension too long |
| prn.txt | XRN.TXT | PRN is a device name |
| .abc | X.ABC | null file name |
| hot+cold | HOTXCOLD | illegal character |
EXIT STATUS
The following exit values are returned:
0Success.
1Failure.
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
/usr/bin/mtools/mkmanifest
Executable file