mirror of
https://github.com/Stichting-MINIX-Research-Foundation/netbsd.git
synced 2025-08-12 07:31:12 -04:00
81 lines
2.4 KiB
Groff
81 lines
2.4 KiB
Groff
.\" $NetBSD: vmt.4,v 1.6 2013/10/07 04:04:57 dholland Exp $
|
|
.\" $OpenBSD: vmt.4,v 1.4 2010/10/26 05:07:31 jmc Exp $
|
|
.\"
|
|
.\" Copyright (c) 2008 Marco Peereboom <marco@openbsd.org>
|
|
.\" Text was heavily borrowed from the IPMI spec V1.5
|
|
.\"
|
|
.\" Permission to use, copy, modify, and distribute this software for any
|
|
.\" purpose with or without fee is hereby granted, provided that the above
|
|
.\" copyright notice and this permission notice appear in all copies.
|
|
.\"
|
|
.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
|
|
.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
|
|
.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
|
|
.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
|
|
.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
|
|
.\" ACTION OF CONTRACT, NEGLIGENCE OR TORTIOUS ACTION, ARISING OUT OF
|
|
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
|
.Dd October 6, 2013
|
|
.Dt VMT 4 x86
|
|
.Os
|
|
.Sh NAME
|
|
.Nm vmt
|
|
.Nd VMware Tools driver
|
|
.Sh SYNOPSIS
|
|
.Cd "vmt0 at cpu0"
|
|
.Sh DESCRIPTION
|
|
The
|
|
.Nm
|
|
driver is a kernel level implementation of VMware Tools.
|
|
VMware Tools are intended to provide better support for operating systems
|
|
running inside virtual machines.
|
|
.Pp
|
|
.Nm
|
|
handles shutdown, reboot, resume requests from the host by sending
|
|
events using
|
|
.Xr sysmon_pswitch 9
|
|
of type PSWITCH_TYPE_POWER, PSWITCH_TYPE_RESET, and PSWITCH_TYPE_SLEEP that
|
|
can be handled by
|
|
.Xr powerd 8 .
|
|
.Nm
|
|
will log notifications that the guest has been suspended or resumed by the
|
|
host.
|
|
.\" It also provides access to the host machine's clock as a timedelta sensor.
|
|
.Pp
|
|
.Nm
|
|
reports the guest's hostname and first non-loopback IP address to the host.
|
|
.Ss Clock synchronization
|
|
The
|
|
.Nm
|
|
driver synchronizes the virtual machine's clock with the host clock in the
|
|
following situations:
|
|
.Bl -bullet
|
|
.It
|
|
When the virtual machine resumes after having been suspended.
|
|
.It
|
|
Periodically with the interval indicated by the
|
|
.Va machdep.vmt0.clock_sync.period
|
|
.Xr sysctl 8
|
|
variable.
|
|
This is done so that the virtual machine can keep its clock synchronized
|
|
when the host is suspended, because in this case the
|
|
.Nm
|
|
driver receives no notification of such an event.
|
|
Setting this tunable to zero disables clock synchronization.
|
|
.El
|
|
.Sh SEE ALSO
|
|
.\" .Xr cpu 4 ,
|
|
.Xr powerd 8
|
|
.Sh HISTORY
|
|
The
|
|
.Nm
|
|
driver first appeared in
|
|
.Ox 4.4
|
|
and was then ported to
|
|
.Nx 6.0 .
|
|
.Sh AUTHORS
|
|
The
|
|
.Nm
|
|
driver was written by
|
|
.An David Gwynne Aq Mt dlg@openbsd.org .
|