1HWLOC-PS(1)                          hwloc                         HWLOC-PS(1)
2
3
4

NAME

6       hwloc-ps - List currently-running processes or threads that are bound.
7

SYNOPSIS

9       hwloc-ps [options]
10

OPTIONS

12       -a        list all processes, even those that are not bound to any spe‐
13                 cific part of the machine.
14
15       -p --physical
16                 report OS/physical indexes instead of logical indexes
17
18       -l --logical
19                 report  logical  indexes  instead  of   physical/OS   indexes
20                 (default)
21
22       -c --cpuset
23                 show process bindings as cpusets instead of objects.
24
25       -t --threads
26                 show  threads inside processes.  If -a is given as well, list
27                 all threads within each process.  Otherwise, show all threads
28                 inside each process where at least one thread is bound.
29
30       --whole-system
31                 Do not consider administration limitations.
32

DESCRIPTION

34       By  default, hwloc-ps lists only those currently-running processes that
35       are bound. If -t is given, processes that are not bound but contain  at
36       least  one  bound  thread  are  also  displayed,  as  well as all their
37       threads.
38
39       hwloc-ps displays process identifier, command-line  and  binding.   The
40       binding may be reported as objects or cpusets.
41
42       By  default, process bindings are restricted to the currently available
43       topology. If some processes are bound to processors that are not avail‐
44       able  to the current process, they are ignored unless --whole-system is
45       given.
46
47       The output is a plain list. If you wish to  annotate  the  hierarchical
48       topology with processes so as to see how they are actual distributed on
49       the machine, you might want to use lstopo --ps instead (which also only
50       shows processes that are bound).
51
52       The -a switch can be used to show all processes, if desired.
53

EXAMPLES

55       If a process is bound, it appears in the default output:
56
57           $ utils/hwloc-ps
58           4759  Core:0         myprogram
59
60       If  a  process  is  not bound but 3 of his 4 threads are bound, it only
61       appears in the thread-aware output:
62
63           $ utils/hwloc-ps
64
65           $ utils/hwloc-ps -t
66           4759  Machine:0      myprogram
67            4759 Machine:0
68            4761 PU:0
69            4762 PU:2
70            4765 PU:1
71
72

SEE ALSO

74       hwloc(7), lstopo(1), hwloc-calc(1), hwloc-distrib(1)
75
76
77
78
791.5                              Jul 30, 2012                      HWLOC-PS(1)
Impressum