lib/sanitizer_common/sanitizer_linux.h

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