1 files changed, 82 insertions, 0 deletions
diff --git a/bbot/machine.hxx b/bbot/machine.hxx
new file mode 100644
index 0000000..9ea0d48
--- /dev/null
+++ b/bbot/machine.hxx
@@ -0,0 +1,82 @@
+// file      : bbot/machine.hxx -*- C++ -*-
+// copyright : Copyright (c) 2014-2017 Code Synthesis Ltd
+// license   : TBC; see accompanying LICENSE file
+
+#ifndef BBOT_MACHINE_HXX
+#define BBOT_MACHINE_HXX
+
+#include <bbot/types.hxx>
+#include <bbot/utility.hxx>
+
+namespace bbot
+{
+  // A running build machine (container, vm, etc).
+  //
+  // Note that if the machine is destroyed while it is still running, the
+  // destructor will block until the machine process terminates.
+  //
+  class machine
+  {
+  public:
+    // Shut the machine down cleanly waiting up to the specified number of
+    // seconds for completion. Update the timeout and return false if the
+    // machine is still running, true if the machine exited successfully, and
+    // throw failed otherwise.
+    //
+    virtual bool
+    shutdown (size_t& seconds) = 0;
+
+    // Force the machine down.
+    //
+    virtual void
+    forcedown () = 0;
+
+    // Suspend the machine.
+    //
+    virtual void
+    suspend () = 0;
+
+    // Wait for the machine to terminate up to the specified number of
+    // seconds. Update the timeout and return false if the machine is still
+    // running, true if the machine exited successfully, and throw failed
+    // otherwise.
+    //
+    virtual bool
+    wait (size_t& seconds)  = 0;
+
+    bool
+    wait ()
+    {
+      size_t sec (~0); // Wait indefinitely.
+      return wait (sec);
+    }
+
+    // Print information about the machine (as info diagnostics) that can be
+    // useful for debugging (e.g., how to connect/login, etc).
+    //
+    virtual void
+    print_info (diag_record&) = 0;
+
+  public:
+    const string mac; // MAC address (inside the machine).
+
+  public:
+    virtual
+    ~machine () = default;
+
+  protected:
+    machine (string m)
+        : mac (move (m)) {}
+  };
+
+  class machine_manifest;
+
+  unique_ptr<machine>
+  start_machine (const dir_path&,
+                 const machine_manifest&,
+                 const optional<string>& mac,
+                 const string& br_iface,
+                 uint16_t tftp_port);
+}
+
+#endif // BBOT_MACHINE_HXX