/*

 * The internal handle functions

 *

 * Copyright (C) 2014-2023, Joachim Metz <joachim.metz@gmail.com>

 *

 * Refer to AUTHORS for acknowledgements.

 *

 * This program is free software: you can redistribute it and/or modify

 * it under the terms of the GNU Lesser General Public License as published by

 * the Free Software Foundation, either version 3 of the License, or

 * (at your option) any later version.

 *

 * This program is distributed in the hope that it will be useful,

 * but WITHOUT ANY WARRANTY; without even the implied warranty of

 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

 * GNU General Public License for more details.

 *

 * You should have received a copy of the GNU Lesser General Public License

 * along with this program.  If not, see <https://www.gnu.org/licenses/>.

 */

#include <common.h>

#include <memory.h>

#include <narrow_string.h>

#include <system_string.h>

#include <types.h>

#include <wide_string.h>

#include "libvslvm_data_area_descriptor.h"

#include "libvslvm_debug.h"

#include "libvslvm_definitions.h"

#include "libvslvm_handle.h"

#include "libvslvm_io_handle.h"

#include "libvslvm_libbfio.h"

#include "libvslvm_libcdata.h"

#include "libvslvm_libcerror.h"

#include "libvslvm_libcnotify.h"

#include "libvslvm_metadata.h"

#include "libvslvm_metadata_area.h"

#include "libvslvm_raw_location_descriptor.h"

#include "libvslvm_types.h"

/* Creates a handle

 * Make sure the value handle is referencing, is set to NULL

 * Returns 1 if successful or -1 on error

 */

int libvslvm_handle_initialize(

     libvslvm_handle_t **handle,

     libcerror_error_t **error )

{

  libvslvm_internal_handle_t *internal_handle = NULL;

  static char *function                       = "libvslvm_handle_initialize";

  if( handle == NULL )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_ARGUMENTS,

     LIBCERROR_ARGUMENT_ERROR_INVALID_VALUE,

     "%s: invalid handle.",

     function );

    return( -1 );

  }

  if( *handle != NULL )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_RUNTIME,

     LIBCERROR_RUNTIME_ERROR_VALUE_ALREADY_SET,

     "%s: invalid handle value already set.",

     function );

    return( -1 );

  }

  internal_handle = memory_allocate_structure(

                     libvslvm_internal_handle_t );

  if( internal_handle == NULL )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_MEMORY,

     LIBCERROR_MEMORY_ERROR_INSUFFICIENT,

     "%s: unable to create handle.",

     function );

    goto on_error;

  }

  if( memory_set(

       internal_handle,

       0,

       sizeof( libvslvm_internal_handle_t ) ) == NULL )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_MEMORY,

     LIBCERROR_MEMORY_ERROR_SET_FAILED,

     "%s: unable to clear handle.",

     function );

    memory_free(

     internal_handle );

    return( -1 );

  }

  if( libvslvm_io_handle_initialize(

       &( internal_handle->io_handle ),

       error ) != 1 )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_RUNTIME,

     LIBCERROR_RUNTIME_ERROR_INITIALIZE_FAILED,

     "%s: unable to create IO handle.",

     function );

    goto on_error;

  }

  *handle = (libvslvm_handle_t *) internal_handle;

  return( 1 );

on_error:

  if( internal_handle != NULL )

  {

    if( internal_handle->io_handle != NULL )

    {

      libvslvm_io_handle_free(

       &( internal_handle->io_handle ),

       NULL );

    }

    memory_free(

     internal_handle );

  }

  return( -1 );

}

/* Frees a handle

 * Returns 1 if successful or -1 on error

 */

int libvslvm_handle_free(

     libvslvm_handle_t **handle,

     libcerror_error_t **error )

