staging: unisys: Documentation: Remove proc-entries.txt

 s-Par Proc Entries

This document describes the proc entries created by the Unisys s-Par modules.

Support Module Entries

These entries are provided primarily for debugging.

/proc/uislib/info: This entry contains debugging information for the

uislib module, including bus information and memory usage.

/proc/visorchipset/controlvm: This directory contains debugging

entries for the controlvm channel used by visorchipset.

/proc/uislib/platform: This entry is used to display the platform

number this node is in the system. For some guests, this may be

invalid.

/proc/visorchipset/chipsetready: This entry is written to by scripts

to signify that any user level activity has been completed before the

guest can be considered running and is shown as running in the s-Par

UI.

Device Entries

These entries provide status of the devices shared by a service partition.

/proc/uislib/vbus: this is a directory containing entries for each

virtual bus. Each numbered sub-directory contains an info entry, which

describes the devices that appear on that bus.

/proc/uislib/cycles_before_wait: This entry is used to tune

performance, by setting the number of cycles we wait before going idle

when in polling mode. A longer time will reduce message latency but

spend more processing time polling.

/proc/uislib/smart_wakeup: This entry is used to tune performance, by

enabling or disabling smart wakeup.

/proc/virthba/info: This entry contains debugging information for the

virthba module, including interrupt information and memory usage.

/proc/virthba/enable_ints: This entry controls interrupt use by the

virthba module. Writing a 0 to this entry will disable interrupts.

/proc/virtnic/info: This entry contains debugging information for the

virtnic module, including interrupt information, send and receive

counts, and other device information.

/proc/virtnic/ethX: This is a directory containing entries for each

virtual NIC. Each named subdirectory contains two entries,

clientstring and zone.

/proc/virtpci/info: This entry contains debugging information for the

virtpci module, including virtual PCI bus information and device

locations.

/proc/virtnic/enable_ints: This entry controls interrupt use by the

virtnic module. Writing a 0 to this entry will disable interrupts.

Visorconinclient, visordiag, visornoop, visorserialclient, and

visorvideoclient Entries

The entries in proc for these modules all follow the same

pattern. Each module has its own proc directory with the same name,

e.g. visordiag presents a /proc/visordiag directory. Inside of the

module's directory are a device directory, which contains one numbered

directory for each device provided by that module. Each device has a

diag entry that presents the device number and visorbus name for that

device. The module directory also has a driver/diag entry, which

reports the corresponding s-Par version number of the driver.

Automated Installation Entries

These entries are used to pass information between the s-Par platform

and the Linux-based installation and recovery tool. These values are

read/write, however, the guest can only reset them to 0, or report an

error status through the installer entry. The values are only set via

s-Par's firmware interface, to help prevent accidentally booting into

the tool.

/proc/visorchipset/boottotool: This entry instructs s-Par that the

next reboot will launch the installation and recovery tool. If set to

0, the next boot will happen according to the UEFI boot manager

settings.

/proc/visorchipset/toolaction: This entry indicates the installation

and recovery tool mode requested for the next boot.

/proc/visorchipset/installer: this entry is used by the installation

and recovery tool to pass status and result information back to the

s-Par firmware.

/proc/visorchipset/partition: This directory contains the guest

partition configuration data for each virtual bus, for use during

installation and at runtime for s-Par service partitions.

M:	David Kershner <sparmaintainer@unisys.com>

S:	Maintained

F:	Documentation/s-Par/overview.txt

F:	Documentation/s-Par/proc-entries.txt

F:	drivers/staging/unisys/