Index Index for
Section 1
Index Alphabetical
listing for M
Bottom of page Bottom of
page		 

mwrite(1)


NAME

  mwrite - mtools utility to perform a low level write (copy) of a UNIX file
  to DOS


SYNOPSIS

  mwrite [-mntv] unixfile msdosfile

  mwrite [-mntv] unixfile [unixfiles...] [msdosdirectory]


OPTIONS

  -m  Preserves the file modification time.

  -n  Specifies that a warning is not issued when an existing file is
      specified as the target file.  If this option is not specified, the
      mwrite command verifies whether or not to overwrite an existing file.

  -t  Specifies a text file transfer.  Line terminators are converted to the
      appropriate format.

  -v  Specifies verbose mode.  Displays the new file name if the UNIX file
      name requires conversion.


DESCRIPTION

  The mwrite command copies the specified UNIX file to the named DOS file, or
  copies multiple UNIX files to the named DOS directory.  The destination
  directory cannot be omitted. Reasonable care is taken to create a valid DOS
  file name.  If an invalid name is specified, the mwrite command changes the
  name, then displays the new name if the -v option is specified.

  DOS subdirectory names that contain the '/' or '\' separator are supported.
  If you use the '\' separator or wildcards, you must enclose file names in
  quotes to protect them from the shell.

  The mcd command can be used to establish the device and the current working
  directory (relative to DOS), otherwise the default is A:\.

  Not all UNIX file names are supported in the DOS world.  The mwrite command
  may have to change UNIX names to fit the DOS file name conventions. 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.


ENVIRONMENT VARIABLES

  The following environment variables affect the execution of mwrite:

  MCWD
      If set, this variable names the file that contains the name of the
      current mtools working directory as established by the mcd command.  If
      this variable is not set, the file $HOME/.mcwd is used.


FILES

  $HOME/.mcwd
      Contains the name of the current mtools working directory as
      established by the mcd command.  If this file does not exist, the
      default mtools working directory is A:\.

  /usr/bin/mtools/mwrite
      Executable file


SEE ALSO

  Commands:  dos2unix(1) mcd(1), mcopy(1), mdiskcopy(1), mkmanifest(1),
  mread(1), mtools(1), unix2dos(1)

Index Index for
Section 1
Index Alphabetical
listing for M
Top of page Top of
page