/*

 * Volume information functions

 *

 * Copyright (C) 2014-2026, 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 <byte_stream.h>

#include <memory.h>

#include <types.h>

#include "libagdb_debug.h"

#include "libagdb_definitions.h"

#include "libagdb_file_information.h"

#include "libagdb_hash.h"

#include "libagdb_io_handle.h"

#include "libagdb_libbfio.h"

#include "libagdb_libcdata.h"

#include "libagdb_libcerror.h"

#include "libagdb_libcnotify.h"

#include "libagdb_libfcache.h"

#include "libagdb_libfdatetime.h"

#include "libagdb_libfdata.h"

#include "libagdb_libuna.h"

#include "libagdb_volume_information.h"

#include "agdb_volume_information.h"

/* Creates volume information

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

 * Returns 1 if successful or -1 on error

 */

int libagdb_volume_information_initialize(

     libagdb_volume_information_t **volume_information,

     libcerror_error_t **error )

{

  libagdb_internal_volume_information_t *internal_volume_information = NULL;

  static char *function                                              = "libagdb_volume_information_initialize";

  if( volume_information == NULL )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_ARGUMENTS,

     LIBCERROR_ARGUMENT_ERROR_INVALID_VALUE,

     "%s: invalid volume information.",

     function );

    return( -1 );

  }

  if( *volume_information != NULL )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_RUNTIME,

     LIBCERROR_RUNTIME_ERROR_VALUE_ALREADY_SET,

     "%s: invalid volume information value already set.",

     function );

    return( -1 );

  }

  internal_volume_information = memory_allocate_structure(

                                 libagdb_internal_volume_information_t );

  if( internal_volume_information == NULL )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_MEMORY,

     LIBCERROR_MEMORY_ERROR_INSUFFICIENT,

     "%s: unable to create volume information.",

     function );

    goto on_error;

  }

  if( memory_set(

       internal_volume_information,

       0,

       sizeof( libagdb_internal_volume_information_t ) ) == NULL )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_MEMORY,

     LIBCERROR_MEMORY_ERROR_SET_FAILED,

     "%s: unable to clear volume.",

     function );

    goto on_error;

  }

  if( libcdata_array_initialize(

       &( internal_volume_information->files_array ),

       0,

       error ) != 1 )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_RUNTIME,

     LIBCERROR_RUNTIME_ERROR_INITIALIZE_FAILED,

     "%s: unable to create files array.",

     function );

    goto on_error;

  }

  *volume_information = (libagdb_volume_information_t *) internal_volume_information;

  return( 1 );

on_error:

  if( internal_volume_information != NULL )

  {

    memory_free(

     internal_volume_information );

  }

  return( -1 );

}

/* Frees volume information

 * Returns 1 if successful or -1 on error

 */

int libagdb_volume_information_free(

     libagdb_volume_information_t **volume_information,

     libcerror_error_t **error )

{

  static char *function = "libagdb_volume_information_free";

  if( volume_information == NULL )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_ARGUMENTS,

     LIBCERROR_ARGUMENT_ERROR_INVALID_VALUE,

     "%s: invalid volume information.",

     function );

    return( -1 );

  }

  if( *volume_information != NULL )

  {

    *volume_information = NULL;

  }

  return( 1 );

}

/* Frees volume information

 * Returns 1 if successful or -1 on error

 */

int libagdb_internal_volume_information_free(

     libagdb_internal_volume_information_t **internal_volume_information,

     libcerror_error_t **error )

{

  static char *function = "libagdb_internal_volume_information_free";

  int result            = 1;

  if( internal_volume_information == NULL )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_ARGUMENTS,

     LIBCERROR_ARGUMENT_ERROR_INVALID_VALUE,

     "%s: invalid volume information.",

     function );

    return( -1 );

  }

  if( *internal_volume_information != NULL )

  {

    if( ( *internal_volume_information )->device_path != NULL )

    {

      memory_free(

       ( *internal_volume_information )->device_path );

    }

    if( libcdata_array_free(

         &( ( *internal_volume_information )->files_array ),

         (int (*)(intptr_t **, libcerror_error_t **)) &libagdb_internal_file_information_free,

         error ) != 1 )

    {

      libcerror_error_set(

       error,

       LIBCERROR_ERROR_DOMAIN_RUNTIME,

       LIBCERROR_RUNTIME_ERROR_FINALIZE_FAILED,

       "%s: unable to free files array.",

       function );

      result = -1;

    }

    memory_free(

     *internal_volume_information );

    *internal_volume_information = NULL;

  }

  return( result );

}

