mren(1)mren(1)NAMEmren - mtools utility to rename an existing DOS file
SYNOPSISmren [-v] sourcefile targetfile
OPTIONS
Specifies verbose mode. The new file name is displayed if the name
supplied is invalid.
DESCRIPTION
The mren command renames an existing file on a DOS file system. You
can also use the mren command to rename directories. Reasonable care
is taken to create a valid DOS file name. If an invalid DOS targetname
is specified, the mren command changes the name and, if the -v option
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
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 mren com‐
mand may have to change UNIX names to fit the DOS file name conven‐
tions. The following table shows some examples of file name conver‐
sions:
───────────────────────────────────────────────
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
───────────────────────────────────────────────
RESTRICTIONS
You cannot use the mren command to move a file from one subdirectory to
another.
EXIT STATUS
The following exit values are returned: Success. Failure.
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.
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
SEE ALSO
Commands: mcd(1), mtools(1)mren(1)