vparreset

vparreset - graphics/vparresetappendixb.gif Sends a TOC or hard reset to a virtual partition.

vparreset(1M) vparreset(1M) NAME vparreset - reset a virtual partition SYNOPSIS vparreset -p vp_name [-h-t] [-q] [-f] DESCRIPTION The vparreset command simulates, at the virtual partition level, the RS and TOC operations at a Control-B prompt on the system console. Only a superuser can execute the vparreset command. vparreset causes the virtual partition monitor to simulate a hard (RS) reset or soft (TOC) reset of the specified virtual partition. Either operation gathers new Processor Information Module (PIM) data, which is displayed unless the -q (quiet) option is also specified. Unintentional use of the vparreset command has serious consequences; therefore the user is prompted to confirm the operation unless the -f (force) option is specified. Options vparreset recognizes the following command line options and arguments: -p vp_name Specifies the unique name of the virtual partition to be reset.The virtual partition must be in a state other than Down or Crashing. Required. -t Simulates a TOC reset. Displays current PIM data before resetting unless the -q option is also specified. The TOC reset is also the default operation of the command, applied if neither the -h nor -t option is specified. The -t and -h options cannot both be specified in the same command. -h Simulates a hard (RS) reset instead of a TOC. Displays current PIM data before resetting unless the -q option is also specified. -q Bypasses the display of current PIM data when resetting the virtual partition. -f The force option. Omits the confirmation dialog before resetting the virtual partition. This option is intended for use by scripts and other non-interactive applications. RETURN VALUE The vparreset command exits with one of the following values: 0 Successful completion. 1 One or more error conditions occurred. EXAMPLES Perform a TOC reset on the virtual partition called Oslo, dumping the PIM data: vparreset -p Oslo -t Reset virtual partition Oslo? [n] y Perform a hard reset on virtual partition Bergen skipping the confirmation dialog: vparreset -p Bergen -h -f ERRORS vparreset displays error messages on stderr for any of the following conditions: + A required option is omitted. + An unknown option is specified. + A value is omitted for an argument that requires one, or a value is specified for an argument which does not take one. + vp_name does not exist in the monitor database, or is in the wrong state. + Both the -h and -t options are specified. AUTHOR vparreset was developed by the Hewlett-Packard Company. SEE ALSO vparboot(1M) , vparcreate(1M) , vparmodify(1M) , vparremove(1M) , vparstatus(1M) , vparresources(5) , vpartition(5) .