/* Reads the volume information

 * Returns the number of bytes read if successful or -1 on error

 */

int libagdb_internal_volume_information_read_data(

     libagdb_internal_volume_information_t *internal_volume_information,

     libagdb_io_handle_t *io_handle,

     const uint8_t *data,

     size_t data_size,

     libcerror_error_t **error )

{

  static char *function  = "libagdb_internal_volume_information_read_data";

  uint8_t number_of_bits = 0;

#if defined( HAVE_DEBUG_OUTPUT )

  uint8_t *filetime_data = NULL;

  uint64_t value_64bit   = 0;

  uint32_t value_32bit   = 0;

  uint16_t value_16bit   = 0;

#endif

  if( internal_volume_information == NULL )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_ARGUMENTS,

     LIBCERROR_ARGUMENT_ERROR_INVALID_VALUE,

     "%s: invalid volume information.",

     function );

    return( -1 );

  }

  if( io_handle == NULL )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_ARGUMENTS,

     LIBCERROR_ARGUMENT_ERROR_INVALID_VALUE,

     "%s: invalid IO handle.",

     function );

    return( -1 );

  }

  if( data == NULL )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_ARGUMENTS,

     LIBCERROR_ARGUMENT_ERROR_INVALID_VALUE,

     "%s: invalid data.",

     function );

    return( -1 );

  }

  if( ( data_size < io_handle->volume_information_entry_size )

   || ( data_size > (size_t) SSIZE_MAX ) )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_RUNTIME,

     LIBCERROR_RUNTIME_ERROR_VALUE_OUT_OF_BOUNDS,

     "%s: invalid data size value out bounds.",

     function );

    return( -1 );

  }

  switch( io_handle->file_header_signature )

  {

    case 0x00000003UL:

      if( io_handle->volume_information_entry_size == 72 )

      {

        number_of_bits = 32;

      }

      else if( io_handle->volume_information_entry_size == 96 )

      {

        number_of_bits = 64;

      }

      break;

    case 0x0000000eUL:

    case 0x0000000fUL:

      if( io_handle->volume_information_entry_size == 56 )

      {

        number_of_bits = 32;

      }

      else if( io_handle->volume_information_entry_size == 72 )

      {

        number_of_bits = 64;

      }

      break;

    default:

      break;

  }

  if( number_of_bits == 0 )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_RUNTIME,

     LIBCERROR_RUNTIME_ERROR_UNSUPPORTED_VALUE,

     "%s: unsupported volume information entry size: %" PRIu32 ".",

     function,

     io_handle->volume_information_entry_size );

    return( -1 );

  }

#if defined( HAVE_DEBUG_OUTPUT )

  if( libcnotify_verbose != 0 )

  {

    libcnotify_printf(

     "%s: volume information data:\n",

     function );

    libcnotify_print_data(

     data,

     (size_t) io_handle->volume_information_entry_size,

     0 );

  }

#endif

  if( number_of_bits == 32 )

  {

    byte_stream_copy_to_uint32_little_endian(

     ( (agdb_volume_information_56_32bit_t *) data )->number_of_files,

     internal_volume_information->number_of_files );

    byte_stream_copy_to_uint64_little_endian(

     ( (agdb_volume_information_56_32bit_t *) data )->creation_time,

     internal_volume_information->creation_time );

    byte_stream_copy_to_uint32_little_endian(

     ( (agdb_volume_information_56_32bit_t *) data )->serial_number,

     internal_volume_information->serial_number );

    byte_stream_copy_to_uint16_little_endian(

     ( (agdb_volume_information_56_32bit_t *) data )->device_path_number_of_characters,

     internal_volume_information->device_path_size );

  }

  else if( number_of_bits == 64 )

  {

    byte_stream_copy_to_uint32_little_endian(

     ( (agdb_volume_information_72_64bit_t *) data )->number_of_files,

     internal_volume_information->number_of_files );

    byte_stream_copy_to_uint64_little_endian(

     ( (agdb_volume_information_72_64bit_t *) data )->creation_time,

     internal_volume_information->creation_time );

    byte_stream_copy_to_uint32_little_endian(

     ( (agdb_volume_information_72_64bit_t *) data )->serial_number,

     internal_volume_information->serial_number );

    byte_stream_copy_to_uint16_little_endian(

     ( (agdb_volume_information_72_64bit_t *) data )->device_path_number_of_characters,

     internal_volume_information->device_path_size );

  }

