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.