This document describes pioman installation and configuration.
for any question, send an email to: Alexa.nosp@m.ndre.nosp@m..Deni.nosp@m.s@in.nosp@m.ria.f.nosp@m.r.
for information on what pioman is, see http://pm2.gitlabpages.inria.fr/pioman/.
PIOMan may be used standalone or used through NewMadeleine.
./autogen.sh mkdir build ; cd build ../configure [your options here] make make installNote: pioman purposely cannot be configured in its source directory
% cd $prefix/build/pioman % make docs
PIOM_VERBOSE
: set to 1 to display information messages in pioman init. default is: no display in quiet mode (padico-launch -q or mpirun), display elsePIOM_ENABLE_PROGRESSION
: whether to enable asynchronous progression. default is 1.PIOM_BUSY_WAIT_USEC
: time to busy wait before passive wait, on explicit wait, in usec. default is 10; 0 disables busy-waiting; -1 does only busy waitingPIOM_BUSY_WAIT_GRANULARITY
: number of iterations between time check in busy, to amortize cost of clock_gettime. default is 100.PIOM_IDLE_GRANULARITY
: time between polling in idle threads, in usec. default is 5.PIOM_IDLE_LEVEL
: topology level where to bind idle threads. default is: socket.PIOM_IDLE_DISTRIB
: distribution for idle threads among topo entities of given level (all, odd, even, first). default is: allPIOM_TIMER_PERIOD
: period of timer-based polling, in usec. default is: 4000PIOM_SPARE_LWP
: number of spare LWP to export blocking calls. defaulty is 0.PIOM_DEDICATED
: polling threads will be binded. Default is 0.PIOM_DEDICATED_DISTRIB
: gives a way of distributing polling threads within the topology object (all, odd, even, first, last). Default is last.PIOM_DEDICATED_LEVEL
: type of topology object to bind polling threads on (machine, node, socket, core, pu). Default is socket.PIOM_DEDICATED_WAIT
: pioman waits for an external program to give a topology level and a list of logical indexes within this level via int piom_ltask_set_bound_thread_indexes(int level, int *indexes, int size). PIOM_DEDICATED_DISTRIB
and PIOM_DEDICATED_LEVEL
are ignored when this variable is set to 1.PIOM_DEDICATED_NOBIND
: start dedicated threads, but don't bind them; for testing/debug only.