powerpc-utils package
==========================

Mailing List: powerpc-utils-devel@googlegroups.com
Subscribe: https://groups.google.com/forum/#!forum/powerpc-utils-devel/join

This package contains utilities which are intended for maintenance of IBM 
powerpc platforms that follow the POWER Architecture Platform Reference (PAPR),
This package requires the librtas package in order to function properly.
All of these utilities must be run as root.

The virtual IO administration utilities included in this package require the 
systool application.

Further documentation for each of these utilities is available in their
corresponding man pages.

update_flash:  system firmware update utility
------------
A script that uses the rtas_flash kernel module to flash firmware.

set_poweron_time:  configure time for system power-on
----------------
A utility to set a time in the future for the system to automatically
power on, if the system is powered off at that time.

serv_config:  configure serviceability settings
-----------
A series of menus that can be used to update system service settings
stored in NVRAM, which are used by the system's service processor.
These settings include surveillance, boot, and remote maintenance
policies.  Different system configurations may expose different kinds
of serviceability parameters.

hvcsadmin: HVCS driver administration utility
-------
This is the hvcs driver administration utility which simplifies hvcs
administration by providing a set of options for such functions as closing
adapter targets using device mapping, querying console adapters, querying
adapters based upon device node, gathering status, and closing all open
adapters.  Documentation is provided in man page hvcsadmin (8).

drmgr:
-----
Dynamic reconfiguration manager.  This isn't neccessarily meant to be invoked
from the command line, but rather is the command invoked via the RMC connection
from an HMC.

lsslot:
------
Tool used to determine dyanmic reconfiguration capable slots/cpus/memory
on a partition.

lparnumascore:
------
Tool used to compute the NUMA affinity score reflecting the difference
between NUMA topology exposed by the hypervisor and the one the linux
kernel has taken in account.

ppc64_cpu:
---------
This allows users to set the smt state and other settings on ppc64 processors.
It also allows users to control the number of processor cores which are online
(not in the sleep state).

Previously this allowed setting of smt-snooze-delay, but Linux has not
supported this since 3.14.

lsdevinfo:
---------
This utility provides the HMC or IVM with name information for
virtual devices so they can be matched against the VIOS names.

usysident, usysattn, usysfault:
-------------------------------
Deprecated. Moved to ppc64-diag package.
https://github.com/power-ras/ppc64-diag

===================

The following tools are used by other maintenance utilities to gather
necessary information.  These tools are not typically invoked on the
command line.

activate_firmware:  concurrent firmware activation
-----------------
Used during concurrent firmware update operations to activate the new
firmware image locally.  This utility is invoked automatically when
necessary.

rtas_ibm_get_vpd:  
----------------
Used by the lsvpd utility to gather Vital Product Data that changes
dynamically.

hcnmgr:
---------
This utility provides the HMC tools to hybrid virtual network to allow
SR_IOV VFs on LPAR capable for live partition migration.