unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



mkmanifest(1)							mkmanifest(1)



NAME

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

SYNOPSIS

  mkmanifest [files]

OPTIONS

  None

OPERANDS

  files
      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 do not	support	device names or	nonalphanumeric	characters.

  Not all UNIX file names are supported	in the DOS world.  The mtools com-
  mands	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:

  0   Success.

  1   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

  /usr/bin/mtools/mkmanifest
      Executable file

SEE ALSO

  Commands: mcopy(1), mtools(1)