X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=src%2Fshared%2Futil.c;h=e75f6c9df33c7f8439f3172e47a7dcf7bcebe9eb;hb=0659e8baf25c86cadac8cac79f4e800501694c8b;hp=af6bde2c3dd280e8c3f72f090d035d8d88b32e17;hpb=3005a221f1f2d7bc6e6f1a4df6b40e7d8bbd7e9e;p=elogind.git

diff --git a/src/shared/util.c b/src/shared/util.c
index af6bde2c3..e75f6c9df 100644
--- a/src/shared/util.c
+++ b/src/shared/util.c
@@ -3482,6 +3482,17 @@ int wait_for_terminate(pid_t pid, siginfo_t *status) {
         }
 }
 
+/*
+ * Return values:
+ * < 0 : wait_for_terminate() failed to get the state of the
+ *       process, the process was terminated by a signal, or
+ *       failed for an unknown reason.
+ * >=0 : The process terminated normally, and its exit code is
+ *       returned.
+ *
+ * That is, success is indicated by a return value of zero, and an
+ * error is indicated by a non-zero value.
+ */
 int wait_for_terminate_and_warn(const char *name, pid_t pid) {
         int r;
         siginfo_t status;