Hostinfo day 6: RPM packaging, initscripts, hostinfo-status, hostinfo-test.

[virt-hostinfo.git] / hostinfod / hostinfo.pod

diff --git a/hostinfod/hostinfo.pod b/hostinfod/hostinfo.pod
index 9bebced..6ddfe57 100644 (file)
--- a/hostinfod/hostinfo.pod
+++ b/hostinfod/hostinfo.pod
@@ -220,18 +220,27 @@ C<[*]>.  A typical example would be:
 
  # Rule for specific qemu/KVM guest called 'guest1'.
  [qemu-guest1]
- interval 60
- physcpus off
+ interval       60
+ physcpus       off
  
  # Rule that covers all other qemu/KVM guests.
  [qemu-*]
- interval 60
+ interval       60
  
  # Catch-all default rule for guests.
  # This rule MUST be last in the file.
  [*]
- interval 1
- physcpus on
+ interval       1
+ availcpus      on
+ corespersocket on
+ memory         on
+ mhz            on
+ model          on
+ nodes          on
+ physcpus       on
+ ping           on
+ socketspernode on
+ threadspercore on
  #etc.
 
 In the section header, C<[hypervisor-guestname]>, the C<guestname>
@@ -273,16 +282,12 @@ reboot the guest or restart the daemon.
 Setting this to C<any> means there is no limit.  Guests can flood the
 host with requests.
 
-=item B<physcpus BOOL>
-
-Enable or disable requesting the number of physical CPUs available in
-the host.
-
-
-
-
+=item B<I<command> BOOL>
 
+Enable or disable the command named I<command>.
 
+The default for every command is disabled.  You have to enable
+each one that you want to allow.
 
 =back
 
@@ -382,6 +387,24 @@ Is the guest using the correct serial port?
 
 Use the L<hostinfo-test(8)> program in the guest to test this.
 
+=item 8.
+
+(Linux/Unix guests) Is getty attached to the serial port?
+
+On some operating systems, system daemons will attach themselves to
+serial ports.  Under Linux you can use the lsof command to check:
+
+ /usr/sbin/lsof | grep ttyS
+
+=item 9.
+
+(Linux/Unix guests) Is serial device not in raw mode?
+
+Client software should set the serial device to raw mode and
+disable echoing.  The usual way to do this is:
+
+ stty raw -echo < /dev/ttyS1
+
 =back
 
 Note that serial port settings like speed, parity etc. make no