/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  |  |  |