src/sandbox/linux/seccomp-bpf-helpers/sigsys_handlers.h

   1 // Copyright (c) 2013 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 #ifndef SANDBOX_LINUX_SECCOMP_BPF_HELPERS_SIGSYS_HANDLERS_H_
   6 #define SANDBOX_LINUX_SECCOMP_BPF_HELPERS_SIGSYS_HANDLERS_H_
   7
   8 #include "base/basictypes.h"
   9 #include "build/build_config.h"
  10 #include "sandbox/linux/sandbox_export.h"
  11
  12 // The handlers are suitable for use in Trap() error codes. They are
  13 // guaranteed to be async-signal safe.
  14 // See sandbox/linux/seccomp-bpf/trap.h to see how they work.
  15
  16 namespace sandbox {
  17
  18 struct arch_seccomp_data;
  19
  20 // This handler will crash the currently running process. The crashing address
  21 // will be the number of the current system call, extracted from |args|.
  22 // This handler will also print to stderr the number of the crashing syscall.
  23 SANDBOX_EXPORT intptr_t
  24     CrashSIGSYS_Handler(const struct arch_seccomp_data& args, void* aux);
  25
  26 // The following three handlers are suitable to report failures with the
  27 // clone(), prctl() and ioctl() system calls respectively.
  28
  29 // The crashing address will be (clone_flags & 0xFFFFFF), where clone_flags is
  30 // the clone(2) argument, extracted from |args|.
  31 SANDBOX_EXPORT intptr_t
  32     SIGSYSCloneFailure(const struct arch_seccomp_data& args, void* aux);
  33 // The crashing address will be (option & 0xFFF), where option is the prctl(2)
  34 // argument.
  35 SANDBOX_EXPORT intptr_t
  36     SIGSYSPrctlFailure(const struct arch_seccomp_data& args, void* aux);
  37 // The crashing address will be request & 0xFFFF, where request is the ioctl(2)
  38 // argument.
  39 SANDBOX_EXPORT intptr_t
  40     SIGSYSIoctlFailure(const struct arch_seccomp_data& args, void* aux);
  41 // The crashing address will be (pid & 0xFFF), where pid is the first
  42 // argument (and can be a tid).
  43 intptr_t SIGSYSKillFailure(const struct arch_seccomp_data& args, void* aux);
  44
  45 // Following four functions return substrings of error messages used
  46 // in the above four functions. They are useful in death tests.
  47 SANDBOX_EXPORT const char* GetErrorMessageContentForTests();
  48 SANDBOX_EXPORT const char* GetCloneErrorMessageContentForTests();
  49 SANDBOX_EXPORT const char* GetPrctlErrorMessageContentForTests();
  50 SANDBOX_EXPORT const char* GetIoctlErrorMessageContentForTests();
  51
  52 }  // namespace sandbox.
  53
  54 #endif  // SANDBOX_LINUX_SECCOMP_BPF_HELPERS_SIGSYS_HANDLERS_H_