libsanitizer/sanitizer_common/sanitizer_linux.h

   1 //===-- sanitizer_linux.h ---------------------------------------*- C++ -*-===//
   2 //
   3 // This file is distributed under the University of Illinois Open Source
   4 // License. See LICENSE.TXT for details.
   5 //
   6 //===----------------------------------------------------------------------===//
   7 //
   8 // Linux-specific syscall wrappers and classes.
   9 //
  10 //===----------------------------------------------------------------------===//
  11 #ifndef SANITIZER_LINUX_H
  12 #define SANITIZER_LINUX_H
  13
  14 #include "sanitizer_platform.h"
  15 #if SANITIZER_FREEBSD || SANITIZER_LINUX
  16 #include "sanitizer_common.h"
  17 #include "sanitizer_internal_defs.h"
  18 #include "sanitizer_posix.h"
  19 #include "sanitizer_platform_limits_posix.h"
  20
  21 struct link_map;  // Opaque type returned by dlopen().
  22 struct sigaltstack;
  23
  24 namespace __sanitizer {
  25 // Dirent structure for getdents(). Note that this structure is different from
  26 // the one in <dirent.h>, which is used by readdir().
  27 struct linux_dirent;
  28
  29 // Syscall wrappers.
  30 uptr internal_getdents(fd_t fd, struct linux_dirent *dirp, unsigned int count);
  31 uptr internal_sigaltstack(const struct sigaltstack* ss,
  32                           struct sigaltstack* oss);
  33 uptr internal_sigprocmask(int how, __sanitizer_sigset_t *set,
  34     __sanitizer_sigset_t *oldset);
  35
  36 // Linux-only syscalls.
  37 #if SANITIZER_LINUX
  38 uptr internal_prctl(int option, uptr arg2, uptr arg3, uptr arg4, uptr arg5);
  39 // Used only by sanitizer_stoptheworld. Signal handlers that are actually used
  40 // (like the process-wide error reporting SEGV handler) must use
  41 // internal_sigaction instead.
  42 int internal_sigaction_norestorer(int signum, const void *act, void *oldact);
  43 #if (defined(__x86_64__) || SANITIZER_MIPS64) && !SANITIZER_GO
  44 // Uses a raw system call to avoid interceptors.
  45 int internal_sigaction_syscall(int signum, const void *act, void *oldact);
  46 #endif
  47 void internal_sigdelset(__sanitizer_sigset_t *set, int signum);
  48 #if defined(__x86_64__) || defined(__mips__) || defined(__aarch64__) \
  49   || defined(__powerpc64__) || defined(__s390__)
  50 uptr internal_clone(int (*fn)(void *), void *child_stack, int flags, void *arg,
  51                     int *parent_tidptr, void *newtls, int *child_tidptr);
  52 #endif
  53 #endif  // SANITIZER_LINUX
  54
  55 // This class reads thread IDs from /proc/<pid>/task using only syscalls.
  56 class ThreadLister {
  57  public:
  58   explicit ThreadLister(int pid);
  59   ~ThreadLister();
  60   // GetNextTID returns -1 if the list of threads is exhausted, or if there has
  61   // been an error.
  62   int GetNextTID();
  63   void Reset();
  64   bool error();
  65
  66  private:
  67   bool GetDirectoryEntries();
  68
  69   int pid_;
  70   int descriptor_;
  71   InternalScopedBuffer<char> buffer_;
  72   bool error_;
  73   struct linux_dirent* entry_;
  74   int bytes_read_;
  75 };
  76
  77 // Exposed for testing.
  78 uptr ThreadDescriptorSize();
  79 uptr ThreadSelf();
  80 uptr ThreadSelfOffset();
  81
  82 // Matches a library's file name against a base name (stripping path and version
  83 // information).
  84 bool LibraryNameIs(const char *full_name, const char *base_name);
  85
  86 // Call cb for each region mapped by map.
  87 void ForEachMappedRegion(link_map *map, void (*cb)(const void *, uptr));
  88 }  // namespace __sanitizer
  89
  90 #endif  // SANITIZER_FREEBSD || SANITIZER_LINUX
  91 #endif  // SANITIZER_LINUX_H