Add a "phd debug" command

Summary:
Make it easier to find obvious problems in daemons by letting them run
undaemonized in the console without requiring the user to know the magical
incantations for loading libraries, etc.

Test Plan:
Ran "phd debug nice", simulated some failures (e.g., bringing down Phabricator,
daemon fatal) and got useful error messages.

Reviewed By: jungejason
Reviewers: toulouse, jungejason, tuomaspelkonen, aran
CC: aran, jungejason
Differential Revision: 448

scripts/daemon/phabricator_daemon_launcher.php

@@ -105,6 +105,9 @@ switch (isset($argv[1]) ? $argv[1] : 'help') {
     break;
 
   case 'launch':
+  case 'debug':
+    $is_debug = ($argv[1] == 'debug');
+
     $daemon = idx($argv, 2);
     if (!$daemon) {
       throw new Exception("Daemon name required!");
@@ -113,6 +116,7 @@ switch (isset($argv[1]) ? $argv[1] : 'help') {
     $pass_argv = array_slice($argv, 3);
 
     $n = 1;
+    if (!$is_debug) {
       if (is_numeric($daemon)) {
         $n = $daemon;
         if ($n < 1) {
@@ -124,6 +128,7 @@ switch (isset($argv[1]) ? $argv[1] : 'help') {
         }
         $pass_argv = array_slice($argv, 4);
       }
+    }
 
     $loader = new PhutilSymbolLoader();
     $symbols = $loader
@@ -154,12 +159,18 @@ switch (isset($argv[1]) ? $argv[1] : 'help') {
       $daemon = reset($match);
     }
 
+    if ($is_debug) {
+      echo "Launching {$daemon} in debug mode (nondaemonized)...\n";
+    } else {
       echo "Launching {$n} x {$daemon}";
+    }
 
     for ($ii = 0; $ii < $n; $ii++) {
-      $control->launchDaemon($daemon, $pass_argv);
+      $control->launchDaemon($daemon, $pass_argv, $is_debug);
+      if (!$is_debug) {
         echo ".";
       }
+    }
 
     echo "\n";
     echo "Done.\n";

src/docs/managing_daemons.diviner

@@ -34,6 +34,7 @@ a list of commands, run ##phd help##:
 Generally, you will use:
 
   - **phd launch** to launch daemons;
+  - **phd debug** to debug problems with daemons;
   - **phd status** to get a list of running daemons; and
   - **phd stop** to stop all daemons.
 
@@ -54,6 +55,10 @@ allows you to view log information for them. If you have issues with daemons,
 you may be able to find error information that will help you resolve the problem
 in the console.
 
+NOTE: The easiest way to figure out what's wrong with a daemon is usually to use
+**phd debug** to launch it instead of **phd launch**. This will run it without
+daemonizing it, so you can see output in your console.
+
 = Available Daemons =
 
 You can get a list of launchable daemons with **phd list**:

src/infrastructure/daemon/control/PhabricatorDaemonControl.php

@@ -128,7 +128,10 @@ final class PhabricatorDaemonControl {
 **COMMAND REFERENCE**
 
         **launch** [__n__] __daemon__ [argv ...]
+        **debug** __daemon__ [argv ...]
             Start a daemon (or n copies of a daemon).
+            With **debug**, do not daemonize. Use this if you're having trouble
+            getting daemons working.
 
         **list**
             List available daemons.
@@ -160,7 +163,7 @@ EOHELP
     return 1;
   }
 
-  public function launchDaemon($daemon, array $argv) {
+  public function launchDaemon($daemon, array $argv, $debug) {
     $symbols = $this->loadAvailableDaemonClasses();
     $symbols = ipull($symbols, 'name', 'name');
     if (empty($symbols[$daemon])) {
@@ -195,25 +198,41 @@ EOHELP
         phutil_get_library_root($library));
     }
 
-    $future = new ExecFuture(
+    $command = csprintf(
       "./launch_daemon.php ".
         "%s ".
         "--load-phutil-library=%s ".
         implode(' ', $extra_libraries)." ".
         "--conduit-uri=%s ".
-        "--daemonize ".
         "--phd=%s ".
+        ($debug ? '--trace ' : '--daemonize ').
         implode(' ', $argv),
       $daemon,
       phutil_get_library_root('phabricator'),
       PhabricatorEnv::getURI('/api/'),
       $pid_dir);
 
+    if ($debug) {
+      // Don't terminate when the user sends ^C; it will be sent to the
+      // subprocess which will terminate normally.
+      pcntl_signal(
+        SIGINT,
+        array('PhabricatorDaemonControl', 'ignoreSignal'));
+
+      echo "\n    libphutil/scripts/daemon/ \$ {$command}\n\n";
+
+      phutil_passthru('(cd %s && exec %C)', $launch_daemon, $command);
+    } else {
+      $future = new ExecFuture('exec %C', $command);
       // Play games to keep 'ps' looking reasonable.
       $future->setCWD($launch_daemon);
-
       $future->resolvex();
     }
+  }
+
+  public static function ignoreSignal($signo) {
+    return;
+  }
 
   protected function getControlDirectory($dir) {
     $path = PhabricatorEnv::getEnvConfig('phd.pid-directory').'/'.$dir;