Sacado Package Browser (Single Doxygen Collection)  Version of the Day
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
gtest-port.cc
Go to the documentation of this file.
1 // Copyright 2008, Google Inc.
2 // All rights reserved.
3 //
4 // Redistribution and use in source and binary forms, with or without
5 // modification, are permitted provided that the following conditions are
6 // met:
7 //
8 // * Redistributions of source code must retain the above copyright
9 // notice, this list of conditions and the following disclaimer.
10 // * Redistributions in binary form must reproduce the above
11 // copyright notice, this list of conditions and the following disclaimer
12 // in the documentation and/or other materials provided with the
13 // distribution.
14 // * Neither the name of Google Inc. nor the names of its
15 // contributors may be used to endorse or promote products derived from
16 // this software without specific prior written permission.
17 //
18 // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
19 // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
20 // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
21 // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
22 // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
23 // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
24 // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
25 // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
26 // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
27 // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
28 // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
29 
31 
32 #include <limits.h>
33 #include <stdio.h>
34 #include <stdlib.h>
35 #include <string.h>
36 
37 #include <cstdint>
38 #include <fstream>
39 #include <memory>
40 #include <ostream>
41 #include <string>
42 #include <utility>
43 #include <vector>
44 
45 #ifdef GTEST_OS_WINDOWS
46 #include <io.h>
47 #include <sys/stat.h>
48 #include <windows.h>
49 
50 #include <map> // Used in ThreadLocal.
51 #ifdef _MSC_VER
52 #include <crtdbg.h>
53 #endif // _MSC_VER
54 #else
55 #include <unistd.h>
56 #endif // GTEST_OS_WINDOWS
57 
58 #ifdef GTEST_OS_MAC
59 #include <mach/mach_init.h>
60 #include <mach/task.h>
61 #include <mach/vm_map.h>
62 #endif // GTEST_OS_MAC
63 
64 #if defined(GTEST_OS_DRAGONFLY) || defined(GTEST_OS_FREEBSD) || \
65  defined(GTEST_OS_GNU_KFREEBSD) || defined(GTEST_OS_NETBSD) || \
66  defined(GTEST_OS_OPENBSD)
67 #include <sys/sysctl.h>
68 #if defined(GTEST_OS_DRAGONFLY) || defined(GTEST_OS_FREEBSD) || \
69  defined(GTEST_OS_GNU_KFREEBSD)
70 #include <sys/user.h>
71 #endif
72 #endif
73 
74 #ifdef GTEST_OS_QNX
75 #include <devctl.h>
76 #include <fcntl.h>
77 #include <sys/procfs.h>
78 #endif // GTEST_OS_QNX
79 
80 #ifdef GTEST_OS_AIX
81 #include <procinfo.h>
82 #include <sys/types.h>
83 #endif // GTEST_OS_AIX
84 
85 #ifdef GTEST_OS_FUCHSIA
86 #include <zircon/process.h>
87 #include <zircon/syscalls.h>
88 #endif // GTEST_OS_FUCHSIA
89 
90 #include "gtest/gtest-message.h"
91 #include "gtest/gtest-spi.h"
94 #include "src/gtest-internal-inl.h"
95 
96 namespace testing {
97 namespace internal {
98 
99 #if defined(GTEST_OS_LINUX) || defined(GTEST_OS_GNU_HURD)
100 
101 namespace {
102 template <typename T>
103 T ReadProcFileField(const std::string& filename, int field) {
104  std::string dummy;
105  std::ifstream file(filename.c_str());
106  while (field-- > 0) {
107  file >> dummy;
108  }
109  T output = 0;
110  file >> output;
111  return output;
112 }
113 } // namespace
114 
115 // Returns the number of active threads, or 0 when there is an error.
116 size_t GetThreadCount() {
117  const std::string filename =
118  (Message() << "/proc/" << getpid() << "/stat").GetString();
119  return ReadProcFileField<size_t>(filename, 19);
120 }
121 
122 #elif defined(GTEST_OS_MAC)
123 
124 size_t GetThreadCount() {
125  const task_t task = mach_task_self();
126  mach_msg_type_number_t thread_count;
127  thread_act_array_t thread_list;
128  const kern_return_t status = task_threads(task, &thread_list, &thread_count);
129  if (status == KERN_SUCCESS) {
130  // task_threads allocates resources in thread_list and we need to free them
131  // to avoid leaks.
132  vm_deallocate(task, reinterpret_cast<vm_address_t>(thread_list),
133  sizeof(thread_t) * thread_count);
134  return static_cast<size_t>(thread_count);
135  } else {
136  return 0;
137  }
138 }
139 
140 #elif defined(GTEST_OS_DRAGONFLY) || defined(GTEST_OS_FREEBSD) || \
141  defined(GTEST_OS_GNU_KFREEBSD) || defined(GTEST_OS_NETBSD)
142 
143 #ifdef GTEST_OS_NETBSD
144 #undef KERN_PROC
145 #define KERN_PROC KERN_PROC2
146 #define kinfo_proc kinfo_proc2
147 #endif
148 
149 #ifdef GTEST_OS_DRAGONFLY
150 #define KP_NLWP(kp) (kp.kp_nthreads)
151 #elif defined(GTEST_OS_FREEBSD) || defined(GTEST_OS_GNU_KFREEBSD)
152 #define KP_NLWP(kp) (kp.ki_numthreads)
153 #elif defined(GTEST_OS_NETBSD)
154 #define KP_NLWP(kp) (kp.p_nlwps)
155 #endif
156 
157 // Returns the number of threads running in the process, or 0 to indicate that
158 // we cannot detect it.
159 size_t GetThreadCount() {
160  int mib[] = {
161  CTL_KERN,
162  KERN_PROC,
163  KERN_PROC_PID,
164  getpid(),
165 #ifdef GTEST_OS_NETBSD
166  sizeof(struct kinfo_proc),
167  1,
168 #endif
169  };
170  u_int miblen = sizeof(mib) / sizeof(mib[0]);
171  struct kinfo_proc info;
172  size_t size = sizeof(info);
173  if (sysctl(mib, miblen, &info, &size, NULL, 0)) {
174  return 0;
175  }
176  return static_cast<size_t>(KP_NLWP(info));
177 }
178 #elif defined(GTEST_OS_OPENBSD)
179 
180 // Returns the number of threads running in the process, or 0 to indicate that
181 // we cannot detect it.
182 size_t GetThreadCount() {
183  int mib[] = {
184  CTL_KERN,
185  KERN_PROC,
186  KERN_PROC_PID | KERN_PROC_SHOW_THREADS,
187  getpid(),
188  sizeof(struct kinfo_proc),
189  0,
190  };
191  u_int miblen = sizeof(mib) / sizeof(mib[0]);
192 
193  // get number of structs
194  size_t size;
195  if (sysctl(mib, miblen, NULL, &size, NULL, 0)) {
196  return 0;
197  }
198 
199  mib[5] = static_cast<int>(size / static_cast<size_t>(mib[4]));
200 
201  // populate array of structs
202  std::vector<struct kinfo_proc> info(mib[5]);
203  if (sysctl(mib, miblen, info.data(), &size, NULL, 0)) {
204  return 0;
205  }
206 
207  // exclude empty members
208  size_t nthreads = 0;
209  for (size_t i = 0; i < size / static_cast<size_t>(mib[4]); i++) {
210  if (info[i].p_tid != -1) nthreads++;
211  }
212  return nthreads;
213 }
214 
215 #elif defined(GTEST_OS_QNX)
216 
217 // Returns the number of threads running in the process, or 0 to indicate that
218 // we cannot detect it.
219 size_t GetThreadCount() {
220  const int fd = open("/proc/self/as", O_RDONLY);
221  if (fd < 0) {
222  return 0;
223  }
224  procfs_info process_info;
225  const int status =
226  devctl(fd, DCMD_PROC_INFO, &process_info, sizeof(process_info), nullptr);
227  close(fd);
228  if (status == EOK) {
229  return static_cast<size_t>(process_info.num_threads);
230  } else {
231  return 0;
232  }
233 }
234 
235 #elif defined(GTEST_OS_AIX)
236 
237 size_t GetThreadCount() {
238  struct procentry64 entry;
239  pid_t pid = getpid();
240  int status = getprocs64(&entry, sizeof(entry), nullptr, 0, &pid, 1);
241  if (status == 1) {
242  return entry.pi_thcount;
243  } else {
244  return 0;
245  }
246 }
247 
248 #elif defined(GTEST_OS_FUCHSIA)
249 
250 size_t GetThreadCount() {
251  int dummy_buffer;
252  size_t avail;
253  zx_status_t status =
254  zx_object_get_info(zx_process_self(), ZX_INFO_PROCESS_THREADS,
255  &dummy_buffer, 0, nullptr, &avail);
256  if (status == ZX_OK) {
257  return avail;
258  } else {
259  return 0;
260  }
261 }
262 
263 #else
264 
265 size_t GetThreadCount() {
266  // There's no portable way to detect the number of threads, so we just
267  // return 0 to indicate that we cannot detect it.
268  return 0;
269 }
270 
271 #endif // GTEST_OS_LINUX
272 
273 #if defined(GTEST_IS_THREADSAFE) && defined(GTEST_OS_WINDOWS)
274 
275 AutoHandle::AutoHandle() : handle_(INVALID_HANDLE_VALUE) {}
276 
277 AutoHandle::AutoHandle(Handle handle) : handle_(handle) {}
278 
279 AutoHandle::~AutoHandle() { Reset(); }
280 
281 AutoHandle::Handle AutoHandle::Get() const { return handle_; }
282 
283 void AutoHandle::Reset() { Reset(INVALID_HANDLE_VALUE); }
284 
285 void AutoHandle::Reset(HANDLE handle) {
286  // Resetting with the same handle we already own is invalid.
287  if (handle_ != handle) {
288  if (IsCloseable()) {
289  ::CloseHandle(handle_);
290  }
291  handle_ = handle;
292  } else {
293  GTEST_CHECK_(!IsCloseable())
294  << "Resetting a valid handle to itself is likely a programmer error "
295  "and thus not allowed.";
296  }
297 }
298 
299 bool AutoHandle::IsCloseable() const {
300  // Different Windows APIs may use either of these values to represent an
301  // invalid handle.
302  return handle_ != nullptr && handle_ != INVALID_HANDLE_VALUE;
303 }
304 
305 Mutex::Mutex()
306  : owner_thread_id_(0),
307  type_(kDynamic),
308  critical_section_init_phase_(0),
309  critical_section_(new CRITICAL_SECTION) {
310  ::InitializeCriticalSection(critical_section_);
311 }
312 
313 Mutex::~Mutex() {
314  // Static mutexes are leaked intentionally. It is not thread-safe to try
315  // to clean them up.
316  if (type_ == kDynamic) {
317  ::DeleteCriticalSection(critical_section_);
318  delete critical_section_;
319  critical_section_ = nullptr;
320  }
321 }
322 
323 void Mutex::Lock() {
324  ThreadSafeLazyInit();
325  ::EnterCriticalSection(critical_section_);
326  owner_thread_id_ = ::GetCurrentThreadId();
327 }
328 
329 void Mutex::Unlock() {
330  ThreadSafeLazyInit();
331  // We don't protect writing to owner_thread_id_ here, as it's the
332  // caller's responsibility to ensure that the current thread holds the
333  // mutex when this is called.
334  owner_thread_id_ = 0;
335  ::LeaveCriticalSection(critical_section_);
336 }
337 
338 // Does nothing if the current thread holds the mutex. Otherwise, crashes
339 // with high probability.
340 void Mutex::AssertHeld() {
341  ThreadSafeLazyInit();
342  GTEST_CHECK_(owner_thread_id_ == ::GetCurrentThreadId())
343  << "The current thread is not holding the mutex @" << this;
344 }
345 
346 namespace {
347 
348 #ifdef _MSC_VER
349 // Use the RAII idiom to flag mem allocs that are intentionally never
350 // deallocated. The motivation is to silence the false positive mem leaks
351 // that are reported by the debug version of MS's CRT which can only detect
352 // if an alloc is missing a matching deallocation.
353 // Example:
354 // MemoryIsNotDeallocated memory_is_not_deallocated;
355 // critical_section_ = new CRITICAL_SECTION;
356 //
357 class MemoryIsNotDeallocated {
358  public:
359  MemoryIsNotDeallocated() : old_crtdbg_flag_(0) {
360  old_crtdbg_flag_ = _CrtSetDbgFlag(_CRTDBG_REPORT_FLAG);
361  // Set heap allocation block type to _IGNORE_BLOCK so that MS debug CRT
362  // doesn't report mem leak if there's no matching deallocation.
363  (void)_CrtSetDbgFlag(old_crtdbg_flag_ & ~_CRTDBG_ALLOC_MEM_DF);
364  }
365 
366  ~MemoryIsNotDeallocated() {
367  // Restore the original _CRTDBG_ALLOC_MEM_DF flag
368  (void)_CrtSetDbgFlag(old_crtdbg_flag_);
369  }
370 
371  private:
372  int old_crtdbg_flag_;
373 
374  MemoryIsNotDeallocated(const MemoryIsNotDeallocated&) = delete;
375  MemoryIsNotDeallocated& operator=(const MemoryIsNotDeallocated&) = delete;
376 };
377 #endif // _MSC_VER
378 
379 } // namespace
380 
381 // Initializes owner_thread_id_ and critical_section_ in static mutexes.
382 void Mutex::ThreadSafeLazyInit() {
383  // Dynamic mutexes are initialized in the constructor.
384  if (type_ == kStatic) {
385  switch (
386  ::InterlockedCompareExchange(&critical_section_init_phase_, 1L, 0L)) {
387  case 0:
388  // If critical_section_init_phase_ was 0 before the exchange, we
389  // are the first to test it and need to perform the initialization.
390  owner_thread_id_ = 0;
391  {
392  // Use RAII to flag that following mem alloc is never deallocated.
393 #ifdef _MSC_VER
394  MemoryIsNotDeallocated memory_is_not_deallocated;
395 #endif // _MSC_VER
396  critical_section_ = new CRITICAL_SECTION;
397  }
398  ::InitializeCriticalSection(critical_section_);
399  // Updates the critical_section_init_phase_ to 2 to signal
400  // initialization complete.
401  GTEST_CHECK_(::InterlockedCompareExchange(&critical_section_init_phase_,
402  2L, 1L) == 1L);
403  break;
404  case 1:
405  // Somebody else is already initializing the mutex; spin until they
406  // are done.
407  while (::InterlockedCompareExchange(&critical_section_init_phase_, 2L,
408  2L) != 2L) {
409  // Possibly yields the rest of the thread's time slice to other
410  // threads.
411  ::Sleep(0);
412  }
413  break;
414 
415  case 2:
416  break; // The mutex is already initialized and ready for use.
417 
418  default:
419  GTEST_CHECK_(false)
420  << "Unexpected value of critical_section_init_phase_ "
421  << "while initializing a static mutex.";
422  }
423  }
424 }
425 
426 namespace {
427 
428 class ThreadWithParamSupport : public ThreadWithParamBase {
429  public:
430  static HANDLE CreateThread(Runnable* runnable,
431  Notification* thread_can_start) {
432  ThreadMainParam* param = new ThreadMainParam(runnable, thread_can_start);
433  DWORD thread_id;
434  HANDLE thread_handle = ::CreateThread(
435  nullptr, // Default security.
436  0, // Default stack size.
437  &ThreadWithParamSupport::ThreadMain,
438  param, // Parameter to ThreadMainStatic
439  0x0, // Default creation flags.
440  &thread_id); // Need a valid pointer for the call to work under Win98.
441  GTEST_CHECK_(thread_handle != nullptr)
442  << "CreateThread failed with error " << ::GetLastError() << ".";
443  if (thread_handle == nullptr) {
444  delete param;
445  }
446  return thread_handle;
447  }
448 
449  private:
450  struct ThreadMainParam {
451  ThreadMainParam(Runnable* runnable, Notification* thread_can_start)
452  : runnable_(runnable), thread_can_start_(thread_can_start) {}
453  std::unique_ptr<Runnable> runnable_;
454  // Does not own.
455  Notification* thread_can_start_;
456  };
457 
458  static DWORD WINAPI ThreadMain(void* ptr) {
459  // Transfers ownership.
460  std::unique_ptr<ThreadMainParam> param(static_cast<ThreadMainParam*>(ptr));
461  if (param->thread_can_start_ != nullptr)
462  param->thread_can_start_->WaitForNotification();
463  param->runnable_->Run();
464  return 0;
465  }
466 
467  // Prohibit instantiation.
468  ThreadWithParamSupport();
469 
470  ThreadWithParamSupport(const ThreadWithParamSupport&) = delete;
471  ThreadWithParamSupport& operator=(const ThreadWithParamSupport&) = delete;
472 };
473 
474 } // namespace
475 
476 ThreadWithParamBase::ThreadWithParamBase(Runnable* runnable,
477  Notification* thread_can_start)
478  : thread_(
479  ThreadWithParamSupport::CreateThread(runnable, thread_can_start)) {}
480 
481 ThreadWithParamBase::~ThreadWithParamBase() { Join(); }
482 
483 void ThreadWithParamBase::Join() {
484  GTEST_CHECK_(::WaitForSingleObject(thread_.Get(), INFINITE) == WAIT_OBJECT_0)
485  << "Failed to join the thread with error " << ::GetLastError() << ".";
486 }
487 
488 // Maps a thread to a set of ThreadIdToThreadLocals that have values
489 // instantiated on that thread and notifies them when the thread exits. A
490 // ThreadLocal instance is expected to persist until all threads it has
491 // values on have terminated.
492 class ThreadLocalRegistryImpl {
493  public:
494  // Registers thread_local_instance as having value on the current thread.
495  // Returns a value that can be used to identify the thread from other threads.
496  static ThreadLocalValueHolderBase* GetValueOnCurrentThread(
497  const ThreadLocalBase* thread_local_instance) {
498 #ifdef _MSC_VER
499  MemoryIsNotDeallocated memory_is_not_deallocated;
500 #endif // _MSC_VER
501  DWORD current_thread = ::GetCurrentThreadId();
502  MutexLock lock(&mutex_);
503  ThreadIdToThreadLocals* const thread_to_thread_locals =
504  GetThreadLocalsMapLocked();
505  ThreadIdToThreadLocals::iterator thread_local_pos =
506  thread_to_thread_locals->find(current_thread);
507  if (thread_local_pos == thread_to_thread_locals->end()) {
508  thread_local_pos =
509  thread_to_thread_locals
510  ->insert(std::make_pair(current_thread, ThreadLocalValues()))
511  .first;
512  StartWatcherThreadFor(current_thread);
513  }
514  ThreadLocalValues& thread_local_values = thread_local_pos->second;
515  ThreadLocalValues::iterator value_pos =
516  thread_local_values.find(thread_local_instance);
517  if (value_pos == thread_local_values.end()) {
518  value_pos =
519  thread_local_values
520  .insert(std::make_pair(
521  thread_local_instance,
522  std::shared_ptr<ThreadLocalValueHolderBase>(
523  thread_local_instance->NewValueForCurrentThread())))
524  .first;
525  }
526  return value_pos->second.get();
527  }
528 
529  static void OnThreadLocalDestroyed(
530  const ThreadLocalBase* thread_local_instance) {
531  std::vector<std::shared_ptr<ThreadLocalValueHolderBase> > value_holders;
532  // Clean up the ThreadLocalValues data structure while holding the lock, but
533  // defer the destruction of the ThreadLocalValueHolderBases.
534  {
535  MutexLock lock(&mutex_);
536  ThreadIdToThreadLocals* const thread_to_thread_locals =
537  GetThreadLocalsMapLocked();
538  for (ThreadIdToThreadLocals::iterator it =
539  thread_to_thread_locals->begin();
540  it != thread_to_thread_locals->end(); ++it) {
541  ThreadLocalValues& thread_local_values = it->second;
542  ThreadLocalValues::iterator value_pos =
543  thread_local_values.find(thread_local_instance);
544  if (value_pos != thread_local_values.end()) {
545  value_holders.push_back(value_pos->second);
546  thread_local_values.erase(value_pos);
547  // This 'if' can only be successful at most once, so theoretically we
548  // could break out of the loop here, but we don't bother doing so.
549  }
550  }
551  }
552  // Outside the lock, let the destructor for 'value_holders' deallocate the
553  // ThreadLocalValueHolderBases.
554  }
555 
556  static void OnThreadExit(DWORD thread_id) {
557  GTEST_CHECK_(thread_id != 0) << ::GetLastError();
558  std::vector<std::shared_ptr<ThreadLocalValueHolderBase> > value_holders;
559  // Clean up the ThreadIdToThreadLocals data structure while holding the
560  // lock, but defer the destruction of the ThreadLocalValueHolderBases.
561  {
562  MutexLock lock(&mutex_);
563  ThreadIdToThreadLocals* const thread_to_thread_locals =
564  GetThreadLocalsMapLocked();
565  ThreadIdToThreadLocals::iterator thread_local_pos =
566  thread_to_thread_locals->find(thread_id);
567  if (thread_local_pos != thread_to_thread_locals->end()) {
568  ThreadLocalValues& thread_local_values = thread_local_pos->second;
569  for (ThreadLocalValues::iterator value_pos =
570  thread_local_values.begin();
571  value_pos != thread_local_values.end(); ++value_pos) {
572  value_holders.push_back(value_pos->second);
573  }
574  thread_to_thread_locals->erase(thread_local_pos);
575  }
576  }
577  // Outside the lock, let the destructor for 'value_holders' deallocate the
578  // ThreadLocalValueHolderBases.
579  }
580 
581  private:
582  // In a particular thread, maps a ThreadLocal object to its value.
583  typedef std::map<const ThreadLocalBase*,
584  std::shared_ptr<ThreadLocalValueHolderBase> >
585  ThreadLocalValues;
586  // Stores all ThreadIdToThreadLocals having values in a thread, indexed by
587  // thread's ID.
588  typedef std::map<DWORD, ThreadLocalValues> ThreadIdToThreadLocals;
589 
590  struct WatcherThreadParams {
591  DWORD thread_id;
592  HANDLE handle;
593  Notification has_initialized;
594  };
595 
596  static void StartWatcherThreadFor(DWORD thread_id) {
597  // The returned handle will be kept in thread_map and closed by
598  // watcher_thread in WatcherThreadFunc.
599  HANDLE thread =
600  ::OpenThread(SYNCHRONIZE | THREAD_QUERY_INFORMATION, FALSE, thread_id);
601  GTEST_CHECK_(thread != nullptr);
602 
603  WatcherThreadParams* watcher_thread_params = new WatcherThreadParams;
604  watcher_thread_params->thread_id = thread_id;
605  watcher_thread_params->handle = thread;
606 
607  // We need to pass a valid thread ID pointer into CreateThread for it
608  // to work correctly under Win98.
609  DWORD watcher_thread_id;
610  HANDLE watcher_thread =
611  ::CreateThread(nullptr, // Default security.
612  0, // Default stack size
613  &ThreadLocalRegistryImpl::WatcherThreadFunc,
614  reinterpret_cast<LPVOID>(watcher_thread_params),
615  CREATE_SUSPENDED, &watcher_thread_id);
616  GTEST_CHECK_(watcher_thread != nullptr)
617  << "CreateThread failed with error " << ::GetLastError() << ".";
618  // Give the watcher thread the same priority as ours to avoid being
619  // blocked by it.
620  ::SetThreadPriority(watcher_thread,
621  ::GetThreadPriority(::GetCurrentThread()));
622  ::ResumeThread(watcher_thread);
623  ::CloseHandle(watcher_thread);
624 
625  // Wait for the watcher thread to start to avoid race conditions.
626  // One specific race condition that can happen is that we have returned
627  // from main and have started to tear down, the newly spawned watcher
628  // thread may access already-freed variables, like global shared_ptrs.
629  watcher_thread_params->has_initialized.WaitForNotification();
630  }
631 
632  // Monitors exit from a given thread and notifies those
633  // ThreadIdToThreadLocals about thread termination.
634  static DWORD WINAPI WatcherThreadFunc(LPVOID param) {
635  WatcherThreadParams* watcher_thread_params =
636  reinterpret_cast<WatcherThreadParams*>(param);
637  watcher_thread_params->has_initialized.Notify();
638  GTEST_CHECK_(::WaitForSingleObject(watcher_thread_params->handle,
639  INFINITE) == WAIT_OBJECT_0);
640  OnThreadExit(watcher_thread_params->thread_id);
641  ::CloseHandle(watcher_thread_params->handle);
642  delete watcher_thread_params;
643  return 0;
644  }
645 
646  // Returns map of thread local instances.
647  static ThreadIdToThreadLocals* GetThreadLocalsMapLocked() {
648  mutex_.AssertHeld();
649 #ifdef _MSC_VER
650  MemoryIsNotDeallocated memory_is_not_deallocated;
651 #endif // _MSC_VER
652  static ThreadIdToThreadLocals* map = new ThreadIdToThreadLocals();
653  return map;
654  }
655 
656  // Protects access to GetThreadLocalsMapLocked() and its return value.
657  static Mutex mutex_;
658  // Protects access to GetThreadMapLocked() and its return value.
659  static Mutex thread_map_mutex_;
660 };
661 
662 Mutex ThreadLocalRegistryImpl::mutex_(Mutex::kStaticMutex); // NOLINT
663 Mutex ThreadLocalRegistryImpl::thread_map_mutex_(
664  Mutex::kStaticMutex); // NOLINT
665 
666 ThreadLocalValueHolderBase* ThreadLocalRegistry::GetValueOnCurrentThread(
667  const ThreadLocalBase* thread_local_instance) {
668  return ThreadLocalRegistryImpl::GetValueOnCurrentThread(
669  thread_local_instance);
670 }
671 
672 void ThreadLocalRegistry::OnThreadLocalDestroyed(
673  const ThreadLocalBase* thread_local_instance) {
674  ThreadLocalRegistryImpl::OnThreadLocalDestroyed(thread_local_instance);
675 }
676 
677 #endif // GTEST_IS_THREADSAFE && GTEST_OS_WINDOWS
678 
679 #ifdef GTEST_USES_POSIX_RE
680 
681 // Implements RE. Currently only needed for death tests.
682 
683 RE::~RE() {
684  if (is_valid_) {
685  // regfree'ing an invalid regex might crash because the content
686  // of the regex is undefined. Since the regex's are essentially
687  // the same, one cannot be valid (or invalid) without the other
688  // being so too.
689  regfree(&partial_regex_);
690  regfree(&full_regex_);
691  }
692 }
693 
694 // Returns true if and only if regular expression re matches the entire str.
695 bool RE::FullMatch(const char* str, const RE& re) {
696  if (!re.is_valid_) return false;
697 
698  regmatch_t match;
699  return regexec(&re.full_regex_, str, 1, &match, 0) == 0;
700 }
701 
702 // Returns true if and only if regular expression re matches a substring of
703 // str (including str itself).
704 bool RE::PartialMatch(const char* str, const RE& re) {
705  if (!re.is_valid_) return false;
706 
707  regmatch_t match;
708  return regexec(&re.partial_regex_, str, 1, &match, 0) == 0;
709 }
710 
711 // Initializes an RE from its string representation.
712 void RE::Init(const char* regex) {
713  pattern_ = regex;
714 
715  // NetBSD (and Android, which takes its regex implemntation from NetBSD) does
716  // not include the GNU regex extensions (such as Perl style character classes
717  // like \w) in REG_EXTENDED. REG_EXTENDED is only specified to include the
718  // [[:alpha:]] style character classes. Enable REG_GNU wherever it is defined
719  // so users can use those extensions.
720 #if defined(REG_GNU)
721  constexpr int reg_flags = REG_EXTENDED | REG_GNU;
722 #else
723  constexpr int reg_flags = REG_EXTENDED;
724 #endif
725 
726  // Reserves enough bytes to hold the regular expression used for a
727  // full match.
728  const size_t full_regex_len = strlen(regex) + 10;
729  char* const full_pattern = new char[full_regex_len];
730 
731  snprintf(full_pattern, full_regex_len, "^(%s)$", regex);
732  is_valid_ = regcomp(&full_regex_, full_pattern, reg_flags) == 0;
733  // We want to call regcomp(&partial_regex_, ...) even if the
734  // previous expression returns false. Otherwise partial_regex_ may
735  // not be properly initialized can may cause trouble when it's
736  // freed.
737  //
738  // Some implementation of POSIX regex (e.g. on at least some
739  // versions of Cygwin) doesn't accept the empty string as a valid
740  // regex. We change it to an equivalent form "()" to be safe.
741  if (is_valid_) {
742  const char* const partial_regex = (*regex == '\0') ? "()" : regex;
743  is_valid_ = regcomp(&partial_regex_, partial_regex, reg_flags) == 0;
744  }
745  EXPECT_TRUE(is_valid_)
746  << "Regular expression \"" << regex
747  << "\" is not a valid POSIX Extended regular expression.";
748 
749  delete[] full_pattern;
750 }
751 
752 #elif defined(GTEST_USES_SIMPLE_RE)
753 
754 // Returns true if and only if ch appears anywhere in str (excluding the
755 // terminating '\0' character).
756 bool IsInSet(char ch, const char* str) {
757  return ch != '\0' && strchr(str, ch) != nullptr;
758 }
759 
760 // Returns true if and only if ch belongs to the given classification.
761 // Unlike similar functions in <ctype.h>, these aren't affected by the
762 // current locale.
763 bool IsAsciiDigit(char ch) { return '0' <= ch && ch <= '9'; }
764 bool IsAsciiPunct(char ch) {
765  return IsInSet(ch, "^-!\"#$%&'()*+,./:;<=>?@[\\]_`{|}~");
766 }
767 bool IsRepeat(char ch) { return IsInSet(ch, "?*+"); }
768 bool IsAsciiWhiteSpace(char ch) { return IsInSet(ch, " \f\n\r\t\v"); }
769 bool IsAsciiWordChar(char ch) {
770  return ('a' <= ch && ch <= 'z') || ('A' <= ch && ch <= 'Z') ||
771  ('0' <= ch && ch <= '9') || ch == '_';
772 }
773 
774 // Returns true if and only if "\\c" is a supported escape sequence.
775 bool IsValidEscape(char c) {
776  return (IsAsciiPunct(c) || IsInSet(c, "dDfnrsStvwW"));
777 }
778 
779 // Returns true if and only if the given atom (specified by escaped and
780 // pattern) matches ch. The result is undefined if the atom is invalid.
781 bool AtomMatchesChar(bool escaped, char pattern_char, char ch) {
782  if (escaped) { // "\\p" where p is pattern_char.
783  switch (pattern_char) {
784  case 'd':
785  return IsAsciiDigit(ch);
786  case 'D':
787  return !IsAsciiDigit(ch);
788  case 'f':
789  return ch == '\f';
790  case 'n':
791  return ch == '\n';
792  case 'r':
793  return ch == '\r';
794  case 's':
795  return IsAsciiWhiteSpace(ch);
796  case 'S':
797  return !IsAsciiWhiteSpace(ch);
798  case 't':
799  return ch == '\t';
800  case 'v':
801  return ch == '\v';
802  case 'w':
803  return IsAsciiWordChar(ch);
804  case 'W':
805  return !IsAsciiWordChar(ch);
806  }
807  return IsAsciiPunct(pattern_char) && pattern_char == ch;
808  }
809 
810  return (pattern_char == '.' && ch != '\n') || pattern_char == ch;
811 }
812 
813 // Helper function used by ValidateRegex() to format error messages.
814 static std::string FormatRegexSyntaxError(const char* regex, int index) {
815  return (Message() << "Syntax error at index " << index
816  << " in simple regular expression \"" << regex << "\": ")
817  .GetString();
818 }
819 
820 // Generates non-fatal failures and returns false if regex is invalid;
821 // otherwise returns true.
822 bool ValidateRegex(const char* regex) {
823  if (regex == nullptr) {
824  ADD_FAILURE() << "NULL is not a valid simple regular expression.";
825  return false;
826  }
827 
828  bool is_valid = true;
829 
830  // True if and only if ?, *, or + can follow the previous atom.
831  bool prev_repeatable = false;
832  for (int i = 0; regex[i]; i++) {
833  if (regex[i] == '\\') { // An escape sequence
834  i++;
835  if (regex[i] == '\0') {
836  ADD_FAILURE() << FormatRegexSyntaxError(regex, i - 1)
837  << "'\\' cannot appear at the end.";
838  return false;
839  }
840 
841  if (!IsValidEscape(regex[i])) {
842  ADD_FAILURE() << FormatRegexSyntaxError(regex, i - 1)
843  << "invalid escape sequence \"\\" << regex[i] << "\".";
844  is_valid = false;
845  }
846  prev_repeatable = true;
847  } else { // Not an escape sequence.
848  const char ch = regex[i];
849 
850  if (ch == '^' && i > 0) {
851  ADD_FAILURE() << FormatRegexSyntaxError(regex, i)
852  << "'^' can only appear at the beginning.";
853  is_valid = false;
854  } else if (ch == '$' && regex[i + 1] != '\0') {
855  ADD_FAILURE() << FormatRegexSyntaxError(regex, i)
856  << "'$' can only appear at the end.";
857  is_valid = false;
858  } else if (IsInSet(ch, "()[]{}|")) {
859  ADD_FAILURE() << FormatRegexSyntaxError(regex, i) << "'" << ch
860  << "' is unsupported.";
861  is_valid = false;
862  } else if (IsRepeat(ch) && !prev_repeatable) {
863  ADD_FAILURE() << FormatRegexSyntaxError(regex, i) << "'" << ch
864  << "' can only follow a repeatable token.";
865  is_valid = false;
866  }
867 
868  prev_repeatable = !IsInSet(ch, "^$?*+");
869  }
870  }
871 
872  return is_valid;
873 }
874 
875 // Matches a repeated regex atom followed by a valid simple regular
876 // expression. The regex atom is defined as c if escaped is false,
877 // or \c otherwise. repeat is the repetition meta character (?, *,
878 // or +). The behavior is undefined if str contains too many
879 // characters to be indexable by size_t, in which case the test will
880 // probably time out anyway. We are fine with this limitation as
881 // std::string has it too.
882 bool MatchRepetitionAndRegexAtHead(bool escaped, char c, char repeat,
883  const char* regex, const char* str) {
884  const size_t min_count = (repeat == '+') ? 1 : 0;
885  const size_t max_count = (repeat == '?') ? 1 : static_cast<size_t>(-1) - 1;
886  // We cannot call numeric_limits::max() as it conflicts with the
887  // max() macro on Windows.
888 
889  for (size_t i = 0; i <= max_count; ++i) {
890  // We know that the atom matches each of the first i characters in str.
891  if (i >= min_count && MatchRegexAtHead(regex, str + i)) {
892  // We have enough matches at the head, and the tail matches too.
893  // Since we only care about *whether* the pattern matches str
894  // (as opposed to *how* it matches), there is no need to find a
895  // greedy match.
896  return true;
897  }
898  if (str[i] == '\0' || !AtomMatchesChar(escaped, c, str[i])) return false;
899  }
900  return false;
901 }
902 
903 // Returns true if and only if regex matches a prefix of str. regex must
904 // be a valid simple regular expression and not start with "^", or the
905 // result is undefined.
906 bool MatchRegexAtHead(const char* regex, const char* str) {
907  if (*regex == '\0') // An empty regex matches a prefix of anything.
908  return true;
909 
910  // "$" only matches the end of a string. Note that regex being
911  // valid guarantees that there's nothing after "$" in it.
912  if (*regex == '$') return *str == '\0';
913 
914  // Is the first thing in regex an escape sequence?
915  const bool escaped = *regex == '\\';
916  if (escaped) ++regex;
917  if (IsRepeat(regex[1])) {
918  // MatchRepetitionAndRegexAtHead() calls MatchRegexAtHead(), so
919  // here's an indirect recursion. It terminates as the regex gets
920  // shorter in each recursion.
921  return MatchRepetitionAndRegexAtHead(escaped, regex[0], regex[1], regex + 2,
922  str);
923  } else {
924  // regex isn't empty, isn't "$", and doesn't start with a
925  // repetition. We match the first atom of regex with the first
926  // character of str and recurse.
927  return (*str != '\0') && AtomMatchesChar(escaped, *regex, *str) &&
928  MatchRegexAtHead(regex + 1, str + 1);
929  }
930 }
931 
932 // Returns true if and only if regex matches any substring of str. regex must
933 // be a valid simple regular expression, or the result is undefined.
934 //
935 // The algorithm is recursive, but the recursion depth doesn't exceed
936 // the regex length, so we won't need to worry about running out of
937 // stack space normally. In rare cases the time complexity can be
938 // exponential with respect to the regex length + the string length,
939 // but usually it's must faster (often close to linear).
940 bool MatchRegexAnywhere(const char* regex, const char* str) {
941  if (regex == nullptr || str == nullptr) return false;
942 
943  if (*regex == '^') return MatchRegexAtHead(regex + 1, str);
944 
945  // A successful match can be anywhere in str.
946  do {
947  if (MatchRegexAtHead(regex, str)) return true;
948  } while (*str++ != '\0');
949  return false;
950 }
951 
952 // Implements the RE class.
953 
954 RE::~RE() = default;
955 
956 // Returns true if and only if regular expression re matches the entire str.
957 bool RE::FullMatch(const char* str, const RE& re) {
958  return re.is_valid_ && MatchRegexAnywhere(re.full_pattern_.c_str(), str);
959 }
960 
961 // Returns true if and only if regular expression re matches a substring of
962 // str (including str itself).
963 bool RE::PartialMatch(const char* str, const RE& re) {
964  return re.is_valid_ && MatchRegexAnywhere(re.pattern_.c_str(), str);
965 }
966 
967 // Initializes an RE from its string representation.
968 void RE::Init(const char* regex) {
969  full_pattern_.clear();
970  pattern_.clear();
971 
972  if (regex != nullptr) {
973  pattern_ = regex;
974  }
975 
976  is_valid_ = ValidateRegex(regex);
977  if (!is_valid_) {
978  // No need to calculate the full pattern when the regex is invalid.
979  return;
980  }
981 
982  // Reserves enough bytes to hold the regular expression used for a
983  // full match: we need space to prepend a '^' and append a '$'.
984  full_pattern_.reserve(pattern_.size() + 2);
985 
986  if (pattern_.empty() || pattern_.front() != '^') {
987  full_pattern_.push_back('^'); // Makes sure full_pattern_ starts with '^'.
988  }
989 
990  full_pattern_.append(pattern_);
991 
992  if (pattern_.empty() || pattern_.back() != '$') {
993  full_pattern_.push_back('$'); // Makes sure full_pattern_ ends with '$'.
994  }
995 }
996 
997 #endif // GTEST_USES_POSIX_RE
998 
999 const char kUnknownFile[] = "unknown file";
1000 
1001 // Formats a source file path and a line number as they would appear
1002 // in an error message from the compiler used to compile this code.
1003 GTEST_API_ ::std::string FormatFileLocation(const char* file, int line) {
1004  const std::string file_name(file == nullptr ? kUnknownFile : file);
1005 
1006  if (line < 0) {
1007  return file_name + ":";
1008  }
1009 #ifdef _MSC_VER
1010  return file_name + "(" + StreamableToString(line) + "):";
1011 #else
1012  return file_name + ":" + StreamableToString(line) + ":";
1013 #endif // _MSC_VER
1014 }
1015 
1016 // Formats a file location for compiler-independent XML output.
1017 // Although this function is not platform dependent, we put it next to
1018 // FormatFileLocation in order to contrast the two functions.
1019 // Note that FormatCompilerIndependentFileLocation() does NOT append colon
1020 // to the file location it produces, unlike FormatFileLocation().
1021 GTEST_API_ ::std::string FormatCompilerIndependentFileLocation(const char* file,
1022  int line) {
1023  const std::string file_name(file == nullptr ? kUnknownFile : file);
1024 
1025  if (line < 0)
1026  return file_name;
1027  else
1028  return file_name + ":" + StreamableToString(line);
1029 }
1030 
1031 GTestLog::GTestLog(GTestLogSeverity severity, const char* file, int line)
1032  : severity_(severity) {
1033  const char* const marker = severity == GTEST_INFO ? "[ INFO ]"
1034  : severity == GTEST_WARNING ? "[WARNING]"
1035  : severity == GTEST_ERROR ? "[ ERROR ]"
1036  : "[ FATAL ]";
1037  GetStream() << ::std::endl
1038  << marker << " " << FormatFileLocation(file, line).c_str()
1039  << ": ";
1040 }
1041 
1042 // Flushes the buffers and, if severity is GTEST_FATAL, aborts the program.
1044  GetStream() << ::std::endl;
1045  if (severity_ == GTEST_FATAL) {
1046  fflush(stderr);
1047  posix::Abort();
1048  }
1049 }
1050 
1051 #if GTEST_HAS_STREAM_REDIRECTION
1052 
1053 // Disable Microsoft deprecation warnings for POSIX functions called from
1054 // this class (creat, dup, dup2, and close)
1056 
1057 namespace {
1058 
1059 #if defined(GTEST_OS_LINUX_ANDROID) || defined(GTEST_OS_IOS)
1060 bool EndsWithPathSeparator(const std::string& path) {
1061  return !path.empty() && path.back() == GTEST_PATH_SEP_[0];
1062 }
1063 #endif
1064 
1065 } // namespace
1066 
1067 // Object that captures an output stream (stdout/stderr).
1068 class CapturedStream {
1069  public:
1070  // The ctor redirects the stream to a temporary file.
1071  explicit CapturedStream(int fd) : fd_(fd), uncaptured_fd_(dup(fd)) {
1072 #ifdef GTEST_OS_WINDOWS
1073  char temp_dir_path[MAX_PATH + 1] = {'\0'}; // NOLINT
1074  char temp_file_path[MAX_PATH + 1] = {'\0'}; // NOLINT
1075 
1076  ::GetTempPathA(sizeof(temp_dir_path), temp_dir_path);
1077  const UINT success = ::GetTempFileNameA(temp_dir_path, "gtest_redir",
1078  0, // Generate unique file name.
1079  temp_file_path);
1080  GTEST_CHECK_(success != 0)
1081  << "Unable to create a temporary file in " << temp_dir_path;
1082  const int captured_fd = creat(temp_file_path, _S_IREAD | _S_IWRITE);
1083  GTEST_CHECK_(captured_fd != -1)
1084  << "Unable to open temporary file " << temp_file_path;
1085  filename_ = temp_file_path;
1086 #else
1087  // There's no guarantee that a test has write access to the current
1088  // directory, so we create the temporary file in a temporary directory.
1089  std::string name_template;
1090 
1091 #ifdef GTEST_OS_LINUX_ANDROID
1092  // Note: Android applications are expected to call the framework's
1093  // Context.getExternalStorageDirectory() method through JNI to get
1094  // the location of the world-writable SD Card directory. However,
1095  // this requires a Context handle, which cannot be retrieved
1096  // globally from native code. Doing so also precludes running the
1097  // code as part of a regular standalone executable, which doesn't
1098  // run in a Dalvik process (e.g. when running it through 'adb shell').
1099  //
1100  // The location /data/local/tmp is directly accessible from native code.
1101  // '/sdcard' and other variants cannot be relied on, as they are not
1102  // guaranteed to be mounted, or may have a delay in mounting.
1103  //
1104  // However, prefer using the TMPDIR environment variable if set, as newer
1105  // devices may have /data/local/tmp read-only.
1106  name_template = TempDir();
1107  if (!EndsWithPathSeparator(name_template))
1108  name_template.push_back(GTEST_PATH_SEP_[0]);
1109 
1110 #elif defined(GTEST_OS_IOS)
1111  char user_temp_dir[PATH_MAX + 1];
1112 
1113  // Documented alternative to NSTemporaryDirectory() (for obtaining creating
1114  // a temporary directory) at
1115  // https://developer.apple.com/library/archive/documentation/Security/Conceptual/SecureCodingGuide/Articles/RaceConditions.html#//apple_ref/doc/uid/TP40002585-SW10
1116  //
1117  // _CS_DARWIN_USER_TEMP_DIR (as well as _CS_DARWIN_USER_CACHE_DIR) is not
1118  // documented in the confstr() man page at
1119  // https://developer.apple.com/library/archive/documentation/System/Conceptual/ManPages_iPhoneOS/man3/confstr.3.html#//apple_ref/doc/man/3/confstr
1120  // but are still available, according to the WebKit patches at
1121  // https://trac.webkit.org/changeset/262004/webkit
1122  // https://trac.webkit.org/changeset/263705/webkit
1123  //
1124  // The confstr() implementation falls back to getenv("TMPDIR"). See
1125  // https://opensource.apple.com/source/Libc/Libc-1439.100.3/gen/confstr.c.auto.html
1126  ::confstr(_CS_DARWIN_USER_TEMP_DIR, user_temp_dir, sizeof(user_temp_dir));
1127 
1128  name_template = user_temp_dir;
1129  if (!EndsWithPathSeparator(name_template))
1130  name_template.push_back(GTEST_PATH_SEP_[0]);
1131 #else
1132  name_template = "/tmp/";
1133 #endif
1134  name_template.append("gtest_captured_stream.XXXXXX");
1135 
1136  // mkstemp() modifies the string bytes in place, and does not go beyond the
1137  // string's length. This results in well-defined behavior in C++17.
1138  //
1139  // The const_cast is needed below C++17. The constraints on std::string
1140  // implementations in C++11 and above make assumption behind the const_cast
1141  // fairly safe.
1142  const int captured_fd = ::mkstemp(const_cast<char*>(name_template.data()));
1143  if (captured_fd == -1) {
1144  GTEST_LOG_(WARNING)
1145  << "Failed to create tmp file " << name_template
1146  << " for test; does the test have access to the /tmp directory?";
1147  }
1148  filename_ = std::move(name_template);
1149 #endif // GTEST_OS_WINDOWS
1150  fflush(nullptr);
1151  dup2(captured_fd, fd_);
1152  close(captured_fd);
1153  }
1154 
1155  ~CapturedStream() { remove(filename_.c_str()); }
1156 
1157  std::string GetCapturedString() {
1158  if (uncaptured_fd_ != -1) {
1159  // Restores the original stream.
1160  fflush(nullptr);
1161  dup2(uncaptured_fd_, fd_);
1162  close(uncaptured_fd_);
1163  uncaptured_fd_ = -1;
1164  }
1165 
1166  FILE* const file = posix::FOpen(filename_.c_str(), "r");
1167  if (file == nullptr) {
1168  GTEST_LOG_(FATAL) << "Failed to open tmp file " << filename_
1169  << " for capturing stream.";
1170  }
1171  const std::string content = ReadEntireFile(file);
1172  posix::FClose(file);
1173  return content;
1174  }
1175 
1176  private:
1177  const int fd_; // A stream to capture.
1178  int uncaptured_fd_;
1179  // Name of the temporary file holding the stderr output.
1180  ::std::string filename_;
1181 
1182  CapturedStream(const CapturedStream&) = delete;
1183  CapturedStream& operator=(const CapturedStream&) = delete;
1184 };
1185 
1187 
1188 static CapturedStream* g_captured_stderr = nullptr;
1189 static CapturedStream* g_captured_stdout = nullptr;
1190 
1191 // Starts capturing an output stream (stdout/stderr).
1192 static void CaptureStream(int fd, const char* stream_name,
1193  CapturedStream** stream) {
1194  if (*stream != nullptr) {
1195  GTEST_LOG_(FATAL) << "Only one " << stream_name
1196  << " capturer can exist at a time.";
1197  }
1198  *stream = new CapturedStream(fd);
1199 }
1200 
1201 // Stops capturing the output stream and returns the captured string.
1202 static std::string GetCapturedStream(CapturedStream** captured_stream) {
1203  const std::string content = (*captured_stream)->GetCapturedString();
1204 
1205  delete *captured_stream;
1206  *captured_stream = nullptr;
1207 
1208  return content;
1209 }
1210 
1211 #if defined(_MSC_VER) || defined(__BORLANDC__)
1212 // MSVC and C++Builder do not provide a definition of STDERR_FILENO.
1213 const int kStdOutFileno = 1;
1214 const int kStdErrFileno = 2;
1215 #else
1216 const int kStdOutFileno = STDOUT_FILENO;
1217 const int kStdErrFileno = STDERR_FILENO;
1218 #endif // defined(_MSC_VER) || defined(__BORLANDC__)
1219 
1220 // Starts capturing stdout.
1221 void CaptureStdout() {
1222  CaptureStream(kStdOutFileno, "stdout", &g_captured_stdout);
1223 }
1224 
1225 // Starts capturing stderr.
1226 void CaptureStderr() {
1227  CaptureStream(kStdErrFileno, "stderr", &g_captured_stderr);
1228 }
1229 
1230 // Stops capturing stdout and returns the captured string.
1231 std::string GetCapturedStdout() {
1232  return GetCapturedStream(&g_captured_stdout);
1233 }
1234 
1235 // Stops capturing stderr and returns the captured string.
1236 std::string GetCapturedStderr() {
1237  return GetCapturedStream(&g_captured_stderr);
1238 }
1239 
1240 #endif // GTEST_HAS_STREAM_REDIRECTION
1241 
1242 size_t GetFileSize(FILE* file) {
1243  fseek(file, 0, SEEK_END);
1244  return static_cast<size_t>(ftell(file));
1245 }
1246 
1247 std::string ReadEntireFile(FILE* file) {
1248  const size_t file_size = GetFileSize(file);
1249  char* const buffer = new char[file_size];
1250 
1251  size_t bytes_last_read = 0; // # of bytes read in the last fread()
1252  size_t bytes_read = 0; // # of bytes read so far
1253 
1254  fseek(file, 0, SEEK_SET);
1255 
1256  // Keeps reading the file until we cannot read further or the
1257  // pre-determined file size is reached.
1258  do {
1259  bytes_last_read =
1260  fread(buffer + bytes_read, 1, file_size - bytes_read, file);
1261  bytes_read += bytes_last_read;
1262  } while (bytes_last_read > 0 && bytes_read < file_size);
1263 
1264  const std::string content(buffer, bytes_read);
1265  delete[] buffer;
1266 
1267  return content;
1268 }
1269 
1270 #ifdef GTEST_HAS_DEATH_TEST
1271 static const std::vector<std::string>* g_injected_test_argvs =
1272  nullptr; // Owned.
1273 
1274 std::vector<std::string> GetInjectableArgvs() {
1275  if (g_injected_test_argvs != nullptr) {
1276  return *g_injected_test_argvs;
1277  }
1278  return GetArgvs();
1279 }
1280 
1281 void SetInjectableArgvs(const std::vector<std::string>* new_argvs) {
1282  if (g_injected_test_argvs != new_argvs) delete g_injected_test_argvs;
1283  g_injected_test_argvs = new_argvs;
1284 }
1285 
1286 void SetInjectableArgvs(const std::vector<std::string>& new_argvs) {
1287  SetInjectableArgvs(
1288  new std::vector<std::string>(new_argvs.begin(), new_argvs.end()));
1289 }
1290 
1291 void ClearInjectableArgvs() {
1292  delete g_injected_test_argvs;
1293  g_injected_test_argvs = nullptr;
1294 }
1295 #endif // GTEST_HAS_DEATH_TEST
1296 
1297 #ifdef GTEST_OS_WINDOWS_MOBILE
1298 namespace posix {
1299 void Abort() {
1300  DebugBreak();
1301  TerminateProcess(GetCurrentProcess(), 1);
1302 }
1303 } // namespace posix
1304 #endif // GTEST_OS_WINDOWS_MOBILE
1305 
1306 // Returns the name of the environment variable corresponding to the
1307 // given flag. For example, FlagToEnvVar("foo") will return
1308 // "GTEST_FOO" in the open-source version.
1309 static std::string FlagToEnvVar(const char* flag) {
1310  const std::string full_flag =
1311  (Message() << GTEST_FLAG_PREFIX_ << flag).GetString();
1312 
1313  Message env_var;
1314  for (size_t i = 0; i != full_flag.length(); i++) {
1315  env_var << ToUpper(full_flag.c_str()[i]);
1316  }
1317 
1318  return env_var.GetString();
1319 }
1320 
1321 // Parses 'str' for a 32-bit signed integer. If successful, writes
1322 // the result to *value and returns true; otherwise leaves *value
1323 // unchanged and returns false.
1324 bool ParseInt32(const Message& src_text, const char* str, int32_t* value) {
1325  // Parses the environment variable as a decimal integer.
1326  char* end = nullptr;
1327  const long long_value = strtol(str, &end, 10); // NOLINT
1328 
1329  // Has strtol() consumed all characters in the string?
1330  if (*end != '\0') {
1331  // No - an invalid character was encountered.
1332  Message msg;
1333  msg << "WARNING: " << src_text
1334  << " is expected to be a 32-bit integer, but actually"
1335  << " has value \"" << str << "\".\n";
1336  printf("%s", msg.GetString().c_str());
1337  fflush(stdout);
1338  return false;
1339  }
1340 
1341  // Is the parsed value in the range of an int32_t?
1342  const auto result = static_cast<int32_t>(long_value);
1343  if (long_value == LONG_MAX || long_value == LONG_MIN ||
1344  // The parsed value overflows as a long. (strtol() returns
1345  // LONG_MAX or LONG_MIN when the input overflows.)
1346  result != long_value
1347  // The parsed value overflows as an int32_t.
1348  ) {
1349  Message msg;
1350  msg << "WARNING: " << src_text
1351  << " is expected to be a 32-bit integer, but actually" << " has value "
1352  << str << ", which overflows.\n";
1353  printf("%s", msg.GetString().c_str());
1354  fflush(stdout);
1355  return false;
1356  }
1357 
1358  *value = result;
1359  return true;
1360 }
1361 
1362 // Reads and returns the Boolean environment variable corresponding to
1363 // the given flag; if it's not set, returns default_value.
1364 //
1365 // The value is considered true if and only if it's not "0".
1366 bool BoolFromGTestEnv(const char* flag, bool default_value) {
1367 #if defined(GTEST_GET_BOOL_FROM_ENV_)
1368  return GTEST_GET_BOOL_FROM_ENV_(flag, default_value);
1369 #else
1370  const std::string env_var = FlagToEnvVar(flag);
1371  const char* const string_value = posix::GetEnv(env_var.c_str());
1372  return string_value == nullptr ? default_value
1373  : strcmp(string_value, "0") != 0;
1374 #endif // defined(GTEST_GET_BOOL_FROM_ENV_)
1375 }
1376 
1377 // Reads and returns a 32-bit integer stored in the environment
1378 // variable corresponding to the given flag; if it isn't set or
1379 // doesn't represent a valid 32-bit integer, returns default_value.
1380 int32_t Int32FromGTestEnv(const char* flag, int32_t default_value) {
1381 #if defined(GTEST_GET_INT32_FROM_ENV_)
1382  return GTEST_GET_INT32_FROM_ENV_(flag, default_value);
1383 #else
1384  const std::string env_var = FlagToEnvVar(flag);
1385  const char* const string_value = posix::GetEnv(env_var.c_str());
1386  if (string_value == nullptr) {
1387  // The environment variable is not set.
1388  return default_value;
1389  }
1390 
1391  int32_t result = default_value;
1392  if (!ParseInt32(Message() << "Environment variable " << env_var, string_value,
1393  &result)) {
1394  printf("The default value %s is used.\n",
1395  (Message() << default_value).GetString().c_str());
1396  fflush(stdout);
1397  return default_value;
1398  }
1399 
1400  return result;
1401 #endif // defined(GTEST_GET_INT32_FROM_ENV_)
1402 }
1403 
1404 // As a special case for the 'output' flag, if GTEST_OUTPUT is not
1405 // set, we look for XML_OUTPUT_FILE, which is set by the Bazel build
1406 // system. The value of XML_OUTPUT_FILE is a filename without the
1407 // "xml:" prefix of GTEST_OUTPUT.
1408 // Note that this is meant to be called at the call site so it does
1409 // not check that the flag is 'output'
1410 // In essence this checks an env variable called XML_OUTPUT_FILE
1411 // and if it is set we prepend "xml:" to its value, if it not set we return ""
1413  std::string default_value_for_output_flag = "";
1414  const char* xml_output_file_env = posix::GetEnv("XML_OUTPUT_FILE");
1415  if (nullptr != xml_output_file_env) {
1416  default_value_for_output_flag = std::string("xml:") + xml_output_file_env;
1417  }
1418  return default_value_for_output_flag;
1419 }
1420 
1421 // Reads and returns the string environment variable corresponding to
1422 // the given flag; if it's not set, returns default_value.
1423 const char* StringFromGTestEnv(const char* flag, const char* default_value) {
1424 #if defined(GTEST_GET_STRING_FROM_ENV_)
1425  return GTEST_GET_STRING_FROM_ENV_(flag, default_value);
1426 #else
1427  const std::string env_var = FlagToEnvVar(flag);
1428  const char* const value = posix::GetEnv(env_var.c_str());
1429  return value == nullptr ? default_value : value;
1430 #endif // defined(GTEST_GET_STRING_FROM_ENV_)
1431 }
1432 
1433 } // namespace internal
1434 } // namespace testing
#define GTEST_PATH_SEP_
Definition: gtest-port.h:1958
GTEST_API_ int32_t Int32FromGTestEnv(const char *flag, int32_t default_val)
Definition: gtest-port.cc:1380
GTEST_API_ std::string GetCapturedStdout()
GTEST_API_ std::string GetCapturedStderr()
#define GTEST_DISABLE_MSC_DEPRECATED_PUSH_()
Definition: gtest-port.h:390
const char * StringFromGTestEnv(const char *flag, const char *default_val)
Definition: gtest-port.cc:1423
#define GTEST_LOG_(severity)
Definition: gtest-port.h:1093
GTEST_API_ size_t GetThreadCount()
Definition: gtest-port.cc:265
const char * GetEnv(const char *name)
Definition: gtest-port.h:2170
GTEST_API_ void CaptureStdout()
#define GTEST_DISABLE_MSC_DEPRECATED_POP_()
Definition: gtest-port.h:392
GTEST_API_ std::vector< std::string > GetArgvs()
Definition: gtest.cc:647
static std::string FlagToEnvVar(const char *flag)
Definition: gtest-port.cc:1309
std::string StreamableToString(const T &streamable)
GTEST_API_ std::string ReadEntireFile(FILE *file)
Definition: gtest-port.cc:1247
GTEST_API_ bool ParseInt32(const Message &src_text, const char *str, int32_t *value)
Definition: gtest-port.cc:1324
GTEST_API_::std::string FormatFileLocation(const char *file, int line)
Definition: gtest-port.cc:1003
#define T
Definition: Sacado_rad.hpp:553
::std::ostream & GetStream()
Definition: gtest-port.h:1082
const GTestLogSeverity severity_
Definition: gtest-port.h:1085
expr expr1 expr1 expr1 c expr2 expr1 expr2 expr1 expr2 expr1 expr1 expr1 expr1 c expr2 expr1 expr2 expr1 expr2 expr1 expr1 expr1 expr1 c *expr2 expr1 expr2 expr1 expr2 expr1 expr1 expr1 expr1 c expr2 expr1 expr2 expr1 expr2 expr1 expr1 expr1 expr2 expr1 expr2 expr1 expr1 expr1 expr2 expr1 expr2 expr1 expr1 expr1 c
#define GTEST_CHECK_(condition)
Definition: gtest-port.h:1118
GTEST_API_ size_t GetFileSize(FILE *file)
Definition: gtest-port.cc:1242
GTestMutexLock MutexLock
Definition: gtest-port.h:1932
int value
std::string GetString() const
Definition: gtest.cc:1327
GTEST_DISABLE_MSC_WARNINGS_POP_() GTEST_API_ GTEST_API_::std::string FormatCompilerIndependentFileLocation(const char *file, int line)
Definition: gtest-port.cc:1021
void
Definition: uninit.c:105
bool BoolFromGTestEnv(const char *flag, bool default_val)
Definition: gtest-port.cc:1366
FILE * FOpen(const char *path, const char *mode)
Definition: gtest-port.h:2137
const char kUnknownFile[]
Definition: gtest-port.cc:999
char ToUpper(char ch)
Definition: gtest-port.h:2011
GTEST_API_ void CaptureStderr()
#define EXPECT_TRUE(condition)
Definition: gtest.h:1823
#define ADD_FAILURE()
Definition: gtest.h:1750
std::string OutputFlagAlsoCheckEnvVar()
Definition: gtest-port.cc:1412
#define GTEST_FLAG_PREFIX_
Definition: gtest-port.h:348
GTEST_API_ std::string TempDir()
Definition: gtest.cc:6941