1HWLOC-ASSEMBLER-REMOTE(1)            hwloc           HWLOC-ASSEMBLER-REMOTE(1)
2
3
4

NAME

6       hwloc-assembler-remote - Assemble multiple remote host topologies
7

SYNOPSIS

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

OPTIONS

12       --ssh <ssh>
13              Use  the  given  ssh  command (and options) to connect to remote
14              hosts.
15
16       --lstopo-path <path>
17              Use the given path as the remote lstopo command  when  gathering
18              remote  topologies.   By  default, lstopo is taken from the PATH
19              environment variable.
20
21       --lstopo-opts <opts>
22              Pass the given lstopo options when gathering remote topologies.
23
24       --show Display the resulting topology before exit.
25
26       -f --force
27              Ignore failure to load a remote host topology.
28

DESCRIPTION

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

EXAMPLES

35       To assemble three nodes topologies:
36
37           $ hwloc-assembler-remote output.xml host1 host2 host3
38
39
40       To assemble the topology of  a  multi-process  MPI  job  defined  as  a
41       machinefile:
42
43           $ hwloc-assembler-remote output.xml `cat machinefile | sort | uniq`
44

RETURN VALUE

46       Upon successful execution, hwloc-assembler-remote returns 0.
47
48       hwloc-assembler-remote will return nonzero if any kind of error occurs,
49       such as (but not limited to) failure to parse the command line.
50

SEE ALSO

52       hwloc(7), lstopo(1), hwloc-assembler(1)
53
54
55
56
571.11.8                           Sep 06, 2017        HWLOC-ASSEMBLER-REMOTE(1)