Define the bang method interface

slapos/slap/interface/slap.py

@@ -174,6 +174,14 @@ class IComputerPartition(IBuildoutController):
                  It can be an XML for example.
     """
 
+  def bang(log):
+    """
+    Report a problem detected on a computer partition.
+    This will trigger the reinstanciation of all partitions in the instance tree.
+
+    log -- a text explaining why the method was called
+    """
+
 class IComputer(Interface):
   """
   Computer interface specification
@@ -209,6 +217,15 @@ class IComputer(Interface):
                                needs to be reported.
     """
 
+  def bang(log):
+    """
+    Report a problem detected on a computer.
+    This will trigger IComputerPartition.bang on all instances hosted by the
+    Computer.
+
+    log -- a text explaining why the method was called
+    """
+
 class IOpenOrder(Interface):
   """
   Open Order interface specification