{

  libvslvm_internal_handle_t *internal_handle = NULL;

  static char *function                       = "libvslvm_handle_free";

  int result                                  = 1;

  if( handle == NULL )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_ARGUMENTS,

     LIBCERROR_ARGUMENT_ERROR_INVALID_VALUE,

     "%s: invalid handle.",

     function );

    return( -1 );

  }

  if( *handle != NULL )

  {

    internal_handle = (libvslvm_internal_handle_t *) *handle;

    if( ( internal_handle->file_io_handle != NULL )

     || ( internal_handle->physical_volume_file_io_pool != NULL ) )

    {

      if( libvslvm_handle_close(

           *handle,

           error ) != 0 )

      {

        libcerror_error_set(

         error,

         LIBCERROR_ERROR_DOMAIN_IO,

         LIBCERROR_IO_ERROR_CLOSE_FAILED,

         "%s: unable to close handle.",

         function );

        result = -1;

      }

    }

    *handle = NULL;

    if( libvslvm_io_handle_free(

         &( internal_handle->io_handle ),

         error ) != 1 )

    {

      libcerror_error_set(

       error,

       LIBCERROR_ERROR_DOMAIN_RUNTIME,

       LIBCERROR_RUNTIME_ERROR_FINALIZE_FAILED,

       "%s: unable to free IO handle.",

       function );

      result = -1;

    }

    memory_free(

     internal_handle );

  }

  return( result );

}

/* Signals the handle to abort its current activity

 * Returns 1 if successful or -1 on error

 */

int libvslvm_handle_signal_abort(

     libvslvm_handle_t *handle,

     libcerror_error_t **error )

{

  libvslvm_internal_handle_t *internal_handle = NULL;

  static char *function                       = "libvslvm_handle_signal_abort";

  if( handle == NULL )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_ARGUMENTS,

     LIBCERROR_ARGUMENT_ERROR_INVALID_VALUE,

     "%s: invalid handle.",

     function );

    return( -1 );

  }

  internal_handle = (libvslvm_internal_handle_t *) handle;

  if( internal_handle->io_handle == NULL )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_RUNTIME,

     LIBCERROR_RUNTIME_ERROR_VALUE_MISSING,

     "%s: invalid handle - missing IO handle.",

     function );

    return( -1 );

  }

  internal_handle->io_handle->abort = 1;

  return( 1 );

}

/* Opens a handle

 * Returns 1 if successful or -1 on error

 */

int libvslvm_handle_open(

     libvslvm_handle_t *handle,

     const char *filename,

     int access_flags,

     libcerror_error_t **error )

{

  libbfio_handle_t *file_io_handle            = NULL;

  libvslvm_internal_handle_t *internal_handle = NULL;

  static char *function                       = "libvslvm_handle_open";

  size_t filename_length                      = 0;

  if( handle == NULL )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_ARGUMENTS,

     LIBCERROR_ARGUMENT_ERROR_INVALID_VALUE,

     "%s: invalid handle.",

     function );

    return( -1 );

  }

  internal_handle = (libvslvm_internal_handle_t *) handle;

  if( filename == NULL )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_ARGUMENTS,

     LIBCERROR_ARGUMENT_ERROR_INVALID_VALUE,

     "%s: invalid filename.",

     function );

    return( -1 );

  }

  if( ( ( access_flags & LIBVSLVM_ACCESS_FLAG_READ ) == 0 )

   && ( ( access_flags & LIBVSLVM_ACCESS_FLAG_WRITE ) == 0 ) )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_ARGUMENTS,

     LIBCERROR_ARGUMENT_ERROR_UNSUPPORTED_VALUE,

     "%s: unsupported accesss flags.",

     function );

    return( -1 );

  }

  if( ( access_flags & LIBVSLVM_ACCESS_FLAG_WRITE ) != 0 )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_ARGUMENTS,

     LIBCERROR_ARGUMENT_ERROR_UNSUPPORTED_VALUE,

     "%s: write access currently not supported.",

     function );

    return( -1 );

  }

  if( libbfio_file_initialize(

       &file_io_handle,

       error ) != 1 )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_RUNTIME,

     LIBCERROR_RUNTIME_ERROR_INITIALIZE_FAILED,

     "%s: unable to create file IO handle.",

     function );

    goto on_error;

  }

#if defined( HAVE_DEBUG_OUTPUT )

  if( libbfio_handle_set_track_offsets_read(

       file_io_handle,

       1,

       error ) != 1 )

  {

                libcerror_error_set(

                 error,

                 LIBCERROR_ERROR_DOMAIN_RUNTIME,

                 LIBCERROR_RUNTIME_ERROR_SET_FAILED,

                 "%s: unable to set track offsets read in file IO handle.",

                 function );

    goto on_error;

  }

