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       -h --help
18              Display help message and exit
19

DESCRIPTION

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

EXAMPLES

46       To  store  cpuid  information  of all logical processors of the current
47       machine:
48
49               $ hwloc-gather-cpuid
50               Gathering in directory ./cpuid ...
51               Gathering CPUID of PU P#0 in path ./hwloc-x86-cpuid/pu0 ...
52               Gathering CPUID of PU P#1 in path ./hwloc-x86-cpuid/pu1 ...
53               Gathering CPUID of PU P#2 in path ./hwloc-x86-cpuid/pu2 ...
54               Gathering CPUID of PU P#3 in path ./hwloc-x86-cpuid/pu3 ...
55               Summary written to ./cpuid/hwloc-cpuid-info
56

RETURN VALUE

58       Upon successful execution, hwloc-gather-cpuid will exit with  the  code
59       0.
60
61       hwloc-gather-cpuid will return nonzero exit status if any kind of error
62       occurs, such as (but not limited  to)  failure  to  create  the  output
63       files.
64

SEE ALSO

66       hwloc(7), lstopo(1)
67
68
69
70
712.0.4                            Jun 03, 2019            HWLOC-GATHER-CPUID(1)
Impressum