IPB
>  Man Pages > Unix > Solaris 10 11/06 > Section 1M > pbind man page

pbind man page

Section 1M - Solaris 10 11/06 Man Pages

Other operating system man pages available here


Advanced Search

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)

Useful Links

Go Back

Visitor Statistics


Valid XHTML 1.0 Transitional     Valid CSS!

Cambridge Plus :: Pyrenees Places of Interest and Areas of Natural Beauty :: Robust Foot Switch :: Classic British Piston Rings
Unix Man Pages / Linux Man Pages :: HiFi Forum :: SIP VoIP Phone & Provider Reviews :: UNIX/Linux Forum Archives

More info on advertising on Unix/Linux Forum