#endif

  filename_length = narrow_string_length(

                     filename );

  if( libbfio_file_set_name(

       file_io_handle,

       filename,

       filename_length + 1,

       error ) != 1 )

  {

                libcerror_error_set(

                 error,

                 LIBCERROR_ERROR_DOMAIN_RUNTIME,

                 LIBCERROR_RUNTIME_ERROR_SET_FAILED,

                 "%s: unable to set filename in file IO handle.",

                 function );

                goto on_error;

  }

  if( libvslvm_handle_open_file_io_handle(

       handle,

       file_io_handle,

       access_flags,

       error ) != 1 )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_IO,

     LIBCERROR_IO_ERROR_OPEN_FAILED,

     "%s: unable to open handle: %s.",

     function,

     filename );

                goto on_error;

  }

  internal_handle->file_io_handle_created_in_library = 1;

  return( 1 );

on_error:

  if( file_io_handle != NULL )

  {

    libbfio_handle_free(

     &file_io_handle,

     NULL );

  }

  return( -1 );

}

#if defined( HAVE_WIDE_CHARACTER_TYPE )

/* Opens a handle

 * Returns 1 if successful or -1 on error

 */

int libvslvm_handle_open_wide(

     libvslvm_handle_t *handle,

     const wchar_t *filename,

     int access_flags,

     libcerror_error_t **error )

{

  libbfio_handle_t *file_io_handle            = NULL;

  libvslvm_internal_handle_t *internal_handle = NULL;

  static char *function                       = "libvslvm_handle_open_wide";

  size_t filename_length                      = 0;

  if( handle == NULL )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_ARGUMENTS,

     LIBCERROR_ARGUMENT_ERROR_INVALID_VALUE,

     "%s: invalid handle.",

     function );

    return( -1 );

  }

  internal_handle = (libvslvm_internal_handle_t *) handle;

  if( filename == NULL )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_ARGUMENTS,

     LIBCERROR_ARGUMENT_ERROR_INVALID_VALUE,

     "%s: invalid filename.",

     function );

    return( -1 );

  }

  if( ( ( access_flags & LIBVSLVM_ACCESS_FLAG_READ ) == 0 )

   && ( ( access_flags & LIBVSLVM_ACCESS_FLAG_WRITE ) == 0 ) )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_ARGUMENTS,

     LIBCERROR_ARGUMENT_ERROR_UNSUPPORTED_VALUE,

     "%s: unsupported access flags.",

     function );

    return( -1 );

  }

  if( ( access_flags & LIBVSLVM_ACCESS_FLAG_WRITE ) != 0 )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_ARGUMENTS,

     LIBCERROR_ARGUMENT_ERROR_UNSUPPORTED_VALUE,

     "%s: write access currently not supported.",

     function );

    return( -1 );

  }

  if( libbfio_file_initialize(

       &file_io_handle,

       error ) != 1 )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_RUNTIME,

     LIBCERROR_RUNTIME_ERROR_INITIALIZE_FAILED,

     "%s: unable to create file IO handle.",

     function );

    goto on_error;

  }

#if defined( HAVE_DEBUG_OUTPUT )

  if( libbfio_handle_set_track_offsets_read(

       file_io_handle,

       1,

       error ) != 1 )

  {

                libcerror_error_set(

                 error,

                 LIBCERROR_ERROR_DOMAIN_RUNTIME,

                 LIBCERROR_RUNTIME_ERROR_SET_FAILED,

                 "%s: unable to set track offsets read in file IO handle.",

                 function );

    goto on_error;

  }

#endif

  filename_length = wide_string_length(

                     filename );

  if( libbfio_file_set_name_wide(

       file_io_handle,

       filename,

       filename_length + 1,

       error ) != 1 )

  {

                libcerror_error_set(

                 error,

                 LIBCERROR_ERROR_DOMAIN_RUNTIME,

                 LIBCERROR_RUNTIME_ERROR_SET_FAILED,

                 "%s: unable to set filename in file IO handle.",

                 function );

    goto on_error;

  }

  if( libvslvm_handle_open_file_io_handle(

       handle,

       file_io_handle,

       access_flags,

       error ) != 1 )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_IO,

     LIBCERROR_IO_ERROR_OPEN_FAILED,

     "%s: unable to open file: %ls.",

     function,

     filename );

    goto on_error;

  }

  internal_handle->file_io_handle_created_in_library = 1;

  return( 1 );

