| 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. |