drivers/staging/unisys/Documentation/proc-entries.txt - kernel/bruno - Git at Google

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