on_error:

  if( file_io_handle != NULL )

  {

    libbfio_handle_free(

     &file_io_handle,

     NULL );

  }

  return( -1 );

}

#endif /* defined( HAVE_WIDE_CHARACTER_TYPE ) */

/* Opens a handle using a Basic File IO (bfio) handle

 * Returns 1 if successful or -1 on error

 */

int libvslvm_handle_open_file_io_handle(

     libvslvm_handle_t *handle,

     libbfio_handle_t *file_io_handle,

     int access_flags,

     libcerror_error_t **error )

{

  libvslvm_internal_handle_t *internal_handle = NULL;

  static char *function                       = "libvslvm_handle_open_file_io_handle";

  uint8_t file_io_handle_opened_in_library    = 0;

  int bfio_access_flags                       = 0;

  int file_io_handle_is_open                  = 0;

  if( handle == NULL )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_ARGUMENTS,

     LIBCERROR_ARGUMENT_ERROR_INVALID_VALUE,

     "%s: invalid handle.",

     function );

    return( -1 );

  }

  internal_handle = (libvslvm_internal_handle_t *) handle;

  if( internal_handle->file_io_handle != NULL )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_RUNTIME,

     LIBCERROR_RUNTIME_ERROR_VALUE_ALREADY_SET,

     "%s: invalid handle - file IO handle already set.",

     function );

    return( -1 );

  }

  if( file_io_handle == NULL )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_ARGUMENTS,

     LIBCERROR_ARGUMENT_ERROR_INVALID_VALUE,

     "%s: invalid file IO handle.",

     function );

    return( -1 );

  }

  if( ( ( access_flags & LIBVSLVM_ACCESS_FLAG_READ ) == 0 )

   && ( ( access_flags & LIBVSLVM_ACCESS_FLAG_WRITE ) == 0 ) )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_ARGUMENTS,

     LIBCERROR_ARGUMENT_ERROR_UNSUPPORTED_VALUE,

     "%s: unsupported access flags.",

     function );

    return( -1 );

  }

  if( ( access_flags & LIBVSLVM_ACCESS_FLAG_WRITE ) != 0 )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_ARGUMENTS,

     LIBCERROR_ARGUMENT_ERROR_UNSUPPORTED_VALUE,

     "%s: write access currently not supported.",

     function );

    return( -1 );

  }

  if( ( access_flags & LIBVSLVM_ACCESS_FLAG_READ ) != 0 )

  {

    bfio_access_flags = LIBBFIO_ACCESS_FLAG_READ;

  }

  file_io_handle_is_open = libbfio_handle_is_open(

                            file_io_handle,

                            error );

  if( file_io_handle_is_open == -1 )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_IO,

     LIBCERROR_IO_ERROR_OPEN_FAILED,

     "%s: unable to open file.",

     function );

    goto on_error;

  }

  else if( file_io_handle_is_open == 0 )

  {

    if( libbfio_handle_open(

         file_io_handle,

         bfio_access_flags,

         error ) != 1 )

    {

      libcerror_error_set(

       error,

       LIBCERROR_ERROR_DOMAIN_IO,

       LIBCERROR_IO_ERROR_OPEN_FAILED,

       "%s: unable to open file IO handle.",

       function );

      goto on_error;

    }

    file_io_handle_opened_in_library = 1;

  }

  if( libvslvm_internal_handle_open_read(

       internal_handle,

       file_io_handle,

       error ) != 1 )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_IO,

     LIBCERROR_IO_ERROR_READ_FAILED,

     "%s: unable to read from file IO handle.",

     function );

    goto on_error;

  }

  internal_handle->file_io_handle                   = file_io_handle;

  internal_handle->file_io_handle_opened_in_library = file_io_handle_opened_in_library;

  internal_handle->access_flags                     = access_flags;

  return( 1 );

on_error:

  if( ( file_io_handle_is_open == 0 )

   && ( file_io_handle_opened_in_library != 0 ) )

  {

    libbfio_handle_close(

     file_io_handle,

     error );

  }

  return( -1 );

}

