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 void internal_sigfillset(__sanitizer_sigset_t *set);
  36
  37 // Linux-only syscalls.
  38 #if SANITIZER_LINUX
  39 uptr internal_prctl(int option, uptr arg2, uptr arg3, uptr arg4, uptr arg5);
  40 // Used only by sanitizer_stoptheworld. Signal handlers that are actually used
  41 // (like the process-wide error reporting SEGV handler) must use
  42 // internal_sigaction instead.
  43 int internal_sigaction_norestorer(int signum, const void *act, void *oldact);
  44 void internal_sigdelset(__sanitizer_sigset_t *set, int signum);
  45 #if defined(__x86_64__) || defined(__mips__) || defined(__aarch64__)
  46 uptr internal_clone(int (*fn)(void *), void *child_stack, int flags, void *arg,
  47                     int *parent_tidptr, void *newtls, int *child_tidptr);
  48 #endif
  49 #endif  // SANITIZER_LINUX
  50
  51 // This class reads thread IDs from /proc/<pid>/task using only syscalls.
  52 class ThreadLister {
  53  public:
  54   explicit ThreadLister(int pid);
  55   ~ThreadLister();
  56   // GetNextTID returns -1 if the list of threads is exhausted, or if there has
  57   // been an error.
  58   int GetNextTID();
  59   void Reset();
  60   bool error();
  61
  62  private:
  63   bool GetDirectoryEntries();
  64
  65   int pid_;
  66   int descriptor_;
  67   InternalScopedBuffer<char> buffer_;
  68   bool error_;
  69   struct linux_dirent* entry_;
  70   int bytes_read_;
  71 };
  72
  73 // Exposed for testing.
  74 uptr ThreadDescriptorSize();
  75 uptr ThreadSelf();
  76 uptr ThreadSelfOffset();
  77
  78 // Matches a library's file name against a base name (stripping path and version
  79 // information).
  80 bool LibraryNameIs(const char *full_name, const char *base_name);
  81
  82 // Call cb for each region mapped by map.
  83 void ForEachMappedRegion(link_map *map, void (*cb)(const void *, uptr));
  84 }  // namespace __sanitizer
  85
  86 #endif  // SANITIZER_FREEBSD || SANITIZER_LINUX
  87 #endif  // SANITIZER_LINUX_H