Deletes a logical volume from its volume group.
Logical Volume Manager Library (liblvm.a)
int lvm_deletelv (LV_ID) struct lv_id *LV_ID;
The lvm_deletelv subroutine deletes the logical volume specified by the LV_ID parameter from its volume group. The logical volume must not be opened, and the volume group must be online, or an error is returned. Also, all logical partitions belonging to this logical volume must be removed using the lvm_reducelv subroutine before the logical volume can be deleted.
Note: You must have root user authority to use this subroutine.
|LV_ID||Specifies the logical volume to be deleted.|
The lvm_deletelv subroutine returns a value of 0 upon successful completion.
If the lvm_deletelv subroutine fails, it returns one of the following values:
|LVM_ALLOCERR||A memory allocation error occurred.|
|LVM_DALVOPN||The logical volume reserved by the volume group could not be opened.|
|LVM_FORCEOFF||The volume group has been forcefully varied off due to a loss of quorum.|
|LVM_INVALID_MIN_NUM||An invalid minor number was received.|
|LVM_INVALID_PARAM||The logical volume ID passed in is not a valid logical volume, or the pointer to the logical volume is invalid.|
|LVM_INVCONFIG||An error occurred while attempting to configure this volume group into the kernel. This error will normally result if the major number in the mapped file is invalid.|
|LVM_INV_DEVENT||The device entry for the logical volume is invalid and cannot be checked to determine if it is raw.|
|LVM_LVOPEN||An open logical volume was encountered when it should be closed.|
|LVM_MAPFBSY||The volume group is currently locked because system management on the volume group is being done by another process.|
|LVM_MAPFOPN||The mapped file, which contains a copy of the volume group descriptor area used for making changes to the volume group, could not be opened.|
|LVM_MAPFRDWR||An error occurred while trying to read or write the mapped file.|
|LVM_NODELLV||The logical volume cannot be deleted because there are existing logical partitions.|
|LVM_NOTCHARDEV||The device specified is not a raw or character device.|
|LVM_OFFLINE||A routine that requires a volume group to be online has encountered one that is offline.|
This subroutine is part of Base Operating System (BOS) Runtime.
The lvm_varyonvg subroutine.
List of Logical Volume Subroutines and Logical Volume Programming Overview in AIX Version 4.3 General Programming Concepts: Writing and Debugging Programs.