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-ASSEMBLER(1)						       hwloc							HWLOC-ASSEMBLER(1)

NAME

       hwloc-assembler - Assemble multiple XML topologies

SYNOPSIS

       hwloc-assembler [options] output.xml [--name <name1>] input1.xml [--name <name2>] input2.xml ...

OPTIONS

       -n --name <name>
	      Set <name> in the AssemblerName info attribute of the next input topology root to ease identification within the final global topol-
	      ogy.

       -f --force
	      Ignore errors while reading input files.

       -v --verbose
	      Verbose messages.

DESCRIPTION

       hwloc-assembler combines the input XML topologies and exports the resulting global topologies to a new XML file.  All inputs are  inserting
       as children of the global root object.  Each input topology root is annotated with info attributes before insertion.  AssemblerIndex is set
       to the index within the list of inputs.	AssemblerName is set to the name given with --name if any.  hwloc-assembler-remote offers a  fron-
       tend for assembling remote nodes topologies without having to manually gather and transfer each of them.

EXAMPLES

       To assemble two nodes topologies:

	   $ hwloc-assembler output.xml --name host1 host1.xml --name host2 host2.xml

RETURN VALUE

       Upon successful execution, hwloc-assembler returns 0.

       hwloc-assembler 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-remote(1)

1.4.1								   Feb 27, 2012 						HWLOC-ASSEMBLER(1)