Send the child SIGSTOPs and SIGCONTs

[i3/i3] / i3bar / include / child.h

diff --git a/i3bar/include/child.h b/i3bar/include/child.h
index 3d3c28c9337e219c16f71b7a54fcddeb69dbd5b4..69cfc5767a6c9b2c051cc19450215f13c6390e2e 100644 (file)
--- a/i3bar/include/child.h
+++ b/i3bar/include/child.h
@@ -1,9 +1,41 @@
+/*
+ * i3bar - an xcb-based status- and ws-bar for i3
+ *
+ * © 2010 Axel Wagner and contributors
+ *
+ * See file LICNSE for license information
+ *
+ */
 #ifndef CHILD_H_
 #define CHILD_H_
 
 #define STDIN_CHUNK_SIZE 1024
 
+/*
+ * Start a child-process with the specified command and reroute stdin.
+ * We actually start a $SHELL to execute the command so we don't have to care
+ * about arguments and such
+ *
+ */
 void start_child(char *command);
+
+/*
+ * kill()s the child-prozess (if existend) and closes and
+ * free()s the stdin- and sigchild-watchers
+ *
+ */
 void kill_child();
 
+/*
+ * Sends a SIGSTOP to the child-process (if existent)
+ *
+ */
+void stop_child();
+
+/*
+ * Sends a SIGCONT to the child-process (if existent)
+ *
+ */
+void cont_child();
+
 #endif