Command: vmsmount
VMSMOUNT is a DOS redirector for mounting VMware's shared folders.
Syntax:
VMSMOUNT [/H][/V|/Q|/QQ] [/L:<drv>] [/B:<siz[K]>] [/LFN [/M:<n>]
[/CI|/CS]]
VMSMOUNT [/V|/Q|/QQ] /U
Options:
/H Prints help message and exits.
/V Verbose: Prints information on system resources.
/Q Quiet: Omits copyright message.
/QQ Silent: Does not print any messages at all.
/L:<drive letter>
Drive letter to assign (if omitted, use first available).
/B:<size[K]>
Size of read/write buffer. (4K default, higher values increase
performance).
/LFN Long File Name support. "Mangles" long file names (or those
with illegal or unconvertibe characters) to valid 8.3 names,
using a hash algorithm. For example, "This is a long file.
name" will translate into "THIS˜2BF.NAM"
/M:<n> Number of mangling chars for short names (2 minimum,
6 maximum, 3 default). For example, the same "This is a long
file.name" will translate into "THISI˜02.NAM" if /M:2
or "TH˜0BAC0.NAM" if /M:5. The default suits most use
cases. Increase if the host file system has many files with
similar long names.
/CI Host file system is case insensitive, so "example.txt" and
"ExaMPLe.Txt" are the same. This is the default behaviour.
/CS Host file system is case sensitive (non-Windows hosts).
Mangles file names whith lower case chars. For example,
"EXAMPLE.TXT" will be left unchanged, but "Example.txt" will
be translated into "EXAM˜4F0.TXT".
/U Uninstall
/D Dump contents of internal stack (if compiled with debug
support)
ENVIRONMENT:
TZ Valid POSIX timezone. If omitted, file times will be in UTC
(see http://www.gnu.org/s/hello/manual/libc/TZ-Variable.html)
Example: TZ=CET-1CEST-2,M3.5.0/02:00:00,M10.5.0/03:00:00
LANG Used by the Kitten library to show messages in the correct
language. Currently only available in English, Spanish and
Dutch.
NLSPATH Used by the Kitten library to find the message catalogs
(VMSMOUNT.EN, VMSMOUNT.ES, VMSMOUNT.NL, ...)
PATH VMSMOUNT searchs in the PATH for the unicode conversion tables.
Comments:
PLEASE NOTE THAT VMWARE IS NO OPEN SOURCE SOFTWARE!
VMSMOUNT only works on VMWARE virtual machines, not on others!
For more information see:
https://gitlab.com/FreeDOS/net/vmsmount/-/tree/master/NET/VMSMOUNT?
ref_type=heads OR:
https://github.com/eduardocasino/vmsmount/tree/main
VMSMOUNT has the following RETURN CODES (ERRORLEVELS)
If loaded successfully, VMSMOUNT returns the number of the assigned
drive letter starting with 1 ( A == 1, B == 2, C == 3, ... )
If not loaded, errorlevel is set according to the following table:
ERRORLEVEL Meaning
0 Not loaded (help screen requested) or successfully
uninstalled
245 Unable to uninstall
246 Driver not installed and tried to uninstall
247 Invalid buffer size
248 Invalid command line option(s)
249 Unsupported DOS version
250 Not running in a virtual machine
251 Shared folders not enabled
252 Redirector not allowed to install
253 Already installed
254 Invalid drive letter
255 Other system error
Examples:
FREEDOS runs in a VMWARE virtual machine (not Virtualbox, Qemu or
others). VMSMOUNT can connect your virtual FREEDOS machine with your
real system (e.g. Windows, Linux, Mac).
A FREEDOS installation on VMWARE is a little tricky, here a short
description for Windows, but other OSes should work close to this:
a: Download VMWare Workstation Player and install it. Start vmware.
b: Create a new virtual machine using "Installer disc image file(ISO)",
choose "Guest operating System - Other - MS-DOS", then the
Virtual machine name and your location. Then finish the basic
settings.
c: Start FreeDOS installation. With a mouse click into the vm-window
you come into the vmware window, with CTRL-ALT you come out again
(do not forget!!!). After first installation vmware boots up and
shows "55AA" on the screen. Reason: FREEDOS runs only FDISK at
the first installation.
d: To FORMAT the virtual HD and install FREEDOS on the HD the CD has
to be rebooted a SECOND time.
e: For FreeDOS versions prior to 1.4:
This is prevented by Vmware as it removes the installation CD and
boots so fast that you have no chance to press "F2" to enter the
BIOS. To fix this, first go to your home directory (C:\Users\user-
name\Documents\Virtual Machines\FREEDOS machine name\FREEDOS-
machine name.vmx). Edit this file and add the following line:
bios.bootdelay = "5000" (this can be removed later).
With this setting you can boot, click with the mouse in the vm
window and press "F2" to enter the BIOS of the virtual machine,
where you can first change the boot sequence (start from CD = ISO
file). Then restart and run the installation from the ISO CD a
second time and finish the FreeDOS installation.
f: FreeDOS versions starting with 1.4:
The second reboot and the installation should work fine with ver-
sion 1.4. Please do not forget that you have to type CTRL-ALT to
come out of the window and to click into the vmware window to make
it active!
g: VMSMOUNT is in FreeDOS at C:\NET\VMSMOUNT and can be executed from
there.
In case that it is not yet there (and you have internet connection)
run "fdnpkg search vmsmount" and then "fdnpkg install vmsmount"
As alternative you can use the FREEDOS ISO file and run "fdimples"
and install it this way. In case it should run permanently do not
forget to modify FDAUTO.BAT (add C:\NET\VMSMOUNT\vmsmount /V /LFN
there).
h: On your host, create a folder e.g. "SHARE" anywhere at C: (or e.g.
at C:\users\user name\Documents\Virtual Machines\FREEDOS machine
name\SHARE".)
h: Switch off vmware, start the program and modify the settings for
your vm. Go to "Edit virtual machine settings", then go to "Options"
"Shared Folders" "Always enabled" and add a new "Shared Folder".
(Host path see g:) Host name should appear automatically. Save
this settings. Since vmsmount 0.6 the changes can be done while
the player is running via main window - Player - Manage - virtual
machine settings - Options - Shared Folders. It is also possible
to create several shared folders.
j: If everything went right, you should have an additional drive letter
at FREEDOS (e.g. E:\) which should share the files inside with the
SHARE folder created (at g:). (copy a file there and you should be
able to see and use it on both OSes).
k: Since version 0.6, VMSMOUNT supports code page changes with CHCP if
the optional VMCHCPD.SYS driver and NLSFUNC are installed, see:
https://github.com/eduardocasino/vmsmount/blob/main/readme.txt
See also:
autoexec.bat/fdauto.bat
chcp
environment variables:
errorlevel/exitcode
fdisk
format
Networking FreeDOS
nlsfunc
Copyright © 2011-2022 Eduardo Casino-Almao, help version 2023
W. Spiegl.
This file is derived from the FreeDOS Spec Command HOWTO.
See the file H2Cpying for copying conditions.