Coverage Report

Created: 2025-08-22 14:32

/root/doris/be/src/util/cpu_info.cpp
Line
Count
Source (jump to first uncovered line)
1
// Licensed to the Apache Software Foundation (ASF) under one
2
// or more contributor license agreements.  See the NOTICE file
3
// distributed with this work for additional information
4
// regarding copyright ownership.  The ASF licenses this file
5
// to you under the Apache License, Version 2.0 (the
6
// "License"); you may not use this file except in compliance
7
// with the License.  You may obtain a copy of the License at
8
//
9
//   http://www.apache.org/licenses/LICENSE-2.0
10
//
11
// Unless required by applicable law or agreed to in writing,
12
// software distributed under the License is distributed on an
13
// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
14
// KIND, either express or implied.  See the License for the
15
// specific language governing permissions and limitations
16
// under the License.
17
// This file is copied from
18
// https://github.com/apache/impala/blob/branch-2.9.0/be/src/util/cpu-info.cpp
19
// and modified by Doris
20
21
#include "util/cpu_info.h"
22
23
#if defined(__GNUC__) && (defined(__x86_64__) || defined(__i386__))
24
#elif defined(__GNUC__) && defined(__ARM_NEON__)
25
/* GCC-compatible compiler, targeting ARM with NEON */
26
#include <arm_neon.h>
27
#elif defined(__GNUC__) && defined(__IWMMXT__)
28
/* GCC-compatible compiler, targeting ARM with WMMX */
29
#include <mmintrin.h>
30
#elif (defined(__GNUC__) || defined(__xlC__)) && (defined(__VEC__) || defined(__ALTIVEC__))
31
/* XLC or GCC-compatible compiler, targeting PowerPC with VMX/VSX */
32
#include <altivec.h>
33
#elif defined(__GNUC__) && defined(__SPE__)
34
/* GCC-compatible compiler, targeting PowerPC with SPE */
35
#include <spe.h>
36
#endif
37
38
#ifndef __APPLE__
39
#include <sys/sysinfo.h>
40
#else
41
#include <sys/sysctl.h>
42
#endif
43
44
#include <gen_cpp/Metrics_types.h>
45
#include <sched.h>
46
#include <stdlib.h>
47
#include <unistd.h>
48
49
#include <algorithm>
50
#include <boost/algorithm/string/predicate.hpp>
51
#include <boost/algorithm/string/trim.hpp>
52
// IWYU pragma: no_include <bits/chrono.h>
53
#include <chrono> // IWYU pragma: keep
54
#include <filesystem>
55
#include <fstream>
56
57
#include "common/config.h"
58
#include "common/env_config.h"
59
#include "gflags/gflags.h"
60
#include "gutil/stringprintf.h"
61
#include "gutil/strings/substitute.h"
62
#include "util/cgroup_util.h"
63
#include "util/pretty_printer.h"
64
65
using boost::algorithm::contains;
66
using boost::algorithm::trim;
67
namespace fs = std::filesystem;
68
using std::max;
69
70
DECLARE_bool(abort_on_config_error);
71
DEFINE_int32(num_cores, 0,
72
             "(Advanced) If > 0, it sets the number of cores available to"
73
             " Impala. Setting it to 0 means Impala will use all available cores on the machine"
74
             " according to /proc/cpuinfo.");
