HP-UX Reference (11i v1 05/09) - 1M System Administration Commands N-Z (vol 4)

v
vparremove(1M) vparremove(1M)
NAME
vparremove - remove a virtual partition
SYNOPSIS
vparremove -p vp_name [-D db_file][
-f]
DESCRIPTION
The
vparremove command deletes a virtual partition previously created using the
vparcreate com-
mand. All resources associated with the virtual partition are made available for allocation to other parti-
tions.
Only a superuser can execute the
vparremove command. In a secure virtual partition environment only
a Primary-Admin
vPar can remove a virtual partition.
Unintentional use of this command has serious consequences; therefore the user is prompted to confirm the
operation unless the
-f (force) option is specified.
Options
vparremove recognizes the following command line options and arguments:
-p vp_name Specifies the unique name of the virtual partition which is to be removed. Required.
-D db_file Removes a virtual partition from the partition database contained in db_file. If this
option is omitted, the virtual partition is removed from the monitor’s database. In
this case, the partition must be in the
Down state to be removed. Thus it is an error
to try to remove the current virtual partition, the one in which the command is exe-
cuting.
-f Specifies the force option. Omits the confirmation dialog before removing the virtual
partition. This option is intended for use by scripts and other non-interactive applica-
tions.
RETURN VALUE
The vparremove command exits with one of the following values:
0 Successful completion.
1 One or more error conditions occurred.
EXAMPLES
Destroy the virtual partition Oslo in the partition database currently running in the monitor:
vparremove -p Oslo
Remove virtual partition Oslo? [n]: y
Destroy the virtual partition Oslo in the partition database currently running in the monitor using the
force option:
vparremove -f -p Oslo
Delete partition Bergen in partition database file Norway:
vparremove -f -D /stand/Norway -p Bergen
ERRORS
vparremove displays error messages on stderr for any of the following conditions:
• db_file does not exist, cannot be accessed, is not a virtual partition database file, or is corrupt.
• vp_name does not exist in the monitor’s database or in db_file.
• vp_name in the monitor’s database is in some state other than Down.
• The vparremove command and the virtual partition monitor are at different revision levels.
AUTHOR
vparremove was developed by the Hewlett-Packard Company.
SEE ALSO
vparadmin(1M), vparboot(1M), vparcreate(1M), vparmodify(1M), vparreset(1M), vparstatus(1M), vpar-
resources(5), vpartition(5), vpmon(5).
Section 1M−−1112 Hewlett-Packard Company − 1 − HP-UX 11i Version 1: September 2005