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