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

(*)Why is there no "make install" make target?
	In their current state, the various Tools applications and modules require a
fair bit of installation support to run properly.  VMware currently maintains a 
Perl-based installer for the Tools that is pretty good about providing that 
support under a variety of distributions and environments.  It doesn't make 
sense to rewrite this installer under make; distribution-specific Tools 
packages (tailored for a particular target environment) are better suited to 
the task.  If you are interested in creating a Tools package, please see
<http://open-vm-tools.sourceforge.net/> 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.

===============================================================================
