Open_LVM_Engine

This function opens the LVM Engine and readies it for use.


#include <lvm_intr.h>

void _System Open_LVM_Engine(

    BOOLEAN      Ignore_CHS,   /* (I) Set TRUE to disable validation of CHS values */
    CARDINAL32 * Error_Code    /* (O) Address where the error code will be stored */

);

Parameters:

Ignore_CHS
If TRUE, then the LVM engine will not check the CHS values in the MBR/EBR partition tables for validity.

This is useful if there are drive geometry problems, as for instance if the drive was partitioned and formatted with one geometry and then moved to a different machine which uses a different geometry for the drive. This would cause the starting and ending CHS values in the partition tables to be inconsistent with the size and partition offset entries in the partition tables.

Setting Ignore_CHS to TRUE will disable the LVM Engine's CHS consistency checks, thereby allowing the drive to be partitioned.

Error_Code
The address of a CARDINAL32 in which to store an error code should an error occur.

Returns:

N/A.

Errors:

If an error occurs, the value pointed to by Error_Code will be greater than 0.

If this function aborts with an error, all memory allocated during the course of this function will be released. Disk read errors will only cause this function to abort if none of the disk drives in the system could be successfully read.

Side Effects:

The LVM Engine will be initialized. The partition tables for all OS2DASD-controlled disk drives will be read into memory. Memory will be allocated for the data structures used by the LVM Engine.

Notes:

None.

16-Bit Equivalent:

void _Far16 _Pascal _loadds OPEN_LVM_ENGINE16(
    BOOLEAN             Ignore_CHS,
    CARDINAL32 * _Seg16 Error_Code
);