summaryrefslogtreecommitdiff
path: root/open-vm-tools/README
diff options
context:
space:
mode:
Diffstat (limited to 'open-vm-tools/README')
-rw-r--r--open-vm-tools/README263
1 files changed, 126 insertions, 137 deletions
diff --git a/open-vm-tools/README b/open-vm-tools/README
index bba66a9d..45723b71 100644
--- a/open-vm-tools/README
+++ b/open-vm-tools/README
@@ -1,137 +1,126 @@
-Project information:
-
-open-vm-tools <http://open-vm-tools.sourceforge.net/>
-
- These are the release notes for the open-vm-tools. Read them carefully, as
-they explain how to build this project for different platforms and various
-different Linux distributions.
-
-================================================================================
-General information:
-
-(*)What are the open-vm-tools?
- The open-vm-tools are a subset of the VMware Tools, currently composed of
-kernel modules for Linux and user-space programs for all VMware supported Unix
-like guest operating systems.
-
-(*)Where do I find documentation for the open-vm-tools beyond this README?
- Please refer to the main project web site for all the latest documentation
-at: <http://open-vm-tools.sourceforge.net/>
-
-(*)How do I build the open-vm-tools?
- The open-vm-tools uses the GNU Automake tool for generating Makefiles to
-build all sources. More information about Automake can be found here:
-<http://sources.redhat.com/automake/>
-
-For more information on building this project see the "Project build
-information" section of this document.
-
-================================================================================
-Project build information:
-
-(*)Getting configure options & help:
- If you are looking for help or additional settings for the building of this
-project the following configure command will display a list of help options:
- "./configure --help"
-
-(*)Using configure:
- When using configure in the steps below it is only necessary to call
-"./configure" once unless there was a problem after the first invocation.
-
-(*)Building Unix user-space programs:
-1) "./configure"
-2) Run "make" to build Unix userland programs
-3) Run "make modules" to build kernel modules
-
-(*)Packaging:
-If you are interested in creating a Tools package, please see
-<https://sourceforge.net/apps/mediawiki/open-vm-tools/index.php?title=Packaging>
-for more information.
-
-================================================================================
-Build suggestions:
- Each Linux distribution puts binaries, libraries and development headers in
-different locations. This leads to having to setup different paths for the
-compiler and linker for the Automake system. Below is a list of known
-configurations to build for platforms that do not "just work" out of the box
-or the tar-ball as the case may be.
-
-General Build note:
- Please make note that the "--disable-multimon" flag should only be used when
-there are no libXinerama libraries installed, or you do not want to enable multi
-monitor support.
-
- Your operating system version will influence which kernel
-modules can be built. Here are the minimum OS versions for each
-module:
-
-|------------------------------------------------------------------------------|
-| vmsync | vmblock | vmxnet | vmmemctl | vmhgfs |
-|---------------|----------------|--------------|----------------|-------------|
-| Linux 2.6.6 | Linux 2.4.0 | Linux 2.2.0 | Linux 2.2.0 | Linux 2.4.0 |
-| FreeBSD N/A | FreeBSD 6.0 | FreeBSD 4.9 | FreeBSD 3.2 | FreeBSD 6.0 |
-|------------------------------------------------------------------------------|
-
-(*)Suse Enterprise 10.1 (i386 & x86_64):
-i386:
-./configure LDFLAGS="-L/opt/gnome/lib"
-
-x86_64:
-./configure LDFLAGS="-L/opt/gnome/lib64"
-
-(*)OpenSolaris "Nevada" (i386 & x86_64):
- Before building open-vm-tools on Solaris, you will need to make
-sure that libdnet (http://libdnet.sourceforge.net/) is installed and
-that the 'dnet-config' script is on your shell's PATH.
-
- Make sure that the GNU tools are in your shell's PATH. The
-default GNU tools location on OpenSolaris is: "/usr/sfw/bin". Once the
-PATH is set in your build shell then the following configure command
-should work:
-
-./configure --disable-multimon
-
-(*)FreeBSD 6.2 (i386 & x86_64):
-./configure LDFLAGS="-L/usr/local/lib"
-
-================================================================================
-Other resources:
- There are also open-source video & mouse drivers for Xorg/XFree86 that
-provide better performance and additional features to Linux, Solaris, and BSD
-derivatives guests running X11.
-
- The drivers 'xf86-input-vmmouse' and 'xf86-video-vmware' are included with
-recent Xorg releases, and it shouldn't be necessary to do anything extra to
-obtain them. If you want to obtain them separately, they can be downloaded at:
-<http://xorg.freedesktop.org/releases/individual/driver/>
-
-================================================================================
-Guest operating systems used to test on this release:
-
-(*)Fedora Core 8 (i386 & x86_64)
-(*)Redhat 9.0 (i386)
-(*)Redhat Enterprise 4 U5 (i386 & x86_64)
-(*)Redhat Enterprise 5 (i386 & x86_64)
-(*)FreeBSD 5.4 (i386 & x86_64)
-(*)FreeBSD 6.2 (i386 & x86_64)
-(*)OpenSolaris 10 "Nevada" (i386 & x86_64)
-(*)Open SuSE 10.3 (i386 & x86_64)
-(*)Ubuntu 6.04 (i386 & x86_64)
-(*)Ubuntu 7.10 (i386 & x86_64)
-
-===============================================================================
-Known issues:
-
-(*) When using HGFS on FreeBSD, the 'cp' command will fail if the source
-file is on the HGFS share. This is because mmap() does not yet work with
-the FreeBSD port of HGFS. One workaround is to use 'cat
-/mnt/hgfs/foo/bar > /tmp/baz' instead of 'cp /mnt/hgfs/foo/bar
-/tmp/baz'.
-
-(*) When using HGFS on FreeBSD, if your current working directory is the
-top-level HGFS mount (e.g. '/mnt/hgfs') and you run 'ls', you will
-receive an "Invalid argument" error. The workaround is to change to
-another directory and then run 'ls /mnt/hgfs'. Running 'ls' in
-subdirectories of /mnt/hgfs works as expected.
-
-===============================================================================
+Project information:
+
+open-vm-tools <http://open-vm-tools.sourceforge.net/>
+
+ These are the release notes for the open-vm-tools. Read them carefully, as
+they explain how to build this project for different platforms and various
+different Linux distributions.
+
+================================================================================
+General information:
+
+(*)What are the open-vm-tools?
+ The open-vm-tools are a subset of the VMware Tools, currently composed of
+kernel modules for Linux and user-space programs for all VMware supported Unix
+like guest operating systems.
+
+(*)Where do I find documentation for the open-vm-tools beyond this README?
+ Please refer to the main project web site for all the latest documentation
+at: <http://open-vm-tools.sourceforge.net/>
+
+(*)How do I build the open-vm-tools?
+ The open-vm-tools uses the GNU Automake tool for generating Makefiles to
+build all sources. More information about Automake can be found here:
+<http://sources.redhat.com/automake/>
+
+For more information on building this project see the "Project build
+information" section of this document.
+
+================================================================================
+Project build information:
+
+(*)Getting configure options & help:
+ If you are looking for help or additional settings for the building of this
+project the following configure command will display a list of help options:
+ "./configure --help"
+
+(*)Using configure:
+ When using configure in the steps below it is only necessary to call
+"./configure" once unless there was a problem after the first invocation.
+
+(*)Building Unix user-space programs:
+1) "./configure"
+2) Run "make" to build Unix userland programs
+3) Run "make modules" to build kernel modules
+
+(*)Packaging:
+If you are interested in creating a Tools package, please see
+<https://sourceforge.net/apps/mediawiki/open-vm-tools/index.php?title=Packaging>
+for more information.
+
+================================================================================
+Build suggestions:
+ Each Linux distribution puts binaries, libraries and development headers in
+different locations. This leads to having to setup different paths for the
+compiler and linker for the Automake system. Below is a list of known
+configurations to build for platforms that do not "just work" out of the box
+or the tar-ball as the case may be.
+
+General Build note:
+ Please make note that the "--disable-multimon" flag should only be used when
+there are no libXinerama libraries installed, or you do not want to enable multi
+monitor support.
+
+ Your operating system version will influence which kernel
+modules can be built. Here are the minimum OS versions for each
+module:
+
+|------------------------------------------------------------------------------|
+| vmsync | vmblock | vmxnet | vmmemctl | vmhgfs |
+|---------------|----------------|--------------|----------------|-------------|
+| Linux 2.6.6 | Linux 2.4.0 | Linux 2.2.0 | Linux 2.2.0 | Linux 2.4.0 |
+| FreeBSD N/A | FreeBSD 6.0 | FreeBSD 4.9 | FreeBSD 3.2 | |
+|------------------------------------------------------------------------------|
+
+(*)Suse Enterprise 10.1 (i386 & x86_64):
+i386:
+./configure LDFLAGS="-L/opt/gnome/lib"
+
+x86_64:
+./configure LDFLAGS="-L/opt/gnome/lib64"
+
+(*)OpenSolaris "Nevada" (i386 & x86_64):
+ Before building open-vm-tools on Solaris, you will need to make
+sure that libdnet (http://libdnet.sourceforge.net/) is installed and
+that the 'dnet-config' script is on your shell's PATH.
+
+ Make sure that the GNU tools are in your shell's PATH. The
+default GNU tools location on OpenSolaris is: "/usr/sfw/bin". Once the
+PATH is set in your build shell then the following configure command
+should work:
+
+./configure --disable-multimon
+
+(*)FreeBSD 6.2 (i386 & x86_64):
+./configure LDFLAGS="-L/usr/local/lib"
+
+================================================================================
+Other resources:
+ There are also open-source video & mouse drivers for Xorg/XFree86 that
+provide better performance and additional features to Linux, Solaris, and BSD
+derivatives guests running X11.
+
+ The drivers 'xf86-input-vmmouse' and 'xf86-video-vmware' are included with
+recent Xorg releases, and it shouldn't be necessary to do anything extra to
+obtain them. If you want to obtain them separately, they can be downloaded at:
+<http://xorg.freedesktop.org/releases/individual/driver/>
+
+================================================================================
+Guest operating systems used to test on this release:
+
+(*)Fedora Core 8 (i386 & x86_64)
+(*)Redhat 9.0 (i386)
+(*)Redhat Enterprise 4 U5 (i386 & x86_64)
+(*)Redhat Enterprise 5 (i386 & x86_64)
+(*)FreeBSD 5.4 (i386 & x86_64)
+(*)FreeBSD 6.2 (i386 & x86_64)
+(*)OpenSolaris 10 "Nevada" (i386 & x86_64)
+(*)Open SuSE 10.3 (i386 & x86_64)
+(*)Ubuntu 6.04 (i386 & x86_64)
+(*)Ubuntu 7.10 (i386 & x86_64)
+
+===============================================================================
+Known issues:
+
+
+===============================================================================