Coverage Report

Created: 2025-06-13 07:22

/src/libfwsi/libfwsi/libfwsi_extension_block_0xbeef0005_values.c
Line
Count
Source (jump to first uncovered line)
1
/*
2
 * Extension block 0xbeef0005 values functions
3
 *
4
 * Copyright (C) 2010-2024, Joachim Metz <joachim.metz@gmail.com>
5
 *
6
 * Refer to AUTHORS for acknowledgements.
7
 *
8
 * This program is free software: you can redistribute it and/or modify
9
 * it under the terms of the GNU Lesser General Public License as published by
10
 * the Free Software Foundation, either version 3 of the License, or
11
 * (at your option) any later version.
12
 *
13
 * This program is distributed in the hope that it will be useful,
14
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16
 * GNU General Public License for more details.
17
 *
18
 * You should have received a copy of the GNU Lesser General Public License
19
 * along with this program.  If not, see <https://www.gnu.org/licenses/>.
20
 */
21
22
#include <common.h>
23
#include <byte_stream.h>
24
#include <memory.h>
25
#include <types.h>
26
27
#include "libfwsi_definitions.h"
28
#include "libfwsi_extension_block_0xbeef0005_values.h"
29
#include "libfwsi_libcerror.h"
30
#include "libfwsi_libcnotify.h"
31
32
/* Creates extension block 0xbeef0005 values
33
 * Make sure the value extension_block_0xbeef0005_values is referencing, is set to NULL
34
 * Returns 1 if successful or -1 on error
35
 */
36
int libfwsi_extension_block_0xbeef0005_values_initialize(
37
     libfwsi_extension_block_0xbeef0005_values_t **extension_block_0xbeef0005_values,
38
     libcerror_error_t **error )
39
0
{
40
0
  static char *function = "libfwsi_extension_block_0xbeef0005_values_initialize";
41
42
0
  if( extension_block_0xbeef0005_values == NULL )
43
0
  {
44
0
    libcerror_error_set(
45
0
     error,
46
0
     LIBCERROR_ERROR_DOMAIN_ARGUMENTS,
47
0
     LIBCERROR_ARGUMENT_ERROR_INVALID_VALUE,
48
0
     "%s: invalid extension block 0xbeef0005 values.",
49
0
     function );
50
51
0
    return( -1 );
52
0
  }
53
0
  if( *extension_block_0xbeef0005_values != NULL )
54
0
  {
55
0
    libcerror_error_set(
56
0
     error,
57
0
     LIBCERROR_ERROR_DOMAIN_RUNTIME,
58
0
     LIBCERROR_RUNTIME_ERROR_VALUE_ALREADY_SET,
59
0
     "%s: invalid extension block 0xbeef0005 values value already set.",
60
0
     function );
61
62
0
    return( -1 );
63
0
  }
64
0
  *extension_block_0xbeef0005_values = memory_allocate_structure(
65
0
                                        libfwsi_extension_block_0xbeef0005_values_t );
66
67
0
  if( *extension_block_0xbeef0005_values == NULL )
68
0
  {
69
0
    libcerror_error_set(
70
0
     error,
71
0
     LIBCERROR_ERROR_DOMAIN_MEMORY,
72
0
     LIBCERROR_MEMORY_ERROR_INSUFFICIENT,
73
0
     "%s: unable to create extension block 0xbeef0005 values.",
74
0
     function );
75
76
0
    goto on_error;
77
0
  }
78
0
  if( memory_set(
79
0
       *extension_block_0xbeef0005_values,
80
0
       0,
81
0
       sizeof( libfwsi_extension_block_0xbeef0005_values_t ) ) == NULL )
82
0
  {
83
0
    libcerror_error_set(
84
0
     error,
85
0
     LIBCERROR_ERROR_DOMAIN_MEMORY,
86
0
     LIBCERROR_MEMORY_ERROR_SET_FAILED,
87
0
     "%s: unable to clear extension block 0xbeef0005 values.",
88
0
     function );
89
90
0
    goto on_error;
91
0
  }
92
0
  return( 1 );
93
94
0
on_error:
95
0
  if( *extension_block_0xbeef0005_values != NULL )
96
0
  {
97
0
    memory_free(
98
0
     *extension_block_0xbeef0005_values );
99
100
0
    *extension_block_0xbeef0005_values = NULL;
101
0
  }
102
0
  return( -1 );
103
0
}
104
105
/* Frees extension block 0xbeef0005 values
106
 * Returns 1 if successful or -1 on error
107
 */
