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