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