diff --git a/Makefile.am b/Makefile.am index f572d56f2acad2abaf4e2fe02f90b8175e4c5db1..e890191ba5220fd4e3df3075a6a9bbe993471a14 100644 --- a/Makefile.am +++ b/Makefile.am @@ -1195,6 +1195,7 @@ man_MANS = \ man/ganeti-confd.8 \ man/ganeti-luxid.8 \ man/ganeti-listrunner.8 \ + man/ganeti-kvmd.8 \ man/ganeti-masterd.8 \ man/ganeti-mond.8 \ man/ganeti-noded.8 \ diff --git a/man/ganeti-kvmd.rst b/man/ganeti-kvmd.rst new file mode 100644 index 0000000000000000000000000000000000000000..38962fdd8994cf41f0dc94ebee93675ff3a5adc4 --- /dev/null +++ b/man/ganeti-kvmd.rst @@ -0,0 +1,37 @@ +ganeti-kvmd(8) Ganeti | Version @GANETI_VERSION@ +================================================ + +Name +---- + +ganeti-kvmd - Ganeti KVM daemon + +Synopsis +-------- + +**ganeti-kvmd** + +DESCRIPTION +----------- + +The KVM daemon is responsible for determining whether a given KVM +instance was shutdown by an administrator or a user. + +The KVM daemon monitors, using ``inotify``, KVM instances through +their QMP sockets, which are provided by KVM. Using the QMP sockets, +the KVM daemon listens for particular shutdown, powerdown, and stop +events which will determine if a given instance was shutdown by the +user or Ganeti, and this result is communicated to Ganeti via a +special file in the filesystem. + +FILES +----- + +The KVM daemon monitors Qmp sockets of KVM instances, which are created +in the KVM control directory, located under +``@LOCALSTATEDIR@/run/ganeti/kvm-hypervisor/ctrl/``. The KVM daemon +also creates shutdown files in this directory. Finally, the KVM +daemon's log file is located under +``@LOCALSTATEDIR@/log/ganeti/ganeti-kvmd.log``. Removal of the KVM +control directory, the shutdown files, or the log file, will lead to no +errors on the KVM daemon.