1HWLOC-GATHER-CPUID(1)                hwloc               HWLOC-GATHER-CPUID(1)
2
3
4

NAME

6       hwloc-gather-cpuid  -  Dumps  the  relevant  x86 cpuid values for later
7       (possibly offline) usage
8

SYNOPSIS

10       hwloc-gather-cpuid [options] [<outdir>]
11

OPTIONS

13       -c <idx>
14              Only gather cpuid values for logical processor whose OS/physical
15              index is <idx>.
16
17       -s --silent
18              Do not show verbose messages.
19
20       -h --help
21              Display help message and exit.
22

DESCRIPTION

24       hwloc-gather-cpuid  dumps all the relevant x86 cpuid values into subdi‐
25       rectory cpuid of current directory, or in <outdir> if specified.
26
27       These files can be used later to explore the machine topology  offline,
28       for  instance  by  setting the environment variable HWLOC_CPUID_PATH to
29       the directory containing all output files, and by forcing the x86 back‐
30       end with HWLOC_COMPONENTS=x86,stop.
31
32       The directory contents may also be submitted to hwloc developers to de‐
33       bug issues remotely.
34
35       If - is used as <outdir>, the output is dumped to the standard  output,
36       but a unique logical processor must have been given with -c.
37
38       hwloc-gather-cpuid  is  a x86 specific tool, it cannot be used on other
39       platforms.
40
41       NOTE: hwloc-gather-cpuid gathers many hardware details about the  plat‐
42       form.   Output  files  should not be posted on public lists or websites
43       unless it is clear that they contain no sensitive information.
44
45       NOTE: The output of hwloc-gather-cpuid is included in the tarball saved
46       by hwloc-gather-topology on Linux/x86.
47
48       NOTE: It is highly recommended that you read the hwloc(7) overview page
49       before reading this man page.
50

EXAMPLES

52       To store cpuid information of all logical processors of the current ma‐
53       chine:
54
55               $ hwloc-gather-cpuid
56               Gathering in directory ./cpuid ...
57               Gathering CPUID of PU P#0 in path ./hwloc-x86-cpuid/pu0 ...
58               Gathering CPUID of PU P#1 in path ./hwloc-x86-cpuid/pu1 ...
59               Gathering CPUID of PU P#2 in path ./hwloc-x86-cpuid/pu2 ...
60               Gathering CPUID of PU P#3 in path ./hwloc-x86-cpuid/pu3 ...
61               Summary written to ./cpuid/hwloc-cpuid-info
62

RETURN VALUE

64       Upon  successful  execution, hwloc-gather-cpuid will exit with the code
65       0.
66
67       hwloc-gather-cpuid will return nonzero exit status if any kind of error
68       occurs,  such  as  (but  not  limited  to) failure to create the output
69       files.
70

SEE ALSO

72       hwloc(7), hwloc-gather-topology(1), lstopo(1)
73
74
75
76
772.4.1                            Feb 11, 2021            HWLOC-GATHER-CPUID(1)
Impressum