mwrite(1) General Commands Manual 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...] sdosdirectory]
FLAGS
Preserves the file modification time. Specifies that a warning is not
issued when an existing file is specified as the target file. If this
flag is not specified, the mwrite command verifies whether or not to
overwrite an existing file. Specifies a text file transfer. Line ter-
minators are converted to the appropriate format. Specifies verbose
mode. Displays the new filename if the UNIX file name requires conver-
sion.
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 filename. If an invalid name is specified, the
mwrite command changes the name, then displays the new name if the -v
flag is specified.
DOS subdirectory names that contain the '/' or '\' separator are sup-
ported. If you use the '\' separator or wildcards, you must enclose
filenames 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 filenames are supported in the DOS world. The mwrite com-
mand may have to change UNIX names to fit the DOS filename conventions.
The following table shows some examples of filename conversions:
tab(@); lfHB lfHB lfHB l l l. _
UNIX name@DOS name@Reason for the change
_
_@_@_ thisisatest@THISISAT@filename too long
[email protected]@exten-
sion too long
[email protected]@PRN is a device name hot+cold@HOTX-
COLD@illegal character
_
ENVIRONMENT VARIABLES
The following environment variables affect the execution of mwrite: 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.
EXIT VALUES
The following exit values are returned: Success Failure
FILES
Contains the name of the current mtools working directory as estab-
lished by the mcd command. If this file does not exist, the default
mtools working directory is A:\. Executable file
RELATED INFORMATION
Commands: mcd(1), mcopy(1), mkmanifest(1), mread(1), mtools(1)
delim off
mwrite(1)