#if defined( HAVE_DEBUG_OUTPUT )

  if( libcnotify_verbose != 0 )

  {

    if( number_of_bits == 32 )

    {

      byte_stream_copy_to_uint32_little_endian(

       ( (agdb_volume_information_56_32bit_t *) data )->unknown1,

       value_64bit );

    }

    else if( number_of_bits == 64 )

    {

      byte_stream_copy_to_uint64_little_endian(

       ( (agdb_volume_information_72_64bit_t *) data )->unknown1,

       value_64bit );

    }

    libcnotify_printf(

     "%s: unknown1\t\t\t\t: 0x%08" PRIx64 "\n",

     function,

     value_64bit );

    if( number_of_bits == 32 )

    {

      byte_stream_copy_to_uint32_little_endian(

       ( (agdb_volume_information_56_32bit_t *) data )->unknown2,

       value_64bit );

    }

    else if( number_of_bits == 64 )

    {

      byte_stream_copy_to_uint64_little_endian(

       ( (agdb_volume_information_72_64bit_t *) data )->unknown2,

       value_64bit );

    }

    libcnotify_printf(

     "%s: unknown2\t\t\t\t: 0x%08" PRIx64 "\n",

     function,

     value_64bit );

    libcnotify_printf(

     "%s: number of files\t\t\t: %" PRIu32 "\n",

     function,

     internal_volume_information->number_of_files );

    if( number_of_bits == 32 )

    {

      byte_stream_copy_to_uint32_little_endian(

       ( (agdb_volume_information_56_32bit_t *) data )->unknown3,

       value_32bit );

    }

    else if( number_of_bits == 64 )

    {

      byte_stream_copy_to_uint32_little_endian(

       ( (agdb_volume_information_72_64bit_t *) data )->unknown3,

       value_32bit );

    }

    libcnotify_printf(

     "%s: unknown3\t\t\t\t: 0x%08" PRIx32 "\n",

     function,

     value_32bit );

    if( number_of_bits == 32 )

    {

      byte_stream_copy_to_uint64_little_endian(

       ( (agdb_volume_information_56_32bit_t *) data )->unknown4,

       value_64bit );

    }

    else if( number_of_bits == 64 )

    {

      byte_stream_copy_to_uint64_little_endian(

       ( (agdb_volume_information_72_64bit_t *) data )->unknown4,

       value_64bit );

    }

    libcnotify_printf(

     "%s: unknown4\t\t\t\t: 0x%08" PRIx64 "\n",

     function,

     value_64bit );

    if( number_of_bits == 32 )

    {

      filetime_data = ( (agdb_volume_information_56_32bit_t *) data )->creation_time;

    }

    else if( number_of_bits == 64 )

    {

      filetime_data = ( (agdb_volume_information_72_64bit_t *) data )->creation_time;

    }

    if( libagdb_debug_print_filetime_value(

         function,

         "creation time\t\t\t",

         filetime_data,

         8,

         LIBFDATETIME_ENDIAN_LITTLE,

         LIBFDATETIME_STRING_FORMAT_TYPE_CTIME | LIBFDATETIME_STRING_FORMAT_FLAG_DATE_TIME_NANO_SECONDS,

         error ) != 1 )

    {

      libcerror_error_set(

       error,

       LIBCERROR_ERROR_DOMAIN_RUNTIME,

       LIBCERROR_RUNTIME_ERROR_PRINT_FAILED,

       "%s: unable to print filetime value.",

       function );

      return( -1 );

    }

    libcnotify_printf(

     "%s: serial number\t\t\t: 0x%08" PRIx32 "\n",

     function,

     internal_volume_information->serial_number );

    if( number_of_bits == 32 )

    {

      byte_stream_copy_to_uint32_little_endian(

       ( (agdb_volume_information_56_32bit_t *) data )->unknown5,

       value_32bit );

    }

    else if( number_of_bits == 64 )

    {

      byte_stream_copy_to_uint32_little_endian(

       ( (agdb_volume_information_72_64bit_t *) data )->unknown5,

       value_32bit );

    }

    libcnotify_printf(

     "%s: unknown5\t\t\t\t: 0x%08" PRIx32 "\n",

     function,

     value_32bit );

    if( number_of_bits == 32 )

    {

      byte_stream_copy_to_uint32_little_endian(

       ( (agdb_volume_information_56_32bit_t *) data )->unknown6,

       value_64bit );

    }

    else if( number_of_bits == 64 )

    {

      byte_stream_copy_to_uint64_little_endian(

       ( (agdb_volume_information_72_64bit_t *) data )->unknown6,

       value_64bit );

    }

    libcnotify_printf(

     "%s: unknown6\t\t\t\t: 0x%08" PRIx64 "\n",

     function,

     value_64bit );

    libcnotify_printf(

     "%s: device path number of characters\t: %" PRIu16 "\n",

     function,

     internal_volume_information->device_path_size );

    if( number_of_bits == 32 )

    {

      byte_stream_copy_to_uint16_little_endian(

       ( (agdb_volume_information_56_32bit_t *) data )->unknown7,

       value_16bit );

    }

    else if( number_of_bits == 64 )

    {

      byte_stream_copy_to_uint16_little_endian(

       ( (agdb_volume_information_72_64bit_t *) data )->unknown7,

       value_16bit );

    }

    libcnotify_printf(

     "%s: unknown7\t\t\t\t: 0x%04" PRIx16 "\n",

     function,

     value_16bit );

    if( number_of_bits == 64 )

    {

      byte_stream_copy_to_uint32_little_endian(

       ( (agdb_volume_information_72_64bit_t *) data )->unknown8,

       value_32bit );

      libcnotify_printf(

       "%s: unknown8\t\t\t\t: 0x%08" PRIx32 "\n",

       function,

       value_32bit );

    }

    if( number_of_bits == 32 )

    {

      byte_stream_copy_to_uint64_little_endian(

       ( (agdb_volume_information_56_32bit_t *) data )->unknown9,

       value_64bit );

    }

    else if( number_of_bits == 64 )

    {

      byte_stream_copy_to_uint64_little_endian(

       ( (agdb_volume_information_72_64bit_t *) data )->unknown9,

       value_64bit );

    }

    libcnotify_printf(

     "%s: unknown9\t\t\t\t: 0x%08" PRIx64 "\n",

     function,

     value_64bit );

    if( ( number_of_bits == 32 )

     && ( io_handle->volume_information_entry_size == 72 ) )

    {

      byte_stream_copy_to_uint32_little_endian(

       ( (agdb_volume_information_72_32bit_t *) data )->unknown10,

       value_32bit );

      libcnotify_printf(

       "%s: unknown10\t\t\t: 0x%08" PRIx32 "\n",

       function,

       value_32bit );

      byte_stream_copy_to_uint32_little_endian(

       ( (agdb_volume_information_72_32bit_t *) data )->unknown11,

       value_32bit );

      libcnotify_printf(

       "%s: unknown11\t\t\t: 0x%08" PRIx32 "\n",

       function,

       value_32bit );

      byte_stream_copy_to_uint64_little_endian(

       ( (agdb_volume_information_72_32bit_t *) data )->unknown12,

       value_64bit );

      libcnotify_printf(

       "%s: unknown12\t\t\t: 0x%08" PRIx64 "\n",

       function,

       value_64bit );

    }

    else if( ( number_of_bits == 64 )

          && ( io_handle->volume_information_entry_size == 96 ) )

    {

      byte_stream_copy_to_uint64_little_endian(

       ( (agdb_volume_information_96_64bit_t *) data )->unknown10,

       value_64bit );

      libcnotify_printf(

       "%s: unknown10\t\t\t: 0x%08" PRIx64 "\n",

       function,

       value_64bit );

      byte_stream_copy_to_uint64_little_endian(

       ( (agdb_volume_information_96_64bit_t *) data )->unknown11,

       value_64bit );

      libcnotify_printf(

       "%s: unknown11\t\t\t: 0x%08" PRIx64 "\n",

       function,

       value_64bit );

      byte_stream_copy_to_uint64_little_endian(

       ( (agdb_volume_information_96_64bit_t *) data )->unknown12,

       value_64bit );

      libcnotify_printf(

       "%s: unknown12\t\t\t: 0x%08" PRIx64 "\n",

       function,

       value_64bit );

    }

    libcnotify_printf(

     "\n" );

  }

