mren(1) — Commands
NAME
mren − mtools utility to rename an existing DOS file
SYNOPSIS
mren [-v] sourcefile targetfile
FLAGS
-vSpecifies verbose mode. The new filename is displayed if the name supplied 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 subdirectory to another.
DOS subdirectory names that contain the ’/’ or ’\’ separator are supported. 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 command may have to change UNIX names to fit the DOS filename conventions. The following table shows some examples of filename conversions:
| UNIX name | DOS name | Reason for the change |
| _ | _ | _ |
| thisisatest | THISISAT | filename too long |
| file.stuff | FILE.STU | extension too long |
| prn.txt | XRN.TXT | PRN is a device name |
| .abc | X.ABC | null filename |
| hot+cold | HOTXCOLD | illegal character |
ENVIRONMENT VARIABLES
The following environment variables affect the execution of mren:
MCWDIf 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:
0Success
1Failure
FILES
$HOME/.mcwdContains 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/mrenExecutable file