sysinfo.h 2.7 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374
  1. // Copyright 2017 The Abseil Authors.
  2. //
  3. // Licensed under the Apache License, Version 2.0 (the "License");
  4. // you may not use this file except in compliance with the License.
  5. // You may obtain a copy of the License at
  6. //
  7. // https://www.apache.org/licenses/LICENSE-2.0
  8. //
  9. // Unless required by applicable law or agreed to in writing, software
  10. // distributed under the License is distributed on an "AS IS" BASIS,
  11. // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  12. // See the License for the specific language governing permissions and
  13. // limitations under the License.
  14. //
  15. // This file includes routines to find out characteristics
  16. // of the machine a program is running on. It is undoubtedly
  17. // system-dependent.
  18. // Functions listed here that accept a pid_t as an argument act on the
  19. // current process if the pid_t argument is 0
  20. // All functions here are thread-hostile due to file caching unless
  21. // commented otherwise.
  22. #ifndef Y_ABSL_BASE_INTERNAL_SYSINFO_H_
  23. #define Y_ABSL_BASE_INTERNAL_SYSINFO_H_
  24. #ifndef _WIN32
  25. #include <sys/types.h>
  26. #endif
  27. #include <cstdint>
  28. #include "y_absl/base/config.h"
  29. #include "y_absl/base/port.h"
  30. namespace y_absl {
  31. Y_ABSL_NAMESPACE_BEGIN
  32. namespace base_internal {
  33. // Nominal core processor cycles per second of each processor. This is _not_
  34. // necessarily the frequency of the CycleClock counter (see cycleclock.h)
  35. // Thread-safe.
  36. double NominalCPUFrequency();
  37. // Number of logical processors (hyperthreads) in system. Thread-safe.
  38. int NumCPUs();
  39. // Return the thread id of the current thread, as told by the system.
  40. // No two currently-live threads implemented by the OS shall have the same ID.
  41. // Thread ids of exited threads may be reused. Multiple user-level threads
  42. // may have the same thread ID if multiplexed on the same OS thread.
  43. //
  44. // On Linux, you may send a signal to the resulting ID with kill(). However,
  45. // it is recommended for portability that you use pthread_kill() instead.
  46. #ifdef _WIN32
  47. // On Windows, process id and thread id are of the same type according to the
  48. // return types of GetProcessId() and GetThreadId() are both DWORD, an unsigned
  49. // 32-bit type.
  50. using pid_t = uint32_t;
  51. #endif
  52. pid_t GetTID();
  53. // Like GetTID(), but caches the result in thread-local storage in order
  54. // to avoid unnecessary system calls. Note that there are some cases where
  55. // one must call through to GetTID directly, which is why this exists as a
  56. // separate function. For example, GetCachedTID() is not safe to call in
  57. // an asynchronous signal-handling context nor right after a call to fork().
  58. pid_t GetCachedTID();
  59. } // namespace base_internal
  60. Y_ABSL_NAMESPACE_END
  61. } // namespace y_absl
  62. #endif // Y_ABSL_BASE_INTERNAL_SYSINFO_H_