1poolbind(1M) System Administration Commands poolbind(1M)
2
6 poolbind - bind processes, tasks, or projects or query binding of pro‐
7 cesses to resource pools
8
10 /usr/sbin/poolbind -p poolname -e command [arguments]...
11 /usr/sbin/poolbind -p poolname [-i idtype] id...
14 /usr/sbin/poolbind -q pid...
17 /usr/sbin/poolbind -Q pid...
20
23 The poolbind command allows an authorized user to bind zones, projects,
24 tasks, and processes to pools. With the -e option (see below), it can
25 execute a command you specify, placing the executed command in a speci‐
26 fied pool. It can also enable you to query a process to determine which
27 pool a process is bound to.
28
30 The following options are supported:
31 -e command [arguments...] Executes command, bound to the pool you
33 specify with -p.
34 -i idtype This option, together with the idlist
37 arguments, specifies one or more processes
38 to which the poolbind command is to apply.
39 The interpretation of idlist depends on
40 the value of idtype. The valid idtype
41 arguments and corresponding interpreta‐
42 tions of idlist are as follows:
43 pid idlist is a list of process IDs.
45 Binds the specified processes to
46 the specified pool. This is the
47 default behavior if no idtype is
48 specified.
49 taskid idlist is a list of task IDs.
52 Bind all processes within the
53 list of task IDs to the speci‐
54 fied pool.
55 projid idlist is a list of project IDs.
58 Bind all processes within the
59 list of projects to the speci‐
60 fied pool. Each project ID can
61 be specified as either a project
62 name or a numerical project ID.
63 See project(4).
64 zoneid idlist is a list of zone IDs.
67 Bind all processes within the
68 list of zones to the specified
69 pool. Each zone ID can be speci‐
70 fied as either a zone name or a
71 numerical zone ID. See zones(5).
72 -p poolname Specifies the name of a pool to which the
76 specified zone, project, tasks, or pro‐
77 cesses are to be bound.
78 -q pid ... Queries the pool bindings for a given list
81 of process IDs. If the collection of
82 resources associated with the process does
83 not correspond to any currently existing
84 pool, or if there are multiple pools with
85 the set of resources that the process is
86 bound to, the query fails for that partic‐
87 ular process ID.
88 -Q pid ... Queries the resource bindings for a given
91 list of process IDs. The resource bindings
92 are each reported on a separate line.
93
96 Example 1 Binding All Processes
97 The following command binds all processes in projects 5 and 7 to the
100 pool web_app:
101 example# /usr/sbin/poolbind -p web_app -i projid 5 7
104 Example 2 Binding the Running Shell
108 The following command binds the running shell to the pool web_app:
111 example# /usr/sbin/poolbind -p web_app $$
114 Example 3 Querying the Pool Bindings
118 The following command queries the bindings to verify that the shell is
121 bound to the given pool:
122 example# /usr/sbin/poolbind -q $$
125 Example 4 Querying the Resource Bindings
129 The following command queries the bindings to verify that the shell is
132 bound to the given resources:
133 example# /usr/sbin/poolbind -Q $$
136
140 The following exit values are returned:
141 0 Successful completion.
143 1 Requested operation could not be completed.
146 2 Invalid command line options were specified.
149
152 See attributes(5) for descriptions of the following attributes:
153 ┌─────────────────────────────┬─────────────────────────────┐
158 │ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
159 ├─────────────────────────────┼─────────────────────────────┤
160 │Availability │SUNWpool │
161 ├─────────────────────────────┼─────────────────────────────┤
162 │Interface Stability │ See below. │
163 └─────────────────────────────┴─────────────────────────────┘
164 The invocation is Evolving. The output is Unstable.
167
169 pooladm(1M), poolcfg(1M), libpool(3LIB), project(4), attributes(5),
170 zones(5)
171SunOS 5.11 9 Feb 2005 poolbind(1M)