hwloc-assembler-remote(1) [debian man page]

HWLOC-ASSEMBLER-REMOTE(1)					       hwloc						 HWLOC-ASSEMBLER-REMOTE(1)

NAME

       hwloc-assembler-remote - Assemble multiple remote host topologies

SYNOPSIS

       hwloc-assembler-remote [options] output.xml host1 host2 ...

OPTIONS

       --ssh <ssh>
	      Use the given ssh command (and options) to connect to remote hosts.

       --lstopo-path <path>
	      Use  the	given path as the remote lstopo command when gathering remote topologies.  By default, lstopo is taken from the PATH envi-
	      ronment variable.

       --lstopo-opts <opts>
	      Pass the given lstopo options when gathering remote topologies.

       --show Display the resulting topology before exit.

       -v --verbose
	      Verbose messages.

DESCRIPTION

       hwloc-assembler-remote is a frontend to hwloc-assembler.  It takes care of retrieving the remote nodes' topologies before  assembling  them
       with hwloc-assembler.

EXAMPLES

       To assemble three nodes topologies:

	   $ hwloc-assembler-remote output.xml host1 host2 host3

       To assemble the topology of a multi-process MPI job defined as a machinefile:

	   $ hwloc-assembler-remote output.xml `cat machinefile | sort | uniq`

RETURN VALUE

       Upon successful execution, hwloc-assembler-remote returns 0.

       hwloc-assembler-remote will return nonzero if any kind of error occurs, such as (but not limited to) failure to parse the command line.

SEE ALSO

       hwloc(7), lstopo(1), hwloc-assembler(1)

1.4.1								   Feb 27, 2012 					 HWLOC-ASSEMBLER-REMOTE(1)

HWLOC-GATHER-TOPOLOGY(1)					       hwloc						  HWLOC-GATHER-TOPOLOGY(1)

NAME

       hwloc-gather-topology - Saves the relevant Linux topology files and the lstopo output for later (possibly offline) usage.

SYNOPSIS

       hwloc-gather-topology [options] <path>

OPTIONS

       -h --help display help message and exit

DESCRIPTION

       hwloc-gather-topology  saves  all  the relevant topology files into an archive (<path>.tar.bz2) and the lstopo output (<path>.output).  The
       utility for example stores the /proc/cpuinfo file and the entire /sys/devices/system/node/ directory tree.

       These files can be used later to explore the machine topology offline.  Once the tarball has been extracted, it may for instance  be  given
       to  some  hwloc	command-line  utilities through their --input option.  It is also possible to override the default topology that the hwloc
       library will read by setting the extracted path in the HWLOC_FSROOT environment variable.

       Both archive and lstopo output may also be submitted to hwloc developers to debug issues remotely.

       hwloc-gather-topology is a Linux specific tool, it is not installed on other operating systems.

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

EXAMPLES

       To store topology information to be used later (possibly on a different host) please run:

	    hwloc-gather-topology /tmp/myhost

       It will store all relevant topology files in the /tmp/myhost.tar.bz2 archive and the lstopo output in the /tmp/myhost.output  file.   These
       files can be transferred on another host for later/offline analysis and/or as the input to various hwloc utilities.

       To use these data with hwloc utilities you have to unpack myhost.tar.bz2 archive first:

	    tar jxvf /tmp/myhost.tar.bz2

       A new directory named myhost now contains all topology files.  Then you ask various hwloc utilities to use this topology instead of the one
       of the real machine by passing --input myhost.  To display the topology just run:

	    lstopo --input ./myhost

       It is not necessary that the topology is extracted in the current directory, absolute or relative paths are also supported:

	    lstopo --input /path/to/remote/host/extracted/topology/

       To see how hwloc would distribute 8 parallel jobs on the original host:

	    hwloc-distrib --input myhost --single 8

       To get the corresponding physical indexes in the previous command:

	    hwloc-calc --input myhost --po --li --proclist $(hwloc-distrib --input myhost --single 8)

       Any program may actually override the default topology with a given archived  one  even	if  it	does  not  have  a  --input  option.   The
       HWLOC_FSROOT environment variable should be used to do so:

	    HWLOC_FSROOT=myhost hwloc-calc --po --li --proclist $(hwloc-distrib --single 8)

       All  these commands will produce the same output as if executed directly on the host on which the topology information was originally gath-
       ered by the hwloc-gather-topology script.

RETURN VALUE

       Upon successful execution, hwloc-gather-topology will exit with the code 0.

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

SEE ALSO

       hwloc(7), lstopo(1), hwloc-calc(1), hwloc-distrib(1)

1.4.1								   Feb 27, 2012 					  HWLOC-GATHER-TOPOLOGY(1)