#endif /* defined( HAVE_DEBUG_OUTPUT ) */

  if( internal_volume_information->device_path_size != 0 )

  {

    internal_volume_information->device_path_size += 1;

    internal_volume_information->device_path_size *= 2;

  }

  return( 1 );

}

/* Reads the volume information device path data

 * Note that this function is mainly used for the tests

 * Returns the number of bytes read if successful or -1 on error

 */

int libagdb_internal_volume_information_read_device_path_data(

     libagdb_internal_volume_information_t *internal_volume_information,

     const uint8_t *data,

     size_t data_size,

     libcerror_error_t **error )

{

  static char *function  = "libagdb_internal_volume_information_read_device_path_data";

  if( internal_volume_information == NULL )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_ARGUMENTS,

     LIBCERROR_ARGUMENT_ERROR_INVALID_VALUE,

     "%s: invalid volume information.",

     function );

    return( -1 );

  }

  if( internal_volume_information->device_path != NULL )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_RUNTIME,

     LIBCERROR_RUNTIME_ERROR_VALUE_ALREADY_SET,

     "%s: invalid volume information - device path value already set.",

     function );

    return( -1 );

  }

  if( data == NULL )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_ARGUMENTS,

     LIBCERROR_ARGUMENT_ERROR_INVALID_VALUE,

     "%s: invalid data.",

     function );

    return( -1 );

  }

  if( ( data_size < internal_volume_information->device_path_size )

   || ( data_size > (size_t) SSIZE_MAX ) )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_RUNTIME,

     LIBCERROR_RUNTIME_ERROR_VALUE_OUT_OF_BOUNDS,

     "%s: invalid data size value out bounds.",

     function );

    return( -1 );

  }

