mpadmin(1) mpadmin(1)
NAME
mpadmin - control and report processor status
SYNOPSIS
mpadmin -n
mpadmin -u[processor]
mpadmin -r[processor]
mpadmin -c[processor]
mpadmin -f[processor]
mpadmin -I[processor]
mpadmin -U[processor]
mpadmin -D[processor]
mpadmin -C[processor]
mpadmin -s
DESCRIPTION
mpadmin provides control/information of processor status.
Exactly one argument is accepted by mpadmin at each invocation. The
following arguments are accepted:
-n Report which processors are physically configured. The
numbers of the physically configured processors are written
to the standard output, one processor number per line.
Processors are numbered beginning from 0.
-u[processor]
When no processor is specified, the numbers of the
processors that are available to schedule unrestricted
processes are written to the standard output. Otherwise,
mpadmin enables the processor number processor to run any
unrestricted processes.
-r[processor]
When no processor is specified, the numbers of the
processors that are restricted from running any processes
(except those assigned via the sysmp(MP_MUSTRUN) function,
the runon(1) command, or because of hardware necessity) are
written to the standard output. Otherwise, mpadmin
restricts the processor numbered processor.
Page 1
mpadmin(1) mpadmin(1)
-c[processor]
When no processor is specified, the number of the processor
that handles the operating system software clock is written
to the standard output. Otherwise, operating system
software clock handling is moved to the processor numbered
processor. See timers(5) for more details.
-f[processor]
When no processor is specified, the number of the processor
that handles the operating system fast clock is written to
the standard output. Otherwise, operating system fast clock
handling is moved to the processor numbered processor. See
ftimer(1) and timers(5) for a description of the fast clock
usage.
-I[processor]
When no processor is specified, the numbers of the
processors that are isolated are written to the standard
output. Otherwise, mpadmin isolates the processor numbered
processor. An isolated processor is restricted as by the -r
argument. In addition, instruction cache and Translation
Lookaside Buffer synchronization are blocked, and
synchronization is delayed until a system service is
requested.
-U[processor]
When no processor is specified, the numbers of the
processors that are not isolated are written to the standard
output. Otherwise, mpadmin unisolates the processor
numbered processor.
-D[processor]
When no processor is specified, the numbers of the
processors that are not running the clock scheduler are
written to the standard output. Otherwise, mpadmin disables
the clock scheduler on the processor numbered processor.
This makes that processor nonpreemptive, so that normal IRIX
process time slicing is no longer enforced. Processes that
run on a non-preemptive processor are not preempted because
of timer interrupts. They are preempted only when
requesting a system service that causes them to wait, or
that makes a higher-priority process runnable (for example,
posting a semaphore).
-C[processor]
When no processor is specified, the numbers of the
processors that are running the clock scheduler are written
to the standard output. Otherwise, mpadmin enables the
clock scheduler on the processor numbered processor.
Processes on a preemptive processor can be preempted at the
end of their time slice.
Page 2
mpadmin(1) mpadmin(1)
-s A summary of the unrestricted, restricted, isolated,
preemptive and clock processor numbers is written to the
standard output.
SEE ALSO
ftimer(1), runon(1), sysmp(2), timers(5).
DIAGNOSTICS
When an argument specifies a processor, 0 is returned on success, -1 on
failure. Otherwise, the number of processors associated with argument is
returned.
WARNINGS
It is not possible to restrict or isolate all processors. Processor 0
must never be restricted or isolated.
BUGS
Changing the clock processor may cause the system to lose a small amount
of system time.
Page 3