Index: src/java/org/apache/hadoop/mapred/LinuxTaskController.java
===================================================================
--- src/java/org/apache/hadoop/mapred/LinuxTaskController.java (revision 892141)
+++ src/java/org/apache/hadoop/mapred/LinuxTaskController.java (working copy)
@@ -92,12 +92,39 @@
SIGQUIT_TASK_JVM,
}
+
/**
- * Launch a task JVM that will run as the owner of the job.
+ *
Launch a task JVM that will run as the owner of the job.
*
- * This method launches a task JVM by executing a setuid executable that will
+ * This method launches a task JVM by executing a setuid executable that will
* switch to the user and run the task. Also does initialization of the first
- * task in the same setuid process launch.
+ * task in the same setuid process launch.
+ *
+ * The task exit codes are assigned as follows:
+ * 1 - The numeric argument is invalid
+ * 2 - The user name is invalid
+ * 3 - The provided command is invalid
+ * 4 - Superuser is not allowed to run this task
+ * 5 - The Task Tracker root is invalid
+ * 6 - setuid operation failed
+ * 7 - Unable to execute the task script
+ * 8 - Unable to kill the task
+ * 9 - Invalid task PID
+ * 10 - Error in resolving the file path
+ * 11 - Relative path components found in the file path
+ * 12 - Unable to receive the file stat
+ * 13 - The file is not owned by Task Tracker
+ * 14 - Attempt to prepare directories failed
+ * 15 - Job initialization failed
+ * 16 - Task log preparation failed
+ * 17 - Task Tracker log directory is invalid
+ * 18 - The system has run out of memory
+ * 19 - Distcache initialization failed
+ * 20 - User initialization failed
+ * 21 - Unable to execute the debug script
+ * 22 - The configuration directory is invalid
+ * 137 - SIGKILL
+ * 143 - SIGTERM
*/
@Override
void launchTaskJVM(TaskController.TaskControllerContext context)
@@ -156,10 +183,36 @@
}
/**
- * Launch the debug script process that will run as the owner of the job.
+ * Launch the debug script process that will run as the owner of the job.
*
- * This method launches the task debug script process by executing a setuid
- * executable that will switch to the user and run the task.
+ * This method launches the task debug script process by executing a setuid
+ * executable that will switch to the user and run the task.
+ *
+ * The task exit codes are assigned as follows:
+ * 1 - The numeric argument is invalid
+ * 2 - The user name is invalid
+ * 3 - The provided command is invalid
+ * 4 - Superuser is not allowed to run this task
+ * 5 - The Task Tracker root is invalid
+ * 6 - setuid operation failed
+ * 7 - Unable to execute the task script
+ * 8 - Unable to kill the task
+ * 9 - Invalid task PID
+ * 10 - Error in resolving the file path
+ * 11 - Relative path components found in the file path
+ * 12 - Unable to receive the file stat
+ * 13 - The file is not owned by Task Tracker
+ * 14 - Attempt to prepare directories failed
+ * 15 - Job initialization failed
+ * 16 - Task log preparation failed
+ * 17 - Task Tracker log directory is invalid
+ * 18 - The system has run out of memory
+ * 19 - Distcache initialization failed
+ * 20 - User initialization failed
+ * 21 - Unable to execute the debug script
+ * 22 - The configuration directory is invalid
+ * 137 - SIGKILL
+ * 143 - SIGTERM
*/
@Override
void runDebugScript(DebugScriptContext context) throws IOException {