#if defined( HAVE_DEBUG_OUTPUT )

  if( libcnotify_verbose != 0 )

  {

    libcnotify_printf(

     "%s: volume information device path data:\n",

     function );

    libcnotify_print_data(

     data,

     (size_t) internal_volume_information->device_path_size,

     0 );

  }

#endif

  if( internal_volume_information->device_path_size > 0 )

  {

    if( internal_volume_information->device_path_size > (size_t) MEMORY_MAXIMUM_ALLOCATION_SIZE )

    {

      libcerror_error_set(

       error,

       LIBCERROR_ERROR_DOMAIN_RUNTIME,

       LIBCERROR_RUNTIME_ERROR_VALUE_EXCEEDS_MAXIMUM,

       "%s: invalid volume information - device path size value exceeds maximum allocation size.",

       function );

      goto on_error;

    }

    internal_volume_information->device_path = (uint8_t *) memory_allocate(

                                                            sizeof( uint8_t ) * internal_volume_information->device_path_size );

    if( internal_volume_information->device_path == NULL )

    {

      libcerror_error_set(

       error,

       LIBCERROR_ERROR_DOMAIN_MEMORY,

       LIBCERROR_MEMORY_ERROR_INSUFFICIENT,

       "%s: unable to create device path.",

       function );

      goto on_error;

    }

    if( memory_copy(

         internal_volume_information->device_path,

         data,

         sizeof( uint8_t ) * internal_volume_information->device_path_size ) == NULL )

    {

      libcerror_error_set(

       error,

       LIBCERROR_ERROR_DOMAIN_MEMORY,

       LIBCERROR_MEMORY_ERROR_COPY_FAILED,

       "%s: unable to copy device path.",

       function );

      goto on_error;

    }

  }

  return( 1 );

