vparutil.1m (2011 03)

v
vparutil(1M) vparutil(1M)
NAME
vparutil - get and set SCSI parameters for SCSI controllers from a virtual partition
SYNOPSIS
vparutil -d dev_path
vparutil -g dev_path
vparutil -s dev_path [-i scsi_id ][
-r scsi_rate ]
DESCRIPTION
The
vparutil command gets and sets SCSI parameters for SCSI controllers within a running virtual
partition. When setting the SCSI parameters using the
-s option, the virtual partition which owns the
specified SCSI controller must be in the down state. If not, the command will fail with the appropriate
error code.
The SCSI parameters for a given SCSI controller must first be set (from the firmware BCH prompt or
using the
-s option) before the parameters can be retrieved using the
-g option.
The
vparutil command is allowed on Itanium-based platforms for compatibility. No action is taken
for the vparutil command.
Options
vparutil recognizes the following command-line options:
-d Deletes an entry for the specified SCSI controller at dev_path from the SCSI table.
-g Gets the SCSI parameters for the specified SCSI controller at dev_path.
-s Sets the SCSI parameters for the specified SCSI controller at dev_path.
Operands
vparutil recognizes the following command-line operands:
dev_path The device path of the SCSI controller.
id The SCSI ID for the specified controller (defaults to 7).
rate The SCSI rate for the specified controller. This parameter can have one of two values:
fast and ultra, for the corresponding fast wide and ultra wide SCSI interfaces.
Note
For managing SCSI controllers, use corresponding SCSI utilities like mptconfig(1M).
SECURITY RESTRICTIONS
This command is restricted to processes owned by superuser.
When virtual partition flexible administrative capability is enabled, only a Designated-Admin vPar can
set SCSI parameters for SCSI controllers.
EXAMPLES
Set the SCSI ID for controller at 0/0/2/0 to 3 with the fast wide rate:
#
vparutil -s 0/0/2/0 -i 3 -r fast
RETURN VALUE
0 Successful.
1 Invalid SCSI controller specification.
2 Invalid SCSI ID.
3 Could not communicate with virtual partition monitor.
4 Virtual partition which owns SCSI controller is not in down state.
5 Internal firmware call failed.
6 Other error.
AUTHOR
vparutil was developed by the Hewlett-Packard Company.
HP-UX 11i Version 3: March 2011 − 1 − Hewlett-Packard Company 1