Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
HWLOC-GATHER-CPUID(1)		     hwloc		 HWLOC-GATHER-CPUID(1)

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

SYNOPSIS
       hwloc-gather-cpuid [options] [<outdir>]

OPTIONS
       -c <idx>
	      Only gather cpuid	values for logical processor whose OS/physical
	      index is <idx>.

       -q --quiet -s --silent
	      Do not show verbose messages.

       --version
	      Report version and exit.

       -h --help
	      Display help message and exit.

DESCRIPTION
       hwloc-gather-cpuid dumps	all the	relevant x86 cpuid values into	subdi-
       rectory cpuid of	current	directory, or in <outdir> if specified.

       These  files can	be used	later to explore the machine topology offline,
       for instance by setting the environment	variable  HWLOC_CPUID_PATH  to
       the directory containing	all output files, and by forcing the x86 back-
       end with	HWLOC_COMPONENTS=x86,stop.

       The directory contents may also be submitted to hwloc developers	to de-
       bug issues remotely.

       If  - is	used as	<outdir>, the output is	dumped to the standard output,
       but a unique logical processor must have	been given with	-c.

       hwloc-gather-cpuid is a x86 specific tool, it cannot be used  on	 other
       platforms.

       NOTE:  hwloc-gather-cpuid gathers many hardware details about the plat-
       form.  Output files should not be posted	on public  lists  or  websites
       unless it is clear that they contain no sensitive information.

       NOTE: The output	of hwloc-gather-cpuid is included in the tarball saved
       by hwloc-gather-topology	on Linux/x86.

       NOTE: It	is highly recommended that you read the	hwloc(7) overview page
       before reading this man page.

EXAMPLES
       To store	cpuid information of all logical processors of the current ma-
       chine:

	       $ hwloc-gather-cpuid
	       Gathering in directory ./cpuid ...
	       Gathering CPUID of PU P#0 in path ./hwloc-x86-cpuid/pu0 ...
	       Gathering CPUID of PU P#1 in path ./hwloc-x86-cpuid/pu1 ...
	       Gathering CPUID of PU P#2 in path ./hwloc-x86-cpuid/pu2 ...
	       Gathering CPUID of PU P#3 in path ./hwloc-x86-cpuid/pu3 ...
	       Summary written to ./cpuid/hwloc-cpuid-info

RETURN VALUE
       Upon  successful	 execution, hwloc-gather-cpuid will exit with the code
       0.

       hwloc-gather-cpuid will return nonzero exit status if any kind of error
       occurs, such as (but not	limited	 to)  failure  to  create  the	output
       files.

SEE ALSO
       hwloc(7), hwloc-gather-topology(1), lstopo(1)

2.11.2				 Sep 26, 2024		 HWLOC-GATHER-CPUID(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=hwloc-gather-cpuid&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>

home | help