Changeset 27743 in vbox for trunk/include/iprt

Timestamp:

Mar 26, 2010 2:50:55 PM (15 years ago)

Author:

vboxsync

Message:

IPRT,*: Renamed RTProcDaemonize to RTProcDaemonizeUsingFork. Added a new RTPRocDaemonize that is portable. RTProcCreate* got a new flag RTPROC_FLAGS_DETACHED, while RTPROC_FLAGS_DAEMONIZE got renamed to RTPROC_FLAGS_DAEMONIZE_DEPRECATED.

File:

• trunk/include/iprt/process.h (modified) (3 diffs)

trunk/include/iprt/process.h

@@ -184 +184 @@
 /** @name RTProcCreate and RTProcCreateEx flags
  * @{ */
+/** Detach the child process from the parents process tree and process group,
+ * session or/and console (depends on the platform what's done applicable).
+ *
+ * The new process will not be a direct decendent of the parent and it will not
+ * be possible to wait for it, i.e. @a phProcess shall be NULL. */
+#define RTPROC_FLAGS_DETACHED               RT_BIT(0)
+
 /** Daemonize the child process, without changing the directory.
- * @remarks Not implemented on all platforms yet... */
-#define RTPROC_FLAGS_DAEMONIZE          RT_BIT(0)
+ * @deprecated Dont use this for new code, it is not portable.  Use
+ *             RTProcDaemonize instead. */
+#define RTPROC_FLAGS_DAEMONIZE_DEPRECATED   RT_BIT(1)
 /** @}  */
 
@@ -288 +296 @@
 
 /**
+ * Daemonize the current process, making it a background process.
+ *
+ * The way this work is that it will spawn a detached / backgrounded /
+ * daemonized / call-it-what-you-want process that isn't a direct child of the
+ * current process.  The spawned will have the same arguments a the caller,
+ * except that the @a pszDaemonizedOpt is appended to prevent that the new
+ * process calls this API again.
+ *
+ * The new process will have the standard handles directed to/from the
+ * bitbucket.
+ *
+ * @returns IPRT status code.  On success it is normal for the caller to exit
+ *          the process by returning from main().
+ *
+ * @param   papszArgs       The argument vector of the calling process.
+ * @param   pszDaemonized   The daemonized option.  This is appended to the end
+ *                          of the parameter list of the daemonized process.
+ */
+RTR3DECL(int)   RTProcDaemonize(const char * const *papszArgs, const char *pszDaemonizedOpt);
+
+/**
  * Daemonize the current process, making it a background process. The current
  * process will exit if daemonizing is successful.
  *
- * @returns iprt status code.
+ * @returns IPRT status code.   On success it will only return in the child
+ *          process, the parent will exit.  On failure, it will return in the
+ *          parent process and no child has been spawned.
+ *
  * @param   fNoChDir    Pass false to change working directory to "/".
  * @param   fNoClose    Pass false to redirect standard file streams to the null device.
@@ -298 +330 @@
  *                      exists or cannot be written. May be NULL.
  */
-RTR3DECL(int)   RTProcDaemonize(bool fNoChDir, bool fNoClose, const char *pszPidfile);
+RTR3DECL(int)   RTProcDaemonizeUsingFork(bool fNoChDir, bool fNoClose, const char *pszPidfile);
 
 /**