108
int libfwsi_extension_block_0xbeef0005_values_free(
109
     libfwsi_extension_block_0xbeef0005_values_t **extension_block_0xbeef0005_values,
110
     libcerror_error_t **error )
111
0
{
112
0
  static char *function = "libfwsi_extension_block_0xbeef0005_values_free";
113
114
0
  if( extension_block_0xbeef0005_values == NULL )
115
0
  {
116
0
    libcerror_error_set(
117
0
     error,
118
0
     LIBCERROR_ERROR_DOMAIN_ARGUMENTS,
119
0
     LIBCERROR_ARGUMENT_ERROR_INVALID_VALUE,
120
0
     "%s: invalid extension block 0xbeef0005 values.",
121
0
     function );
122
123
0
    return( -1 );
124
0
  }
125
0
  if( *extension_block_0xbeef0005_values != NULL )
126
0
  {
127
0
    memory_free(
128
0
     *extension_block_0xbeef0005_values );
129
130
0
    *extension_block_0xbeef0005_values = NULL;
131
0
  }
132
0
  return( 1 );
133
0
}
134
135
/* Reads the extension block 0xbeef0005 values
136
 * Returns 1 if successful, 0 if not supported or -1 on error
137
 */
138
int libfwsi_extension_block_0xbeef0005_values_read_data(
139
     libfwsi_extension_block_0xbeef0005_values_t *extension_block_0xbeef0005_values,
140
     const uint8_t *data,
141
     size_t data_size,
142
     libcerror_error_t **error )
143
0
{
144
0
  static char *function = "libfwsi_extension_block_0xbeef0005_values_read_data";
145
0
  uint32_t signature    = 0;
146
147
0
  if( extension_block_0xbeef0005_values == NULL )
148
0
  {
149
0
    libcerror_error_set(
150
0
     error,
151
0
     LIBCERROR_ERROR_DOMAIN_ARGUMENTS,
152
0
     LIBCERROR_ARGUMENT_ERROR_INVALID_VALUE,
153
0
     "%s: invalid extension block 0xbeef0005 values.",
154
0
     function );
155
156
0
    return( -1 );
157
0
  }
158
0
  if( data == NULL )
159
0
  {
160
0
    libcerror_error_set(
161
0
     error,
162
0
     LIBCERROR_ERROR_DOMAIN_ARGUMENTS,
163
0
     LIBCERROR_ARGUMENT_ERROR_INVALID_VALUE,
164
0
     "%s: invalid data.",
165
0
     function );
166
167
0
    return( -1 );
168
0
  }
169
0
  if( data_size > (size_t) SSIZE_MAX )
170
0
  {
171
0
    libcerror_error_set(
172
0
     error,
173
0
     LIBCERROR_ERROR_DOMAIN_ARGUMENTS,
174
0
     LIBCERROR_ARGUMENT_ERROR_VALUE_EXCEEDS_MAXIMUM,
175
0
     "%s: data size exceeds maximum.",
176
0
     function );
177
178
0
    return( -1 );
179
0
  }
180
  /* Do not try to parse unsupported data sizes
181
   */
182
0
  if( data_size < 26 )
183
0
  {
184
0
    return( 0 );
185
0
  }
186
  /* Do not try to parse unsupported extension block signatures
187
   */
188
0
  byte_stream_copy_to_uint32_little_endian(
189
0
   &( data[ 4 ] ),
190
0
   signature );
191
192
0
  if( signature != 0xbeef0005 )
193
0
  {
194
0
    return( 0 );
195
0
  }
196
#if defined( HAVE_DEBUG_OUTPUT )
197
  if( libcnotify_verbose != 0 )
198
  {
199
    libcnotify_printf(
200
     "%s: unknown1:\n",
201
     function );
202
    libcnotify_print_data(
203
     &( data[ 8 ] ),
204
     16,
205
     0 );
206
  }
207
#endif
208
  /* TODO parse embedded shell item list */
209
210
0
  return( 1 );
211
0
}
212