mren(1) General Commands Manual mren(1)
NAME
mren - mtools utility to rename an existing DOS file
SYNOPSIS
mren [-v] sourcefile targetfile
FLAGS
Specifies verbose mode. The new filename is displayed if the name sup-
plied is invalid.
DESCRIPTION
The mren command renames an existing file on a DOS filesystem. You can
also use the mren command to rename directories. Reasonable care is
taken to create a valid DOS filename. If an invalid DOS targetname is
specified, the mren command changes the name and, if the -v flag is
specified, prompts the user to accept or reject the new name.
The path component of the targetfile argument, if supplied, is ignored.
That is, you cannot use the mren command to move a file from one subdi-
rectory to another.
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 mren 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 mren: 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.
RESTRICTIONS
You cannot use the mren command to move a file from one subdirectory to
another.
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), mtools(1)
delim off
mren(1)