Summary:       Access host information and statistics from virtual machines
Name:          virt-hostinfo
Version:       @VERSION@
Release:       1%{?dist}
License:       GPLv2+
Group:         System Environment/Daemons
URL:           http://et.redhat.com/~rjones/hostinfo/
Source0:       http://et.redhat.com/~rjones/hostinfo/files/%{name}-%{version}.tar.gz
BuildRoot:     %{_tmppath}/%{name}-%{version}-%{release}-root

BuildRequires: apr-devel >= 1.2.7
BuildRequires: perl
BuildRequires: libvirt-devel >= 0.2.1
BuildRequires: perl-Sys-Virt
BuildRequires: perl-XML-XPath

Requires(post): chkconfig
Requires(preun): chkconfig
Requires(preun): initscripts
Requires(postun): initscripts

Requires:      %{name}-tools = %{version}-%{release}


%description
Allow a virtual machine to look at host information (such as number of
physical, not just virtual CPUs), and statistics like the load on the
host. Users have asked for this primarily as a diagnostic tool -- for
example, poor performance of a virtual machine might be caused by
excessive load on the host.

Normally we try to isolate virtual machines from accessing any such
details from the host, and there are very good reasons for that too,
such as security of the host, commercial confidentiality, and the
privacy of other virtual machines running on the host. As a result, at
the moment there is no mechanism for accessing host information.

Hostinfo allows the host administrator, at their discretion, and only
of limited data to limited virtual machines, to export host
information and statistics to virtual machines.

Administrators have to:

 * explicitly enable this feature,
 * select the virtual machines and/or data they wish to be seen in guests,
 * select the frequency that guests can ask for data. 

Hostinfo runs a daemon on the host which collects the statistics. The
information will be exported to guests over a spare (virtual) serial
port.

Guests request information by sending a plain text command to the
serial port, and receive information in the form of a simple, plain
text message. No special drivers or software are required by the
guest.


%package tools
Summary:       Hostinfo server configuration tools
Group:         Applications/System


%description tools
This package contains server configuration tools for
%{name}.


%package client
Summary:       Hostinfo client and test tools
Group:         Applications/System


%description client
This package contains client and test tools for testing
%{name}.

It should be installed inside a virtual machine running on a
hostinfo-enabled host.


%prep
%setup -q


%build
%{configure}
make


%install
rm -rf $RPM_BUILD_ROOT
make DESTDIR=$RPM_BUILD_ROOT install


%clean
rm -rf $RPM_BUILD_ROOT


%post
/sbin/chkconfig --add hostinfo


%preun
if [ $1 = 0 ] ; then
  /sbin/service hostinfo stop >/dev/null 2>&1
  /sbin/chkconfig --del hostinfo
fi


%postun
if [ "$1" -ge "1" ] ; then
  /sbin/service hostinfo condrestart >/dev/null 2>&1 || :
fi


%files
%defattr(-,root,root,-)
%doc COPYING README
%dir %{_sysconfdir}/hostinfo
%config(noreplace) %{_sysconfdir}/hostinfo/guests.conf
%config(noreplace) %{_sysconfdir}/hostinfo/hostinfo.conf
%{_sysconfdir}/init.d/hostinfo
%config(noreplace) %{_sysconfdir}/sysconfig/hostinfod
%{_sbindir}/hostinfod
%{_mandir}/man5/hostinfo-protocol.5*
%{_mandir}/man8/hostinfo.8*
%{_mandir}/man8/hostinfod.8*
%dir %attr(0775,root,qemu) %{_localstatedir}/lib/hostinfo


%files tools
%defattr(-,root,root,-)
%doc COPYING
%{_bindir}/hostinfo-set
%{_bindir}/hostinfo-status
%{_mandir}/man8/hostinfo-set.8*
%{_mandir}/man8/hostinfo-status.8*


%files client
%defattr(-,root,root,-)
%doc COPYING
%{_bindir}/hostinfo-test
%{_mandir}/man1/hostinfo-test.1*


%changelog
* Tue Aug 11 2009 Richard W.M. Jones <rjones@redhat.com> - @VERSION@-1
- Initial RPM packaging.