/* Opens the physical volume files

 * This function assumes the physical volume files are in same order as defined by the metadata

 * Returns 1 if successful or -1 on error

 */

int libvslvm_handle_open_physical_volume_files(

     libvslvm_handle_t *handle,

     char * const filenames[],

     int number_of_filenames,

     libcerror_error_t **error )

{

        libbfio_pool_t *file_io_pool                = NULL;

  libvslvm_internal_handle_t *internal_handle = NULL;

  libvslvm_volume_group_t *volume_group       = NULL;

  static char *function                       = "libvslvm_handle_open_physical_volume_files";

  int number_of_physical_volumes              = 0;

  int physical_volume_index                   = 0;

  int result                                  = 0;

  if( handle == NULL )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_ARGUMENTS,

     LIBCERROR_ARGUMENT_ERROR_INVALID_VALUE,

     "%s: invalid handle.",

     function );

    return( -1 );

  }

  internal_handle = (libvslvm_internal_handle_t *) handle;

  if( internal_handle->physical_volume_file_io_pool != NULL )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_RUNTIME,

     LIBCERROR_RUNTIME_ERROR_VALUE_ALREADY_SET,

     "%s: invalid handle - physical volume file IO pool already exists.",

     function );

    return( -1 );

  }

  result = libvslvm_metadata_get_volume_group(

            internal_handle->metadata,

            &volume_group,

            error );

  if( result == -1 )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_RUNTIME,

     LIBCERROR_RUNTIME_ERROR_GET_FAILED,

     "%s: unable to retrieve number of metadata area descriptors from array.",

     function );

    return( -1 );

  }

  else if( result == 0 )

  {

    return( 1 );

  }

  if( libvslvm_volume_group_get_number_of_physical_volumes(

       volume_group,

       &number_of_physical_volumes,

       error ) != 1 )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_RUNTIME,

     LIBCERROR_RUNTIME_ERROR_GET_FAILED,

     "%s: unable to retrieve number of physical volumes.",

     function );

    goto on_error;

  }

  if( number_of_physical_volumes == 0 )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_RUNTIME,

     LIBCERROR_RUNTIME_ERROR_VALUE_MISSING,

     "%s: missing physical volumes.",

     function );

    goto on_error;

  }

  if( number_of_filenames != number_of_physical_volumes )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_RUNTIME,

     LIBCERROR_RUNTIME_ERROR_VALUE_MISSING,

     "%s: mismatch between number of filenames and physical volumes in metadata.",

     function );

    goto on_error;

  }

  if( libbfio_pool_initialize(

       &file_io_pool,

       number_of_physical_volumes,

       internal_handle->maximum_number_of_open_handles,

       error ) != 1 )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_RUNTIME,

     LIBCERROR_RUNTIME_ERROR_INITIALIZE_FAILED,

     "%s: unable to create file IO pool.",

     function );

    goto on_error;

  }

  for( physical_volume_index = 0;

       physical_volume_index < number_of_physical_volumes;

       physical_volume_index++ )

  {

    if( filenames[ physical_volume_index ] == NULL )

    {

      libcerror_error_set(

       error,

       LIBCERROR_ERROR_DOMAIN_RUNTIME,

       LIBCERROR_RUNTIME_ERROR_VALUE_MISSING,

       "%s: missing filename for physical volume: %d.",

       function,

       physical_volume_index );

      goto on_error;

    }

    if( libvslvm_internal_handle_open_physical_volume_file(

         internal_handle,

         file_io_pool,

         physical_volume_index,

         filenames[ physical_volume_index ],

         error ) != 1 )

    {

      libcerror_error_set(

       error,

       LIBCERROR_ERROR_DOMAIN_IO,

       LIBCERROR_IO_ERROR_OPEN_FAILED,

       "%s: unable to open physical volume file: %" PRIs_SYSTEM ".",

       function,

       filenames[ physical_volume_index ] );

      goto on_error;

    }

  }

  if( libvslvm_internal_handle_open_read_data_area_table(

       internal_handle,

       file_io_pool,

       error ) != 1 )

  {

                libcerror_error_set(

                 error,

                 LIBCERROR_ERROR_DOMAIN_RUNTIME,

                 LIBCERROR_RUNTIME_ERROR_SET_FAILED,

                 "%s: unable to read data area table.",

                 function );

                goto on_error;

  }

  internal_handle->physical_volume_file_io_pool                    = file_io_pool;

  internal_handle->physical_volume_file_io_pool_created_in_library = 1;

  return( 1 );

