From: Ben Pfaff <blp@nicira.com>
Date: Mon, 14 May 2012 21:21:18 +0000 (-0700)
Subject: daemon: Add comment.
X-Git-Tag: sliver-openvswitch-1.8.90-0~48^2~432
X-Git-Url: http://git.onelab.eu/?a=commitdiff_plain;h=e6c5e5390395a2ef19676319caa97b4e5a6942e2;p=sliver-openvswitch.git

daemon: Add comment.

Signed-off-by: Ben Pfaff <blp@nicira.com>
---

diff --git a/lib/daemon.c b/lib/daemon.c
index c4a82647f..672568342 100644
--- a/lib/daemon.c
+++ b/lib/daemon.c
@@ -245,6 +245,17 @@ daemonize(void)
     daemonize_complete();
 }
 
+/* Forks, then:
+ *
+ *   - In the parent, waits for the child to signal that it has completed its
+ *     startup sequence.  Then stores -1 in '*fdp' and returns the child's pid.
+ *
+ *   - In the child, stores a fd in '*fdp' and returns 0.  The caller should
+ *     pass the fd to fork_notify_startup() after it finishes its startup
+ *     sequence.
+ *
+ * If something goes wrong with the fork, logs a critical error and aborts the
+ * process. */
 static pid_t
 fork_and_wait_for_startup(int *fdp)
 {