// Copyright 2014 The Bazel Authors. All rights reserved.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//    http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

package com.google.devtools.build.lib.actions;

import com.google.common.base.Throwables;
import java.io.IOException;

/**
 * An ExecException which is results from an external problem on the user's
 * local system.
 *
 * <p>Note that this is fundamentally different exception then the higher level
 * LocalEnvironmentException, which is thrown from the BuildTool. That exception
 * is thrown when the higher levels of Blaze decide to exit.
 *
 * <p>This exception is thrown when a low level error is encountered in the
 * strategy or client protocol layers.  This does not necessarily mean we will
 * exit; we may just retry the action.
 */
public class EnvironmentalExecException extends ExecException {
  public EnvironmentalExecException(IOException cause) {
    super("unexpected I/O exception", cause);
  }

  public EnvironmentalExecException(String message, Throwable cause) {
    super(message, cause);
  }

  public EnvironmentalExecException(String message) {
    super(message);
  }

  @Override
  public ActionExecutionException toActionExecutionException(
      String messagePrefix, boolean verboseFailures, Action action) {
    if (getCause() != null) {
      String message =
          messagePrefix
              + " failed due to "
              + getMessage()
              + "\n"
              + Throwables.getStackTraceAsString(getCause());
      return new ActionExecutionException(message, action, isCatastrophic());
    } else {
      String message = messagePrefix + " failed due to " + getMessage();
      return new ActionExecutionException(message, action, isCatastrophic());
    }
  }
}

@@ -699,16 +699,68 @@
 wables;%0A
+import com.google.devtools.build.lib.util.ExitCode;%0A
 import j
@@ -819,18 +819,49 @@
 s re
-sults from
+ports an issue executing an action due to
  an 
@@ -887,15 +887,8 @@
  the
- user's
 %0A * 
@@ -914,419 +914,583 @@
  %3Cp%3E
-Note that this is fundamentally different exception then the higher level%0A * LocalEnvironmentException, which is thrown from the BuildTool. That exception%0A * is thrown when the higher levels of Blaze decide to exit.%0A *%0A * %3Cp%3EThis exception is thrown when a low level error is encountered in the%0A * strategy or client protocol layers.  This does not necessarily mean we will%0A * exit; we may just retry the action
+This exception will result in an exit code regarded as a system error; avoid using this for%0A * problems which should be attributed to the user, e.g., a misconfigured BUILD file (use %7B@link%0A * UserExecException%7D) or an action returning a non-zero exit code (use %7B@link *%0A * com.google.devtools.build.lib.exec.SpawnExecException%7D.%0A *%0A * %3Cp%3EThe most common use of this exception is to wrap an %22unexpected%22 %7B@link IOException%7D thrown by%0A * an lower-level file system access or local process execution, e.g., failure to create a temporary%0A * directory or denied file system access
 .%0A *
@@ -2246,32 +2246,43 @@
 cutionException(
+%0A          
 message, action,
@@ -2290,32 +2290,68 @@
 isCatastrophic()
+, ExitCode.LOCAL_ENVIRONMENTAL_ERROR
 );%0A    %7D else %7B%0A
@@ -2465,16 +2465,27 @@
 ception(
+%0A          
 message,
@@ -2509,16 +2509,52 @@
 rophic()
+, ExitCode.LOCAL_ENVIRONMENTAL_ERROR
 );%0A    %7D

exit as LOCAL_ENVIRONMENTAL_ERROR