on_error:

  if( file_io_pool != NULL )

  {

    libbfio_pool_close_all(

     file_io_pool,

     NULL );

    libbfio_pool_free(

     &file_io_pool,

     NULL );

  }

  return( -1 );

}

#if defined( HAVE_WIDE_CHARACTER_TYPE )

/* Opens the physical volume files

 * This function assumes the physical volume files are in same order as defined by the metadata

 * Returns 1 if successful or -1 on error

 */

int libvslvm_handle_open_physical_volume_files_wide(

     libvslvm_handle_t *handle,

     wchar_t * const filenames[],

     int number_of_filenames,

     libcerror_error_t **error )

{

        libbfio_pool_t *file_io_pool                = NULL;

  libvslvm_internal_handle_t *internal_handle = NULL;

  libvslvm_volume_group_t *volume_group       = NULL;

  static char *function                       = "libvslvm_handle_open_physical_volume_files_wide";

  int number_of_physical_volumes              = 0;

  int physical_volume_index                   = 0;

  int result                                  = 0;

  if( handle == NULL )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_ARGUMENTS,

     LIBCERROR_ARGUMENT_ERROR_INVALID_VALUE,

     "%s: invalid handle.",

     function );

    return( -1 );

  }

  internal_handle = (libvslvm_internal_handle_t *) handle;

  if( internal_handle->physical_volume_file_io_pool != NULL )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_RUNTIME,

     LIBCERROR_RUNTIME_ERROR_VALUE_ALREADY_SET,

     "%s: invalid handle - physical volume file IO pool already exists.",

     function );

    return( -1 );

  }

  result = libvslvm_metadata_get_volume_group(

            internal_handle->metadata,

            &volume_group,

            error );

  if( result == -1 )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_RUNTIME,

     LIBCERROR_RUNTIME_ERROR_GET_FAILED,

     "%s: unable to retrieve number of metadata area descriptors from array.",

     function );

    return( -1 );

  }

  else if( result == 0 )

  {

    return( 1 );

  }

  if( libvslvm_volume_group_get_number_of_physical_volumes(

       volume_group,

       &number_of_physical_volumes,

       error ) != 1 )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_RUNTIME,

     LIBCERROR_RUNTIME_ERROR_GET_FAILED,

     "%s: unable to retrieve number of physical volumes.",

     function );

    goto on_error;

  }

  if( number_of_physical_volumes == 0 )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_RUNTIME,

     LIBCERROR_RUNTIME_ERROR_VALUE_MISSING,

     "%s: missing physical volumes.",

     function );

    goto on_error;

  }

  if( number_of_filenames != number_of_physical_volumes )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_RUNTIME,

     LIBCERROR_RUNTIME_ERROR_VALUE_MISSING,

     "%s: mismatch between number of filenames and physical volumes in metadata.",

     function );

    goto on_error;

  }

  if( libbfio_pool_initialize(

       &file_io_pool,

       number_of_physical_volumes,

       internal_handle->maximum_number_of_open_handles,

       error ) != 1 )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_RUNTIME,

     LIBCERROR_RUNTIME_ERROR_INITIALIZE_FAILED,

     "%s: unable to create file IO pool.",

     function );

    goto on_error;

  }

  for( physical_volume_index = 0;

       physical_volume_index < number_of_physical_volumes;

       physical_volume_index++ )

  {

    if( filenames[ physical_volume_index ] == NULL )

    {

      libcerror_error_set(

       error,

       LIBCERROR_ERROR_DOMAIN_RUNTIME,

       LIBCERROR_RUNTIME_ERROR_VALUE_MISSING,

       "%s: missing filename for physical volume: %d.",

       function,

       physical_volume_index );

      goto on_error;

    }

    if( libvslvm_internal_handle_open_physical_volume_file_wide(

         internal_handle,

         file_io_pool,

         physical_volume_index,

         filenames[ physical_volume_index ],

         error ) != 1 )

    {

      libcerror_error_set(

       error,