sys_clock(1M) (Sun Enterprise 10000 SSP 3.5 Reference Manual)

Sun Enterprise 10000 SSP 3.5 Reference Manual

sys_clock(1M)

NAME

sys_clock- display/change/set system clock frequencies

SYNOPSIS

sys_clock

-m

ctrl_board_num

-i

ic_freq

-p

proc_multiple

-s

sys_clock

-i

ic_freq

-p

proc_multiple

-s

CAUTION

When executing this command on the command line, do so in its default form, with no options, unless you are an expert user. These options attempt to reset or change target frequencies and such attempts can result in poor performance or a system crash.

DESCRIPTION

When executed with no command-line options, sys_clock displays both target and actual clock frequencies of the interconnect and JTAG, and the processor-to-interconnect clock ratio.

The SSP package is distributed with a set of target clock frequencies intended to maximize performance of the Sun Enterprise 10000 system. These target frequencies are maintained by the snmpd(1M) agent. Normally, centerplane support and system boards receive their clock values from one of the two possible control boards. The default source clock is the primary control board.

sys_clock is executed automatically during system initialization.

OPTIONS

The following options are supported:

Note -

When executed with its -i or -p options, sys_clock only changes the target settings maintained by the snmpd(1M) agent. These settings are passed to the Sun Enterprise 10000 system the next time sys_clock -s is executed. To use these options to immediately change the settings of the Sun Enterprise 10000 system, include -s on the same command line.

-i ic_freq: Set the target interconnect clock frequency to the specified value, in hertz. Valid values range from 40000000 (40.0Mhz) to 120000000 (120.0 Mhz), inclusive.
-m ctrl_board_num: Program the boards with the number of the control board that is providing the system clock.
-p proc_multiple: Set the target processor-to-interconnect clock ratio to the specified values, which is one of the following: two-to-one, three-to-one, three-to-two, or five-to-two.
-s: Like -m, program the boards with the number of the control board that is providing the system clock; unlike -m, also set the hardware clock frequencies to the target frequencies maintained by the snmpd(1M) agent. sys_clock -s is executed automatically each time the Sun Enterprise 10000 system is powered on.

EXAMPLES

Example 1 Displaying the Target and Actual System Clock Frequencies

% sys_clock
Current Clock Frequencies:
--------------------------
Interconnect: 83.25 Mhz
Processor:   333.01 Mhz
JTAG:          5.20 Mhz

Targeted Clock Frequencies:
---------------------------
Interconnect: 83.33 Mhz
Proc Clock Ratio: three-to-two
JTAG:          5.00 Mhz

Note -

The JTAG clock frequencies will only be displayed on control boards that support the display of JTAG frequencies.

Example 2 Modifying the Target Clock Frequencies

% sys_clock -i 83333333 -p two-to-one

Example 3 Setting the System Clock Frequencies

% sys_clock -s

ERRORS

Error: Failed to get SSP host name for domain xf4.

The snmpd(1M) agent may not be running. This message might be returned when no domains are configured and the SUNW_HOSTNAME environment variable is set to a domain name. Try setting SUNW_HOSTNAME to the platform name.

FILES

The following file is supported:

$SSPETC/snmp/Ultra-Enterprise-10000.mib: The Sun Enterprise 10000 MIB definition file