svcadm(8)을 검색하려면 섹션에서 8 을 선택하고, 맨 페이지 이름에 svcadm을 입력하고 검색을 누른다.
plgrp(1)
plgrp(1) User Commands plgrp(1)
NAME
plgrp - observe and affect home lgroup and lgroup affinities of threads
SYNOPSIS
plgrp [-F] [-h] pid | core [/lwps] ...
plgrp [-F] -i pid[/lwps] ...
plgrp [-F] -a lgroup_list pid[/lwps] ...
plgrp [-F] [-I default | none |future]
-H lgroup_list pid[/lwps] ...
plgrp [-F] [-I default | none |future] -H lgroup_list -e command [arguments]
plgrp [-F] [-I default | none | future]
-A lgroup_list/none | weak | strong [,...] pid[/lwps] ...
plgrp [-F] [-I default | none | future]
-A lgroup_list/none | weak |strong [,...] -e command [arguments]
plgrp [-F] -I default | none | future pid[/lwps]
plgrp [-F] -I default | none | future -e command [arguments] ...
DESCRIPTION
plgrp displays or sets the home lgroup and lgroup affinities for one or
more processes, threads, or LWPs.
An lgroup represents the set of CPU and memory-like hardware devices
that are at most some distance (latency) apart from each other. Each
lgroup in the system is identified by a unique lgroup ID. The lgroups
are organized into a hierarchy to facilitate finding the nearest re‐
sources. See lgrpinfo(1) for more about lgroups and the lgroup hierar‐
chy.
By default, each thread is assigned a home lgroup upon creation. When
the system needs to allocate a CPU or memory resource for a thread, it
searches the lgroup hierarchy from the thread's home lgroup for the
nearest available resources to the thread's home.
Typically, the home lgroup for a thread is the lgroup for which the
thread has the most affinity. Initially, the system chooses a home
lgroup for each thread, but leaves the thread's affinity for that
lgroup set to none. If a thread sets a stronger affinity for an lgroup
in its processor set other than its home, the thread is rehomed to that
lgroup as long as the thread is not bound to a CPU. The thread can be
re-homed to the lgroup in its processor set with the next highest
affinity when the affinity (if any) for its home lgroup is removed (set
to none).
The different levels of lgroup affinities and their semantics are fully
described in lgrp_affinity_set(3LGRP).
USAGE
Specifying lgroups
lgroup_list is a comma separated list of one or more of the following:
o lgroup_ID
o Range of lgroup_IDs specified as <start lgroup_ID>-<end
lgroup_ID>
o all
o root
o leaves
The all keyword represents all lgroup IDs in the system. The root key‐
word represents the ID of the root lgroup. The leaves keyword repre‐
sents the IDs of all leaf lgroups, that is, lgroups which do not have
any children.
Specifying Processes and Threads
plgrp takes one or more space separated processes or threads as argu‐
ments. Processes and threads can be specified in a manner similar to
the proc(1) tools. A process ID can be specified as an integer pid or
/proc/pid. Shell expansions can be used to specify processes when
/proc/pid is used. For example, /proc/* can be used to specify all the
processes in the system. If a process ID is given alone, then all the
threads of the process are included as arguments to plgrp.
A thread can be explicitly specified with its process ID and thread ID
given together as pid/lwpid. Multiple threads of a process can be se‐
lected at once by using the hyphen (-) and comma (,). For example,
pid/1,2,7-9 specifies threads 1, 2, 7, 8, and 9 of the process with pid
as its process ID.
OPTIONS
The following options are supported:
-a lgroup_list
Display lgroup affinities of specified processes or threads for the
specified lgroup_list.
-A lgroup_list/none|weak|strong[,...]
Set affinity of specified processes or threads for the specified
lgroup_list.
A comma separated list of lgroups/affinity assignments can be given
to set several affinities at once.
-e
Create a new process, apply plgrp to that process, and execute the
specified command and arguments.
-F
Force by grabbing the target process even if another process has
control. Caution should be exercised when using the -F flag. Impos‐
ing two controlling processes on one victim process can lead to
chaos. Safety is assured only when the primary controlling process
(typically a debugger) has stopped the victim process, but isn't
doing anything during the application of this proc tool. See WARN‐
INGS for more details.
-h
Get home lgroup of specified processes and/or threads. If no op‐
tions are specified, this is the default.
-H lgroup_list
Set home lgroup of specified processes and threads.
This sets a strong affinity for the desired lgroup to re-home the
threads. If more than one lgroup is specified, plgrp tries to home
the threads to the lgroups in a round robin fashion.
-i
Display lgroup affinity inheritance of the specified processes or
threads.
-I default | none | future
Set lgroup affinity inheritance for the specified processes or
threads.
-?
--help
Print usage message and immediately exit.
OPERANDS
The following operands are supported:
lwps Specifies thread. See USAGE.
pid Specifies process ID. See USAGE.
EXAMPLES
Example 1 Getting the Home lgroup for the Shell
The following example gets the home lgroup for the shell:
% plgrp $$
PID/LWPID HOME
3401/1 1
Example 2 Setting the Home lgroup of Multiple Threads
The following example sets the home lgroup of multiple threads to the
root lgroup:
% plgrp -H root `pgrep firefox`
PID/LWPID HOME
918/1 1 => 0
934/1 2 => 0
934/2 1 => 0
934/3 2 => 0
934/625 1 => 0
934/626 2 => 0
934/624 2 => 0
934/623 2 => 0
934/630 1 => 0
Example 3 Executing a New Process with Home lgroup Set
The following example executes firefox with root as the home lgroup of
multiple threads:
% plgrp -H root -e /usr/bin/firefox
Example 4 Getting Specific Threads' Affinities for Given lgroups
The following example gets two threads' affinities for lgroups 0-2:
% plgrp -a 0-2 101398/1 101337/1
PID/LWPID HOME AFFINITY
101398/1 1 0-2/none
101337/1 1 0-2/none
Example 5 Setting lgroup Affinities
The following example sets lgroup affinities:
% plgrp -A 0/weak,1/none,2/strong 101398
PID/LWPID HOME AFFINITY
101398/1 1 => 2 0,2/none => 2/strong,0/weak
EXIT STATUS
The following exit values are returned:
0 Successful completion.
1 Syntax error. Nothing was changed.
2 Non-fatal error or interrupt. Something might have changed.
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
tab() box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) ATTRIBUTE TYPEAT‐
TRIBUTE VALUE _ Availabilitysystem/core-os _ Interface StabilitySee be‐
low.
The command syntax and output formats are Uncommitted.
SEE ALSO
lgrpinfo(1), madv.so.1(1), pmadvise(1), pmap(1), proc(1), ps(1),
lgrp_affinity_get(3LGRP), lgrp_affinity_inherit_get(3LGRP), lgrp_affin‐
ity_inherit_set(3LGRP), lgrp_affinity_set(3LGRP), lgrp_home(3LGRP), li‐
blgrp(3LIB), proc(5), attributes(7), prstat(8)
WARNINGS
The plgrp utility stops its target processes while inspecting them. A
process can do nothing while it is stopped. Stopping a heavily used
process in a production environment (even for a short amount of time)
can cause severe bottlenecks and even hangs of these processes, making
them to be unavailable to users. Thus, stopping a UNIX process in a
production environment should be avoided. See proc(1).
A process that is stopped by this tool might be identified by issuing
the following command:
/usr/bin/ps -eflL
and looking for a T in the first column of the output. Certain
processes, for example, sched, can show the T status by default most of
the time.
HISTORY
Support for the -? and --help options was added in Oracle Solaris
11.4.42.
The plgrp command, including support for the -a, -A, -e, -F, -h, -H,
-i, and -I options was introduced in Oracle Solaris 11.0.0.
Oracle Solaris 11.4 29 Nov 2022 plgrp(1)