on_error:

  if( internal_volume_information->device_path != NULL )

  {

    memory_free(

     internal_volume_information->device_path );

    internal_volume_information->device_path = NULL;

  }

  internal_volume_information->device_path_size = 0;

  return( -1 );

}

/* Reads the volume information

 * Returns the number of bytes read if successful or -1 on error

 */

ssize64_t libagdb_internal_volume_information_read_file_io_handle(

           libagdb_internal_volume_information_t *internal_volume_information,

           libagdb_io_handle_t *io_handle,

           libfdata_stream_t *data_stream,

           libbfio_handle_t *file_io_handle,

           off64_t file_offset,

           uint32_t volume_index,

           libcerror_error_t **error )

{

  uint8_t alignment_padding_data[ 8 ];

  libagdb_file_information_t *file_information = NULL;

  uint8_t *volume_information_data             = NULL;

  static char *function                        = "libagdb_internal_volume_information_read_file_io_handle";

  ssize64_t total_read_count                   = 0;

  size_t alignment_padding_size                = 0;

  size_t alignment_size                        = 0;

  ssize_t read_count                           = 0;

  uint32_t calculated_hash_value               = 0;

  uint32_t file_index                          = 0;

  int entry_index                              = 0;

  if( internal_volume_information == NULL )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_ARGUMENTS,

     LIBCERROR_ARGUMENT_ERROR_INVALID_VALUE,

     "%s: invalid volume information.",

     function );

    return( -1 );

  }

  if( internal_volume_information->device_path != NULL )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_RUNTIME,

     LIBCERROR_RUNTIME_ERROR_VALUE_ALREADY_SET,

     "%s: invalid volume information - device path value already set.",

     function );

    return( -1 );

  }

  if( io_handle == NULL )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_ARGUMENTS,

     LIBCERROR_ARGUMENT_ERROR_INVALID_VALUE,

     "%s: invalid IO handle.",

     function );

    return( -1 );

  }

  if( ( io_handle->volume_information_entry_size == 0 )

   || ( io_handle->volume_information_entry_size > (uint32_t) MEMORY_MAXIMUM_ALLOCATION_SIZE ) )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_ARGUMENTS,

     LIBCERROR_ARGUMENT_ERROR_VALUE_OUT_OF_BOUNDS,

     "%s: invalid IO handle - volume information entry size value out of bounds.",

     function );

    return( -1 );

  }

#if defined( HAVE_DEBUG_OUTPUT )

  if( libcnotify_verbose != 0 )

  {

    libcnotify_printf(

     "%s: reading volume: %" PRIu32 " information at offset: %" PRIi64 " (0x%08" PRIx64 ")\n",

     function,

     volume_index,

     file_offset,

     file_offset );

  }

