Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Apropos / Subsearch:
optional field

mren(1)								      mren(1)


  mren - mtools	utility	to rename an existing DOS file


  mren [-v] sourcefile targetfile


  -v  Specifies	verbose	mode.  The new file name is displayed if the name
      supplied is invalid.


  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 speci-
  fied,	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 subdirec-
  tory to another.

  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 mren 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


  You cannot use the mren command to move a file from one subdirectory to


  The following	exit values are	returned:

  0   Success.

  1   Failure.


  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.


      Contains the name	of the current mtools working directory	as esta-
      blished by the mcd command.  If this file	does not exist,	the default
      mtools working directory is A:\.

      Executable file


  Commands: mcd(1), mtools(1)