From: Ben Pfaff <blp@nicira.com>
Date: Mon, 14 May 2012 21:21:18 +0000 (-0700)
Subject: daemon: Add comment.
X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=e6c5e5390395a2ef19676319caa97b4e5a6942e2;p=openvswitch

daemon: Add comment.

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

diff --git a/lib/daemon.c b/lib/daemon.c
index c4a82647..67256834 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)
 {