|
Hopefully, this page is exactly what you are looking for, but if not, you can always find further assistance on Unix/Linux Forum!
System Administration Commands pbind(1M)
NAME
pbind - control and query bindings of processes or LWPs
SYNOPSIS
pbind -b processor_id pid [/lwpid]...
pbind [-q] [pid [/lwpid]...]
pbind -Q [processor_id...]
pbind -u pid [/lwpid]...
pbind -U [processor_id...]
DESCRIPTION
pbind controls and queries bindings of processes and LWPs
(lightweight processes) to processors. pbind can also remove
processor bindings that were previously established.
When an LWP is bound to a processor, it will be executed
only by that processor except when the LWP requires a
resource that is provided only by another processor. The
binding is not exclusive, that is, the processor is free
execute other LWPs as well.
Bindings are inherited, so new LWPs and processes created by
a bound LWP will have the same binding. Binding an interac-
tive shell to a processor, for example, binds all commands
executed by the shell.
Superusers may bind or unbind any process or LWP, while
other users can bind or unbind any process or LWP for which
they have permission to signal, that is, any process that
has the same effective user ID as the user.
OPTIONS
The following options are supported:
-b processor_id Binds all or a subset of the LWPs of
the specified processes to the pro-
cessor processor_id. Specify
processor_id as the processor ID of
the processor to be controlled or
queried. processor_id must be
present and on-line. Use the psrinfo
command to determine whether or not
processor_id is present and on-line.
See psrinfo(1M).
SunOS 5.10 Last change: 18 July 2004 1
System Administration Commands pbind(1M)
-q Displays the bindings of the speci-
fied processes or of all processes.
If a process is composed of multiple
LWPs which have different bindings
and the LWPs are not explicitly
specified, the bindings of only one
of the bound LWPs will be displayed.
The bindings of a subset of LWPs can
be displayed by appending "/lwpids"
to the process IDs. Multiple LWPs
may be selected using "-" and ","
delimiters. See EXAMPLES.
-Q Displays the LWPs bound to the
specified list of processors, or all
LWPs with processor bindings. For
processes composed of multiple LWPs,
the bindings of individual LWPs will
be displayed.
-u Removes the bindings of all or a
subset of the LWPs of the specified
processes, allowing them to be exe-
cuted on any on-line processor.
-U Removes the bindings of all LWPs
bound to the specified list of pro-
cessors, or to any processor if no
argument is specified.
OPERANDS
The following operands are supported:
pid The process ID of the process to be
controlled or queried.
lwpid The set of LWP IDs of the specified
process to be controlled or queried.
The syntax for selecting LWP IDs is
as follows:
2,3,4-8 LWP IDs 2, 3, and 4 through 8
SunOS 5.10 Last change: 18 July 2004 2
System Administration Commands pbind(1M)
-4 LWPs whose IDs are 4 or below
4- LWPs whose IDs are 4 or above
processor_id The processor ID of the processor to
be controlled or queried.
EXAMPLES
Example 1: Binding Processes
The following example binds processes 204 and 223 to proces-
sor 2:
example% pbind -b 2 204 223
process id 204: was 2, now 2
process id 223: was 3, now 2
Example 2: Unbinding a Process
The following example unbinds process 204:
example% pbind -u 204
Example 3: Querying Bindings
The following example queries bindings. It demonstrates that
process 1 is bound to processor 0, process 149 has at least
one LWP bound to CPU3, and process 101 has no bound LWPs.
example% pbind -q 1 149 101
process id 1: 0
process id 149: 3
process id 101: not bound
Example 4: Querying LWP Bindings
The following example queries bindings of LWPs. It demon-
strates that LWP 1 of process 149 is bound to CPU3, and LWP
2 of process 149 is not bound.
example% pbind -q 149/1-2
lwp id 149/1: 3
lwp id 149/2: not bound
Example 5: Querying LWP Bindings for Processor 2:
SunOS 5.10 Last change: 18 July 2004 3
System Administration Commands pbind(1M)
The following example queries all LWPs bound to processor 2:
example% pbind -Q 2
lwp id 149/4: 2
lwp id 149/5: 2
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWcsu |
|_____________________________|_____________________________|
EXIT STATUS
The following exit values are returned:
0 Successful completion.
>0 An error occurred.
SEE ALSO
psradm(1M), psrinfo(1M), psrset(1M), processor_bind(2),
processor_info(2), sysconf(3C), attributes(5)
DIAGNOSTICS
pbind: cannot query pid 31: No suchprocess
The process specified did not exist or has exited.
pbind: cannot bind pid 31: Not owner
The user does not have permission to bind the process.
pbind: cannot bind pid 31: Invalid argument
The specified processor is not on-line.
SunOS 5.10 Last change: 18 July 2004 4
Man(1) output converted with
man2html and wrapped by fishsponge
This page was generated on Wed Sep 12 11:26:23 GMT 2007
|
Your favourite pages:
No pages logged yet... Top 10 most popular pages:
prstat man page (24546 hits) (Solaris 10 11_06)
netcat man page (17695 hits) (Suse Linux 10.1)
ssh-socks5-proxy-connect man page (13531 hits) (Solaris 10 11_06)
signal man page (12551 hits) (Suse Linux 10.1)
startproc man page (11991 hits) (Suse Linux 10.1)
raidctl man page (11357 hits) (Solaris 10 11_06)
adv_cap_autoneg man page (10285 hits) (Solaris 10 11_06)
sqlite3 man page (9729 hits) (openSUSE 10.2)
CPAN man page (8947 hits) (Suse Linux 10.1)
BusyBox man page (7702 hits) (Suse Linux 10.1)
|