sigsys_handlers.h revision 0529e5d033099cbfc42635f6f6183833b09dff6e 
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
16namespace sandbox {
17
18struct 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.
23SANDBOX_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|.
31SANDBOX_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.
35SANDBOX_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.
39SANDBOX_EXPORT intptr_t
40    SIGSYSIoctlFailure(const struct arch_seccomp_data& args, void* aux);
41
42// Following four functions return substrings of error messages used
43// in the above four functions. They are useful in death tests.
44SANDBOX_EXPORT const char* GetErrorMessageContentForTests();
45SANDBOX_EXPORT const char* GetCloneErrorMessageContentForTests();
46SANDBOX_EXPORT const char* GetPrctlErrorMessageContentForTests();
47SANDBOX_EXPORT const char* GetIoctlErrorMessageContentForTests();
48
49}  // namespace sandbox.
50
51#endif  // SANDBOX_LINUX_SECCOMP_BPF_HELPERS_SIGSYS_HANDLERS_H_
52