75
76
namespace doris {
77
// Helper function to warn if a given file does not contain an expected string as its
78
// first line. If the file cannot be opened, no error is reported.
79
void WarnIfFileNotEqual(const string& filename, const string& expected,
80
0
                        const string& warning_text) {
81
0
    std::ifstream file(filename);
82
0
    if (!file) return;
  Branch (82:9): [True: 0, False: 0]
83
0
    string line;
84
0
    getline(file, line);
85
0
    if (line != expected) {
  Branch (85:9): [True: 0, False: 0]
86
0
        LOG(ERROR) << "Expected " << expected << ", actual " << line << std::endl << warning_text;
87
0
    }
88
0
}
89
} // namespace doris
90
91
namespace doris {
92
93
bool CpuInfo::initialized_ = false;
94
int64_t CpuInfo::hardware_flags_ = 0;
95
int64_t CpuInfo::original_hardware_flags_;
96
int64_t CpuInfo::cycles_per_ms_;
97
int CpuInfo::num_cores_ = 1;
98
int CpuInfo::max_num_cores_ = 1;
99
std::string CpuInfo::model_name_ = "unknown";
100
int CpuInfo::max_num_numa_nodes_;
101
std::unique_ptr<int[]> CpuInfo::core_to_numa_node_;
102
std::vector<vector<int>> CpuInfo::numa_node_to_cores_;
103
std::vector<int> CpuInfo::numa_node_core_idx_;
104
105
static struct {
106
    string name;
107
    int64_t flag;
108
} flag_mappings[] = {
109
        {"ssse3", CpuInfo::SSSE3},   {"sse4_1", CpuInfo::SSE4_1}, {"sse4_2", CpuInfo::SSE4_2},
110
        {"popcnt", CpuInfo::POPCNT}, {"avx", CpuInfo::AVX},       {"avx2", CpuInfo::AVX2},
111
};
112
113
// Helper function to parse for hardware flags.
114
// values contains a list of space-separated flags.  check to see if the flags we
115
// care about are present.
116
// Returns a bitmap of flags.
117
12
int64_t ParseCPUFlags(const string& values) {
118
12
    int64_t flags = 0;
119
72
    for (auto& flag_mapping : flag_mappings) {
  Branch (119:29): [True: 72, False: 12]
120
72
        if (contains(values, flag_mapping.name)) {
  Branch (120:13): [True: 72, False: 0]
121
72
            flags |= flag_mapping.flag;
122
72
        }
123
72
    }
124
12
    return flags;
125
12
}
126
127
10
void CpuInfo::init() {
128
10
    if (initialized_) return;
  Branch (128:9): [True: 9, False: 1]
129
1
    string line;
130
1
    string name;
131
1
    string value;
132
133
1
    float max_mhz = 0;
134
1
    int physical_num_cores = 0;
135
136
    // maybe use std::thread::hardware_concurrency()?
137
    // Read from /proc/cpuinfo
138
1
    std::ifstream cpuinfo("/proc/cpuinfo");
139
326
    while (cpuinfo) {
  Branch (139:12): [True: 325, False: 1]
140
325
        getline(cpuinfo, line);
141
325
        size_t colon = line.find(':');
142
325
        if (colon != string::npos) {
  Branch (142:13): [True: 312, False: 13]
143
312
            name = line.substr(0, colon - 1);
144
312
            value = line.substr(colon + 1, string::npos);
145
312
            trim(name);
146
312
            trim(value);
147
312
            if (name == "flags") {
  Branch (147:17): [True: 12, False: 300]
148
12
                hardware_flags_ |= ParseCPUFlags(value);
149
300
            } else if (name == "cpu MHz") {
  Branch (149:24): [True: 12, False: 288]
150
                // Every core will report a different speed.  We'll take the max, assuming
151
                // that when impala is running, the core will not be in a lower power state.
152
                // TODO: is there a more robust way to do this, such as
153
                // Window's QueryPerformanceFrequency()
154
12
                float mhz = atof(value.c_str());
155
12
                max_mhz = max(mhz, max_mhz);
156
288
            } else if (name == "processor") {
  Branch (156:24): [True: 12, False: 276]
157
12
                ++physical_num_cores;
158
276
            } else if (name == "model name") {
  Branch (158:24): [True: 12, False: 264]
159
12
                model_name_ = value;
160
12
            }
161
312
        }
162
325
    }
163
164
#ifdef __APPLE__
165
    size_t len = sizeof(max_num_cores_);
166
    sysctlbyname("hw.physicalcpu", &physical_num_cores, &len, nullptr, 0);
167
#endif
168
169
1
    int num_cores = CGroupUtil::get_cgroup_limited_cpu_number(physical_num_cores);
170
1
    if (max_mhz != 0) {
  Branch (170:9): [True: 1, False: 0]
171
1
        cycles_per_ms_ = int64_t(max_mhz) * 1000;
172
1
    } else {
173
0
        cycles_per_ms_ = 1000000;
174
0
    }
175
1
    original_hardware_flags_ = hardware_flags_;
176
177
1
    if (num_cores > 0) {
  Branch (177:9): [True: 1, False: 0]
178
1
        num_cores_ = num_cores;
179
1
    } else {
180
0
        num_cores_ = 1;
181
0
    }
182
1
    if (config::num_cores > 0) {
  Branch (182:9): [True: 0, False: 1]
183
0
        num_cores_ = config::num_cores;
184
0
    }
185
186
#ifdef __APPLE__
187
    sysctlbyname("hw.logicalcpu", &max_num_cores_, &len, nullptr, 0);
188
#else
189
1
    max_num_cores_ = get_nprocs_conf();
190
1
#endif
191
192
    // Print a warning if something is wrong with sched_getcpu().
193
1
#ifdef HAVE_SCHED_GETCPU
194
1
    if (sched_getcpu() == -1) {
  Branch (194:9): [True: 0, False: 1]
195
0
        LOG(WARNING) << "Kernel does not support sched_getcpu(). Performance may be impacted.";
196
0
    }
197
#else
198
    LOG(WARNING) << "Built on a system without sched_getcpu() support. Performance may"
199
                 << " be impacted.";
200
#endif
201
202
1
    _init_numa();
203
1
    initialized_ = true;
204
1
}
205
206
1
void CpuInfo::_init_numa() {
207
    // Use the NUMA info in the /sys filesystem. which is part of the Linux ABI:
208
    // see https://www.kernel.org/doc/Documentation/ABI/stable/sysfs-devices-node and
209
    // https://www.kernel.org/doc/Documentation/ABI/testing/sysfs-devices-system-cpu
210
    // The filesystem entries are only present if the kernel was compiled with NUMA support.
211
1
    core_to_numa_node_.reset(new int[max_num_cores_]);
212
213
1
    if (!fs::is_directory("/sys/devices/system/node")) {
  Branch (213:9): [True: 0, False: 1]
214
0
        LOG(WARNING) << "/sys/devices/system/node is not present - no NUMA support";
215
        // Assume a single NUMA node.
216
0
        max_num_numa_nodes_ = 1;
217
0
        std::fill_n(core_to_numa_node_.get(), max_num_cores_, 0);
218
0
        _init_numa_node_to_cores();
219
0
        return;
220
0
    }
221
222
    // Search for node subdirectories - node0, node1, node2, etc to determine possible
223
    // NUMA nodes.
224
1
    fs::directory_iterator dir_it("/sys/devices/system/node");
225
1
    max_num_numa_nodes_ = 0;
226
9
    for (; dir_it != fs::directory_iterator(); ++dir_it) {
  Branch (226:12): [True: 8, False: 1]
227
8
        const string filename = dir_it->path().filename().string();
228
8
        if (filename.find("node") == 0) ++max_num_numa_nodes_;
  Branch (228:13): [True: 1, False: 7]
229
8
    }
230
1
    if (max_num_numa_nodes_ == 0) {
  Branch (230:9): [True: 0, False: 1]
231
0
        LOG(WARNING) << "Could not find nodes in /sys/devices/system/node";
232
0
        max_num_numa_nodes_ = 1;
233
0
    }
234
235
    // Check which NUMA node each core belongs to based on the existence of a symlink
236
    // to the node subdirectory.
237
13
    for (int core = 0; core < max_num_cores_; ++core) {
  Branch (237:24): [True: 12, False: 1]
238
12
        bool found_numa_node = false;
239
12
        for (int node = 0; node < max_num_numa_nodes_; ++node) {
  Branch (239:28): [True: 12, False: 0]
240
12
            if (fs::exists(
  Branch (240:17): [True: 12, False: 0]
241
12
                        strings::Substitute("/sys/devices/system/cpu/cpu$0/node$1", core, node))) {
242
12
                core_to_numa_node_[core] = node;
243
12
                found_numa_node = true;
244
12
                break;
245
12
            }
246
12
        }
247
12
        if (!found_numa_node) {
  Branch (247:13): [True: 0, False: 12]
248
0
            LOG(WARNING) << "Could not determine NUMA node for core " << core
249
0
                         << " from /sys/devices/system/cpu/";
250
0
            core_to_numa_node_[core] = 0;
251
0
        }
252
12
    }
253
1
    _init_numa_node_to_cores();
254
1
}
255
256
void CpuInfo::_init_fake_numa_for_test(int max_num_numa_nodes,
257
0
                                       const std::vector<int>& core_to_numa_node) {
258
0
    DCHECK_EQ(max_num_cores_, core_to_numa_node.size());
259
0
    max_num_numa_nodes_ = max_num_numa_nodes;
260
0
    for (int i = 0; i < max_num_cores_; ++i) {
  Branch (260:21): [True: 0, False: 0]
261
0
        core_to_numa_node_[i] = core_to_numa_node[i];
262
0
    }
263
0
    numa_node_to_cores_.clear();
264
0
    _init_numa_node_to_cores();
265
0
}
266
267
1
void CpuInfo::_init_numa_node_to_cores() {
268
1
    DCHECK(numa_node_to_cores_.empty());
269
1
    numa_node_to_cores_.resize(max_num_numa_nodes_);
270
1
    numa_node_core_idx_.resize(max_num_cores_);
271
13
    for (int core = 0; core < max_num_cores_; ++core) {
  Branch (271:24): [True: 12, False: 1]
272
12
        std::vector<int>* cores_of_node = &numa_node_to_cores_[core_to_numa_node_[core]];
273
12
        numa_node_core_idx_[core] = cores_of_node->size();
274
12
        cores_of_node->push_back(core);
275
12
    }
276
1
}
277
278
0
void CpuInfo::verify_cpu_requirements() {
279
0
    if (!CpuInfo::is_supported(CpuInfo::SSSE3)) {
  Branch (279:9): [True: 0, False: 0]
280
0
        LOG(ERROR) << "CPU does not support the Supplemental SSE3 (SSSE3) instruction set. "
281
0
                   << "This setup is generally unsupported and Impala might be unstable.";
282
0
    }
283
0
}
284
285
0
void CpuInfo::verify_performance_governor() {
286
0
    for (int cpu_id = 0; cpu_id < CpuInfo::num_cores(); ++cpu_id) {
  Branch (286:26): [True: 0, False: 0]
287
0
        const string governor_file = strings::Substitute(
288
0
                "/sys/devices/system/cpu/cpu$0/cpufreq/scaling_governor", cpu_id);
289
0
        const string warning_text = strings::Substitute(
290
0
                "WARNING: CPU $0 is not using 'performance' governor. Note that changing the "
291
0
                "governor to 'performance' will reset the no_turbo setting to 0.",
292
0
                cpu_id);
293
0
        WarnIfFileNotEqual(governor_file, "performance", warning_text);
294
0
    }
295
0
}
296
297
0
void CpuInfo::verify_turbo_disabled() {
298
0
    WarnIfFileNotEqual(
299
0
            "/sys/devices/system/cpu/intel_pstate/no_turbo", "1",
300
0
            "WARNING: CPU turbo is enabled. This setting can change the clock frequency of CPU "
301
0
            "cores during the benchmark run, which can lead to inaccurate results. You can "
302
0
            "disable CPU turbo by writing a 1 to "
303
0
            "/sys/devices/system/cpu/intel_pstate/no_turbo. Note that changing the governor to "
304
0
            "'performance' will reset this to 0.");
305
0
}
306
307
0
void CpuInfo::enable_feature(long flag, bool enable) {
308
0
    DCHECK(initialized_);
309
0
    if (!enable) {
  Branch (309:9): [True: 0, False: 0]
310
0
        hardware_flags_ &= ~flag;
311
0
    } else {
312
        // Can't turn something on that can't be supported
313
0
        DCHECK((original_hardware_flags_ & flag) != 0);
314
0
        hardware_flags_ |= flag;
315
0
    }
316
0
}
317
318
0
int CpuInfo::get_current_core() {
319
    // sched_getcpu() is not supported on some old kernels/glibcs (like the versions that
320
    // shipped with CentOS 5). In that case just pretend we're always running on CPU 0
321
    // so that we can build and run with degraded perf.
322
0
#ifdef HAVE_SCHED_GETCPU
323
0
    int cpu = sched_getcpu();
324
0
    if (cpu < 0) return 0;
  Branch (324:9): [True: 0, False: 0]
325
0
    if (cpu >= max_num_cores_) {
  Branch (325:9): [True: 0, False: 0]
326
0
        LOG_FIRST_N(WARNING, 5) << "sched_getcpu() return value " << cpu
327
0
                                << ", which is greater than get_nprocs_conf() retrun value "
328
0
                                << max_num_cores_ << ", now is " << get_nprocs_conf();
329
0
        cpu %= max_num_cores_;
330
0
    }
331
0
    return cpu;
332
#else
333
    return 0;
334
#endif
335
0
}
336
337
void CpuInfo::_get_cache_info(long cache_sizes[NUM_CACHE_LEVELS],
338
0
                              long cache_line_sizes[NUM_CACHE_LEVELS]) {
339
#ifdef __APPLE__
340
    // On Mac OS X use sysctl() to get the cache sizes
341
    size_t len = 0;
342
    sysctlbyname("hw.cachesize", nullptr, &len, nullptr, 0);
343
    uint64_t* data = static_cast<uint64_t*>(malloc(len));
344
    sysctlbyname("hw.cachesize", data, &len, nullptr, 0);
345
#ifndef __arm64__
346
    DCHECK(len / sizeof(uint64_t) >= 3);
347
    for (size_t i = 0; i < NUM_CACHE_LEVELS; ++i) {
348
        cache_sizes[i] = data[i];
349
    }
350
#else
351
    for (size_t i = 0; i < NUM_CACHE_LEVELS; ++i) {
352
        cache_sizes[i] = data[i + 1];
353
    }
354
#endif
355
    size_t linesize;
356
    size_t sizeof_linesize = sizeof(linesize);
357
    sysctlbyname("hw.cachelinesize", &linesize, &sizeof_linesize, nullptr, 0);
358
    for (size_t i = 0; i < NUM_CACHE_LEVELS; ++i) cache_line_sizes[i] = linesize;
359
#else
360
    // Call sysconf to query for the cache sizes
361
    // Note: on some systems (e.g. RHEL 5 on AWS EC2), this returns 0 instead of the
362
    // actual cache line size.
363
0
    cache_sizes[L1_CACHE] = sysconf(_SC_LEVEL1_DCACHE_SIZE);
364
0
    cache_sizes[L2_CACHE] = sysconf(_SC_LEVEL2_CACHE_SIZE);
365
0
    cache_sizes[L3_CACHE] = sysconf(_SC_LEVEL3_CACHE_SIZE);
366
367
0
    cache_line_sizes[L1_CACHE] = sysconf(_SC_LEVEL1_DCACHE_LINESIZE);
368
0
    cache_line_sizes[L2_CACHE] = sysconf(_SC_LEVEL2_CACHE_LINESIZE);
369
0
    cache_line_sizes[L3_CACHE] = sysconf(_SC_LEVEL3_CACHE_LINESIZE);
370
0
#endif
371
0
}
372
373
0
std::string CpuInfo::debug_string() {
374
0
    DCHECK(initialized_);
375
0
    std::stringstream stream;
376
0
    long cache_sizes[NUM_CACHE_LEVELS];
377
0
    long cache_line_sizes[NUM_CACHE_LEVELS];
378
0
    _get_cache_info(cache_sizes, cache_line_sizes);
379
380
0
    string L1 = strings::Substitute(
381
0
            "L1 Cache: $0 (Line: $1)",
382
0
            PrettyPrinter::print(static_cast<int64_t>(cache_sizes[L1_CACHE]), TUnit::BYTES),
383
0
            PrettyPrinter::print(static_cast<int64_t>(cache_line_sizes[L1_CACHE]), TUnit::BYTES));
384
0
    string L2 = strings::Substitute(
385
0
            "L2 Cache: $0 (Line: $1)",
386
0
            PrettyPrinter::print(static_cast<int64_t>(cache_sizes[L2_CACHE]), TUnit::BYTES),
387
0
            PrettyPrinter::print(static_cast<int64_t>(cache_line_sizes[L2_CACHE]), TUnit::BYTES));
388
0
    string L3 =
389
0
            cache_sizes[L3_CACHE]
  Branch (389:13): [True: 0, False: 0]
390
0
                    ? strings::Substitute(
391
0
                              "L3 Cache: $0 (Line: $1)",
392
0
                              PrettyPrinter::print(static_cast<int64_t>(cache_sizes[L3_CACHE]),
393
0
                                                   TUnit::BYTES),
394
0
                              PrettyPrinter::print(static_cast<int64_t>(cache_line_sizes[L3_CACHE]),
395
0
                                                   TUnit::BYTES))
396
0
                    : "";
397
0
    stream << "Cpu Info:" << std::endl
398
0
           << "  Model: " << model_name_ << std::endl
399
0
           << "  Cores: " << num_cores_ << std::endl
400
0
           << "  Max Possible Cores: " << max_num_cores_ << std::endl
401
0
           << "  " << L1 << std::endl
402
0
           << "  " << L2 << std::endl
403
0
           << "  " << L3 << std::endl
404
0
           << "  Hardware Supports:" << std::endl;
405
0
    for (auto& flag_mapping : flag_mappings) {
  Branch (405:29): [True: 0, False: 0]
406
0
        if (is_supported(flag_mapping.flag)) {
  Branch (406:13): [True: 0, False: 0]
407
0
            stream << "    " << flag_mapping.name << std::endl;
408
0
        }
409
0
    }
410
0
    stream << "  Numa Nodes: " << max_num_numa_nodes_ << std::endl;
411
0
    stream << "  Numa Nodes of Cores:";
412
0
    for (int core = 0; core < max_num_cores_; ++core) {
  Branch (412:24): [True: 0, False: 0]
413
0
        stream << " " << core << "->" << core_to_numa_node_[core] << " |";
414
0
    }
415
0
    stream << std::endl;
416
0
    return stream.str();
417
0
}
418
419
} // namespace doris