This tool displays process and thread binding in an interative web page.
1) Basic Usage
Run the hwloc-ps tool in JSON server mode:
$ hwloc-ps --json-server
server running on port 8888...
Export the topology as a SVG file using the native backend:
$ lstopo filename.svg --of nativesvg
Now run the client side for displaying the binding:
$ cd /path/to/hwloc-ps.www/
$ node client.js /path/to/filename.svg
This should open a webpage in your browser.
Otherwise add -u to see the URL that you should open (usually http://localhost:3000).
2) Installing node.js and JS dependencies
The "node" command is available in the "nodejs" package in most Linux distributions,
but you should rather install the "npm" package to get additional utilities:
# apt instal npm
# yum install npm
Then install the dependencies needed by client.js:
$ cd /path/to/hwloc-ps.www/
$ npm install
If you don't have write-access to the hwloc-ps.www/ directory,
copy it somewhere else, run "npm install" from there,
and then run the client from there:
$ cp -a /path/to/hwloc-ps.www/ $HOME/myhwloc-ps.www/
$ cd $HOME/myhwloc-ps.www/
$ npm install
$ node client.js /path/to/filename.svg
3) Running on a remote server
This tool is often useful for debugging process placement on remote servers, hence:
* hwloc-ps and lstopo should run on that remote server
(this requires a recent hwloc on the remote side).
* you must copy the SVG file back to your machine:
$ scp target:/path/to/filename.svg .
* if the target machine port 8888 is not directly accessible, you may
have to forward its 8888 port:
$ ssh target -L 8888:localhost:8888 -Nf
