X-Git-Url: http://git.annexia.org/?a=blobdiff_plain;f=README;h=2deb9841dfde7812514d661fc4b9f811687ff644;hb=b266768eda005d900a9f232de0ba3827b37627f4;hp=e69de29bb2d1d6434b8b29ae775ad8c2e48c5391;hpb=47ecd7f15e87191f9cd1741337b82e3b3723fd3d;p=virt-hostinfo.git

diff --git a/README b/README
index e69de29..2deb984 100644
--- a/README
+++ b/README
@@ -0,0 +1,66 @@
+virt-hostinfo
+Copyright (C) 2009 Red Hat Inc.
+----------------------------------------------------------------------
+
+This is a project designed to allow controlled access to host
+information from virtual machines.  It is proposed as a new feature
+for Fedora 12, and you can read more about it on this web page:
+
+http://fedoraproject.org/wiki/Features/Hostinfo
+
+
+Requirements
+----------------------------------------------------------------------
+
+- C compiler
+
+- APR (Apache Portable Runtime) 1.3
+
+- Perl
+
+- pod2man and other perldoc tools
+  * these are usually supplied with Perl
+
+- libvirt & development tools
+
+- Perl module Sys::Virt
+
+
+
+Build
+----------------------------------------------------------------------
+
+On the host:
+
+  ./configure
+  make
+  sudo make install
+
+There is nothing to build or install in the guest.
+
+
+Host configuration
+----------------------------------------------------------------------
+
+You can edit the text configuration files under /etc/hostinfod by
+hand.  Please read the hostinfo(8) manual page.
+
+For graphical configuration, use virt-manager.
+
+To create new guests with access to host information, use
+virt-install.
+
+
+Accessing host information from guests
+----------------------------------------------------------------------
+
+No special software is required inside the guest.  Simply connect to
+the serial port (usually, but not always, /dev/ttyS1 or COM2) using
+your favorite serial terminal software and send commands.
+
+The protocol is a simple, line-based, text protocol.  No special
+libraries are needed to use it from programs or by hand.  The commands
+that you can send are documented in the hostinfo-protocol(5) manual
+page.
+
+For troubleshooting, see hostinfo(8) manual page.