From: Richard W.M. Jones <rjones@redhat.com>
Date: Tue, 18 Jan 2011 22:29:43 +0000 (+0000)
Subject: Update README with information for potential contributors.
X-Git-Tag: 1.6~10
X-Git-Url: http://git.annexia.org/?a=commitdiff_plain;h=5a0ed24f5002766bb4938123cfe1e1551d9d0f0a;p=virt-what.git

Update README with information for potential contributors.
---

diff --git a/README b/README
index 2d1bc29..d07b4d1 100644
--- a/README
+++ b/README
@@ -1,9 +1,14 @@
 virt-what
-Copyright (C) 2008-2009 Red Hat Inc.
+Copyright (C) 2008-2011 Red Hat Inc.
 ----------------------------------------------------------------------
 
 This is a collection of scripts which you can use to work out what
-sort of virtualization you are running inside.
+sort of virtualization you are running inside.  Please read the manual
+page virt-what(1) to find out how to use it.  This file is for
+developers and people compiling from source.
+
+Compiling and installing
+----------------------------------------------------------------------
 
 Build:
 
@@ -31,3 +36,51 @@ also:
 
   make prefix=/usr install
   make DESTDIR=/tmp/somewhere install
+
+Contributing a virtualization test
+----------------------------------------------------------------------
+
+virt-what is especially dependent on outside contributors because it's
+hard to even get access to some of the hypervisors out there, and even
+for the common hypervisors there are many different versions and many
+different ways for to break.  For these reasons we are especially
+happy if you contribute to or even just test virt-what :-)
+
+virt-what is a simple shell script.  Add a new hypervisor test to
+'virt-what.in' ('virt-what' in this directory is a generated file).
+
+If you can't contribute a patch, please just send us the following
+data (all as root from inside the guest):
+
+  (1) /proc/cpuinfo
+
+  (2) dmidecode
+
+  (3) If possible, send the output of /usr/libexec/virt-what-cpuid-helper
+
+  (4) Any other /proc and /sys files that may be related to the
+      hypervisor.
+
+  (5) Name of the virtualization system, version, host or guest,
+      and as much other information as possible.
+
+Please send patches, test results or any other data to:
+
+  https://www.redhat.com/mailman/listinfo/virt-tools-list
+
+See also: http://virt-tools.org/contact/
+
+Contributing a regression test
+----------------------------------------------------------------------
+
+In the tests/ subdirectory you'll find some existing tests.
+
+These tests are taken from real machines, and we have a policy of
+*only* adding real data here so that our regression tests are
+impeccable.
+
+The virt-what script has a hidden '--test-root' option which allows a
+different root directory to be specified for these regression tests.
+The tests/ subdirectory contains some alternate root filesystems
+(sparsely populated with a few files taken from the real systems) for
+testing.