#endif

  volume_information_data = (uint8_t *) memory_allocate(

                                         sizeof( uint8_t ) * (size_t) io_handle->volume_information_entry_size );

  if( volume_information_data == NULL )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_MEMORY,

     LIBCERROR_MEMORY_ERROR_INSUFFICIENT,

     "%s: unable to create volume: %" PRIu32 " information data.",

     function,

     volume_index );

    goto on_error;

  }

  read_count = libfdata_stream_read_buffer_at_offset(

                data_stream,

                (intptr_t *) file_io_handle,

                volume_information_data,

                (size_t) io_handle->volume_information_entry_size,

                file_offset,

                0,

                error );

  if( read_count != (ssize_t) io_handle->volume_information_entry_size )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_IO,

     LIBCERROR_IO_ERROR_READ_FAILED,

     "%s: unable to read volume: %" PRIu32 " information data at offset: %" PRIi64 " (0x%08" PRIx64 ").",

     function,

     volume_index,

     file_offset,

     file_offset );

    goto on_error;

  }

  total_read_count += read_count;

  file_offset      += read_count;

  if( libagdb_internal_volume_information_read_data(

       internal_volume_information,

       io_handle,

       volume_information_data,

       (size_t) io_handle->volume_information_entry_size,

       error ) != 1 )

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_IO,

     LIBCERROR_IO_ERROR_READ_FAILED,

     "%s: unable to read volume: %" PRIu32 " information.",

     function,

     volume_index );

    goto on_error;

  }

  memory_free(

   volume_information_data );

  volume_information_data = NULL;

  if( io_handle->volume_information_entry_size == 56 )

  {

    alignment_size = 4;

  }

  else if( ( io_handle->volume_information_entry_size == 72 )

        || ( io_handle->volume_information_entry_size == 96 ) )

  {

    alignment_size = 8;

  }

  else

  {

    libcerror_error_set(

     error,

     LIBCERROR_ERROR_DOMAIN_RUNTIME,

     LIBCERROR_RUNTIME_ERROR_UNSUPPORTED_VALUE,

     "%s: unsupported volume information entry size: %" PRIu32 ".",

     function,

     io_handle->volume_information_entry_size );

    goto on_error;

  }

  if( internal_volume_information->device_path_size > 0 )

  {

    if( internal_volume_information->device_path_size > (size_t) MEMORY_MAXIMUM_ALLOCATION_SIZE )

    {

      libcerror_error_set(

       error,

       LIBCERROR_ERROR_DOMAIN_RUNTIME,

       LIBCERROR_RUNTIME_ERROR_VALUE_EXCEEDS_MAXIMUM,

       "%s: invalid volume information - device path size value exceeds maximum allocation size.",

       function );

      goto on_error;

    }

    internal_volume_information->device_path = (uint8_t *) memory_allocate(

                                                            sizeof( uint8_t ) * internal_volume_information->device_path_size );

    if( internal_volume_information->device_path == NULL )

    {

      libcerror_error_set(

       error,

       LIBCERROR_ERROR_DOMAIN_MEMORY,

       LIBCERROR_MEMORY_ERROR_INSUFFICIENT,

       "%s: unable to create device path.",

       function );

      goto on_error;

    }

    read_count = libfdata_stream_read_buffer(

                  data_stream,

                  (intptr_t *) file_io_handle,

                  internal_volume_information->device_path,

                  internal_volume_information->device_path_size,

                  0,

                  error );

    if( read_count != (ssize_t) internal_volume_information->device_path_size )

    {

      libcerror_error_set(

       error,

       LIBCERROR_ERROR_DOMAIN_IO,

       LIBCERROR_IO_ERROR_READ_FAILED,

       "%s: unable to read volume: %" PRIu32 " information data.",

       function,

       volume_index );

      goto on_error;

    }

    total_read_count += read_count;

    file_offset      += read_count;

#if defined( HAVE_DEBUG_OUTPUT )

    if( libcnotify_verbose != 0 )

    {

      libcnotify_printf(

       "%s: volume: %" PRIu32 " device path data:\n",

       function,

       volume_index );

      libcnotify_print_data(

       internal_volume_information->device_path,

       internal_volume_information->device_path_size,

       0 );

    }

#endif

    if( libagdb_hash_calculate(

         &calculated_hash_value,

         internal_volume_information->device_path,

         internal_volume_information->device_path_size - 2,

         error ) != 1 )

    {

      libcerror_error_set(

       error,

       LIBCERROR_ERROR_DOMAIN_RUNTIME,

       LIBCERROR_RUNTIME_ERROR_GET_FAILED,

       "%s: unable to retrieve volume: %" PRIu32 " device path hash value.",

       function,

       volume_index );

      goto on_error;

    }

#if defined( HAVE_DEBUG_OUTPUT )

    if( libcnotify_verbose != 0 )

    {

      if( libagdb_debug_print_utf16_string_value(

           function,

           "volume device path\t\t\t",

           internal_volume_information->device_path,

           internal_volume_information->device_path_size,

           LIBUNA_ENDIAN_LITTLE,

           error ) != 1 )

      {

        libcerror_error_set(

         error,

         LIBCERROR_ERROR_DOMAIN_RUNTIME,

         LIBCERROR_RUNTIME_ERROR_PRINT_FAILED,

         "%s: unable to print UTF-16 string value.",

         function );