libfwevt-python 20240419__tar.gz → 20240427__tar.gz

libfwevt-20240427/ChangeLog

@@ -0,0 +1,20 @@
+TODO
+* add pyfwevt_xml_document, pyfwevt_xml_tag and pyfwevt_xml_value
+
+* remove deprecated API functions
+
+* Replace libfvalue by native functions
+** Check use of libfwevt_xml_tag_get_value
+
+* Remove the need to create a copy of the template data at worst only have a copy of the BinXML
+** remove libfwevt_template_get_data
+
+* Rename _read() functions to _read_data()
+** libfwevt_manifest_read
+** libfwevt_template_read
+** libfwevt_xml_document_read
+
+20140928
+* see `git log' for more recent change log
+* Created stand-alone version of version used in libevt
+

{libfwevt-20240419 → libfwevt-20240427}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: libfwevt-python
-Version: 20240419
+Version: 20240427
 Summary: Python bindings module for libfwevt
 Author: Joachim Metz
 Author-email: joachim.metz@gmail.com

{libfwevt-20240419 → libfwevt-20240427}/common/config.h

@@ -368,7 +368,7 @@
 #define PACKAGE_NAME "libfwevt"
 
 /* Define to the full name and version of this package. */
-#define PACKAGE_STRING "libfwevt 20240419"
+#define PACKAGE_STRING "libfwevt 20240427"
 
 /* Define to the one symbol short name of this package. */
 #define PACKAGE_TARNAME "libfwevt"
@@ -377,7 +377,7 @@
 #define PACKAGE_URL ""
 
 /* Define to the version of this package. */
-#define PACKAGE_VERSION "20240419"
+#define PACKAGE_VERSION "20240427"
 
 /* The size of `int', as computed by sizeof. */
 #define SIZEOF_INT 4
@@ -403,7 +403,7 @@
 /* #undef STRERROR_R_CHAR_P */
 
 /* Version number of package */
-#define VERSION "20240419"
+#define VERSION "20240427"
 
 /* Number of bits in a file offset, on hosts where this is settable. */
 /* #undef _FILE_OFFSET_BITS */

{libfwevt-20240419 → libfwevt-20240427}/configure

@@ -1,6 +1,6 @@
 #! /bin/sh
 # Guess values for system-dependent variables and create Makefiles.
-# Generated by GNU Autoconf 2.71 for libfwevt 20240419.
+# Generated by GNU Autoconf 2.71 for libfwevt 20240427.
 #
 # Report bugs to <joachim.metz@gmail.com>.
 #
@@ -621,8 +621,8 @@ MAKEFLAGS=
 # Identity of this package.
 PACKAGE_NAME='libfwevt'
 PACKAGE_TARNAME='libfwevt'
-PACKAGE_VERSION='20240419'
-PACKAGE_STRING='libfwevt 20240419'
+PACKAGE_VERSION='20240427'
+PACKAGE_STRING='libfwevt 20240427'
 PACKAGE_BUGREPORT='joachim.metz@gmail.com'
 PACKAGE_URL=''
 
@@ -1556,7 +1556,7 @@ if test "$ac_init_help" = "long"; then
   # Omit some internal or obsolete options to make the list less imposing.
   # This message is too long to be a string in the A/UX 3.1 sh.
   cat <<_ACEOF
-\`configure' configures libfwevt 20240419 to adapt to many kinds of systems.
+\`configure' configures libfwevt 20240427 to adapt to many kinds of systems.
 
 Usage: $0 [OPTION]... [VAR=VALUE]...
 
@@ -1627,7 +1627,7 @@ fi
 
 if test -n "$ac_init_help"; then
   case $ac_init_help in
-     short | recursive ) echo "Configuration of libfwevt 20240419:";;
+     short | recursive ) echo "Configuration of libfwevt 20240427:";;
    esac
   cat <<\_ACEOF
 
@@ -1826,7 +1826,7 @@ fi
 test -n "$ac_init_help" && exit $ac_status
 if $ac_init_version; then
   cat <<\_ACEOF
-libfwevt configure 20240419
+libfwevt configure 20240427
 generated by GNU Autoconf 2.71
 
 Copyright (C) 2021 Free Software Foundation, Inc.
@@ -2547,7 +2547,7 @@ cat >config.log <<_ACEOF
 This file contains any messages produced by compilers while
 running configure, to aid debugging if configure makes a mistake.
 
-It was created by libfwevt $as_me 20240419, which was
+It was created by libfwevt $as_me 20240427, which was
 generated by GNU Autoconf 2.71.  Invocation command line was
 
   $ $0$ac_configure_args_raw
@@ -4036,7 +4036,7 @@ fi
 
 # Define the identity of the package.
  PACKAGE='libfwevt'
- VERSION='20240419'
+ VERSION='20240427'
 
 
 printf "%s\n" "#define PACKAGE \"$PACKAGE\"" >>confdefs.h
@@ -48644,7 +48644,7 @@ cat >>$CONFIG_STATUS <<\_ACEOF || ac_write_fail=1
 # report actual input values of CONFIG_FILES etc. instead of their
 # values after options handling.
 ac_log="
-This file was extended by libfwevt $as_me 20240419, which was
+This file was extended by libfwevt $as_me 20240427, which was
 generated by GNU Autoconf 2.71.  Invocation command line was
 
   CONFIG_FILES    = $CONFIG_FILES
@@ -48712,7 +48712,7 @@ ac_cs_config_escaped=`printf "%s\n" "$ac_cs_config" | sed "s/^ //; s/'/'\\\\\\\\
 cat >>$CONFIG_STATUS <<_ACEOF || ac_write_fail=1
 ac_cs_config='$ac_cs_config_escaped'
 ac_cs_version="\\
-libfwevt config.status 20240419
+libfwevt config.status 20240427
 configured by $0, generated by GNU Autoconf 2.71,
   with options \\"\$ac_cs_config\\"
 

{libfwevt-20240419 → libfwevt-20240427}/configure.ac

@@ -2,7 +2,7 @@ AC_PREREQ([2.71])
 
 AC_INIT(
  [libfwevt],
- [20240419],
+ [20240427],
  [joachim.metz@gmail.com])
 
 AC_CONFIG_SRCDIR(

libfwevt-20240427/dpkg/changelog

@@ -0,0 +1,5 @@
+libfwevt (20240427-1) unstable; urgency=low
+
+  * Auto-generated
+
+ -- Joachim Metz <joachim.metz@gmail.com>  Sat, 27 Apr 2024 14:06:20 +0200

{libfwevt-20240419 → libfwevt-20240427}/include/libfwevt/definitions.h

@@ -24,11 +24,11 @@
 
 #include <libfwevt/types.h>
 
-#define LIBFWEVT_VERSION						20240419
+#define LIBFWEVT_VERSION						20240427
 
 /* The version string
  */
-#define LIBFWEVT_VERSION_STRING						"20240419"
+#define LIBFWEVT_VERSION_STRING						"20240427"
 
 /* The byte order definitions
  */

{libfwevt-20240419 → libfwevt-20240427}/include/libfwevt/types.h

@@ -215,6 +215,7 @@ typedef intptr_t libfwevt_template_item_t;
 typedef intptr_t libfwevt_xml_document_t;
 typedef intptr_t libfwevt_xml_tag_t;
 typedef intptr_t libfwevt_xml_template_value_t;
+typedef intptr_t libfwevt_xml_value_t;
 
 #ifdef __cplusplus
 }

{libfwevt-20240419 → libfwevt-20240427}/include/libfwevt/types.h.in

@@ -215,6 +215,7 @@ typedef intptr_t libfwevt_template_item_t;
 typedef intptr_t libfwevt_xml_document_t;
 typedef intptr_t libfwevt_xml_tag_t;
 typedef intptr_t libfwevt_xml_template_value_t;
+typedef intptr_t libfwevt_xml_value_t;
 
 #ifdef __cplusplus
 }

{libfwevt-20240419 → libfwevt-20240427}/include/libfwevt.h

@@ -858,6 +858,14 @@ int libfwevt_xml_document_debug_print(
  * XML tag functions
  * ------------------------------------------------------------------------- */
 
+/* Frees a XML tag
+ * Returns 1 if successful or -1 on error
+ */
+LIBFWEVT_EXTERN \
+int libfwevt_xml_tag_free(
+     libfwevt_xml_tag_t **xml_tag,
+     libfwevt_error_t **error );
+
 /* Retrieves the size of the UTF-8 formatted name
  * Returns 1 if successful or -1 on error
  */
@@ -896,9 +904,19 @@ int libfwevt_xml_tag_get_utf16_name(
      size_t utf16_string_size,
      libfwevt_error_t **error );
 
+/* Retrieves the XML value
+ * Returns 1 if successful or -1 on error
+ */
+LIBFWEVT_EXTERN \
+int libfwevt_xml_tag_get_value(
+     libfwevt_xml_tag_t *xml_tag,
+     libfwevt_xml_value_t **xml_value,
+     libfwevt_error_t **error );
+
 /* Retrieves the size of the UTF-8 formatted value
  * Returns 1 if successful or -1 on error
  */
+LIBFWEVT_DEPRECATED \
 LIBFWEVT_EXTERN \
 int libfwevt_xml_tag_get_utf8_value_size(
      libfwevt_xml_tag_t *xml_tag,
@@ -908,6 +926,7 @@ int libfwevt_xml_tag_get_utf8_value_size(
 /* Retrieves the UTF-8 formatted value
  * Returns 1 if successful or -1 on error
  */
+LIBFWEVT_DEPRECATED \
 LIBFWEVT_EXTERN \
 int libfwevt_xml_tag_get_utf8_value(
      libfwevt_xml_tag_t *xml_tag,
@@ -918,6 +937,7 @@ int libfwevt_xml_tag_get_utf8_value(
 /* Retrieves the size of the UTF-16 formatted value
  * Returns 1 if successful or -1 on error
  */
+LIBFWEVT_DEPRECATED \
 LIBFWEVT_EXTERN \
 int libfwevt_xml_tag_get_utf16_value_size(
      libfwevt_xml_tag_t *xml_tag,
@@ -927,6 +947,7 @@ int libfwevt_xml_tag_get_utf16_value_size(
 /* Retrieves the UTF-16 formatted value
  * Returns 1 if successful or -1 on error
  */
+LIBFWEVT_DEPRECATED \
 LIBFWEVT_EXTERN \
 int libfwevt_xml_tag_get_utf16_value(
      libfwevt_xml_tag_t *xml_tag,
@@ -1025,6 +1046,141 @@ int libfwevt_xml_tag_get_flags(
      uint8_t *flags,
      libfwevt_error_t **error );
 
+/* -------------------------------------------------------------------------
+ * XML value functions
+ * ------------------------------------------------------------------------- */
+
+/* Frees a XML value
+ * Returns 1 if successful or -1 on error
+ */
+LIBFWEVT_EXTERN \
+int libfwevt_xml_value_free(
+     libfwevt_xml_value_t **xml_value,
+     libfwevt_error_t **error );
+
+/* Retrieves the data size
+ * Returns 1 if successful or -1 on error
+ */
+LIBFWEVT_EXTERN \
+int libfwevt_xml_value_get_data_size(
+     libfwevt_xml_value_t *xml_value,
+     size_t *data_size,
+     libfwevt_error_t **error );
+
+/* Copies the data
+ * Returns 1 if successful or -1 on error
+ */
+LIBFWEVT_EXTERN \
+int libfwevt_xml_value_copy_data(
+     libfwevt_xml_value_t *xml_value,
+     uint8_t *data,
+     size_t data_size,
+     libfwevt_error_t **error );
+
+/* Copies the value data to an 8-bit value
+ * Returns 1 if successful, 0 if value not be retrieved or -1 on error
+ */
+LIBFWEVT_DEPRECATED \
+LIBFWEVT_EXTERN \
+int libfwevt_xml_value_copy_to_8bit(
+     libfwevt_xml_value_t *xml_value,
+     uint8_t *value_8bit,
+     libfwevt_error_t **error );
+
+/* Copies the value data to an 32-bit value
+ * Returns 1 if successful, 0 if value not be retrieved or -1 on error
+ */
+LIBFWEVT_DEPRECATED \
+LIBFWEVT_EXTERN \
+int libfwevt_xml_value_copy_to_32bit(
+     libfwevt_xml_value_t *xml_value,
+     uint32_t *value_32bit,
+     libfwevt_error_t **error );
+
+/* Copies the value data to an 64-bit value
+ * Returns 1 if successful, 0 if value not be retrieved or -1 on error
+ */
+LIBFWEVT_DEPRECATED \
+LIBFWEVT_EXTERN \
+int libfwevt_xml_value_copy_to_64bit(
+     libfwevt_xml_value_t *xml_value,
+     uint64_t *value_64bit,
+     libfwevt_error_t **error );
+
+/* Retrieves the value data as a 8-bit integer value
+ * Returns 1 if successful, 0 if value not be retrieved or -1 on error
+ */
+LIBFWEVT_EXTERN \
+int libfwevt_value_get_data_as_8bit_integer(
+     libfwevt_xml_value_t *xml_value,
+     uint8_t *value_8bit,
+     libfwevt_error_t **error );
+
+/* Retrieves the value data as a 32-bit integer value
+ * Returns 1 if successful, 0 if value not be retrieved or -1 on error
+ */
+LIBFWEVT_EXTERN \
+int libfwevt_value_get_data_as_32bit_integer(
+     libfwevt_xml_value_t *xml_value,
+     uint32_t *value_32bit,
+     libfwevt_error_t **error );
+
+/* Retrieves the value data as a 64-bit integer value
+ * Returns 1 if successful, 0 if value not be retrieved or -1 on error
+ */
+LIBFWEVT_EXTERN \
+int libfwevt_value_get_data_as_64bit_integer(
+     libfwevt_xml_value_t *xml_value,
+     uint64_t *value_64bit,
+     libfwevt_error_t **error );
+
+/* Retrieves the value data as a 64-bit FILETIME value
+ * Returns 1 if successful, 0 if value not be retrieved or -1 on error
+ */
+LIBFWEVT_EXTERN \
+int libfwevt_value_get_data_as_filetime(
+     libfwevt_xml_value_t *xml_value,
+     uint64_t *filetime,
+     libfwevt_error_t **error );
+
+/* Retrieves the size of an UTF-8 encoded string of the value data
+ * Returns 1 if successful, 0 if value not be retrieved or -1 on error
+ */
+LIBFWEVT_EXTERN \
+int libfwevt_xml_value_get_utf8_string_size(
+     libfwevt_xml_value_t *xml_value,
+     size_t *utf8_string_size,
+     libfwevt_error_t **error );
+
+/* Copies the value data to an UTF-8 encoded string
+ * Returns 1 if successful, 0 if value not be retrieved or -1 on error
+ */
+LIBFWEVT_EXTERN \
+int libfwevt_xml_value_copy_to_utf8_string(
+     libfwevt_xml_value_t *xml_value,
+     uint8_t *utf8_string,
+     size_t utf8_string_size,
+     libfwevt_error_t **error );
+
+/* Retrieves the size of an UTF-16 encoded string of the value data
+ * Returns 1 if successful, 0 if value not be retrieved or -1 on error
+ */
+LIBFWEVT_EXTERN \
+int libfwevt_xml_value_get_utf16_string_size(
+     libfwevt_xml_value_t *xml_value,
+     size_t *utf16_string_size,
+     libfwevt_error_t **error );
+
+/* Copies the value data to an UTF-16 encoded string
+ * Returns 1 if successful, 0 if value not be retrieved or -1 on error
+ */
+LIBFWEVT_EXTERN \
+int libfwevt_xml_value_copy_to_utf16_string(
+     libfwevt_xml_value_t *xml_value,
+     uint16_t *utf16_string,
+     size_t utf16_string_size,
+     libfwevt_error_t **error );
+
 #if defined( __cplusplus )
 }
 #endif

{libfwevt-20240419 → libfwevt-20240427}/include/libfwevt.h.in

@@ -858,6 +858,14 @@ int libfwevt_xml_document_debug_print(
  * XML tag functions
  * ------------------------------------------------------------------------- */
 
+/* Frees a XML tag
+ * Returns 1 if successful or -1 on error
+ */
+LIBFWEVT_EXTERN \
+int libfwevt_xml_tag_free(
+     libfwevt_xml_tag_t **xml_tag,
+     libfwevt_error_t **error );
+
 /* Retrieves the size of the UTF-8 formatted name
  * Returns 1 if successful or -1 on error
  */
@@ -896,9 +904,19 @@ int libfwevt_xml_tag_get_utf16_name(
      size_t utf16_string_size,
      libfwevt_error_t **error );
 
+/* Retrieves the XML value
+ * Returns 1 if successful or -1 on error
+ */
+LIBFWEVT_EXTERN \
+int libfwevt_xml_tag_get_value(
+     libfwevt_xml_tag_t *xml_tag,
+     libfwevt_xml_value_t **xml_value,
+     libfwevt_error_t **error );
+
 /* Retrieves the size of the UTF-8 formatted value
  * Returns 1 if successful or -1 on error
  */
+LIBFWEVT_DEPRECATED \
 LIBFWEVT_EXTERN \
 int libfwevt_xml_tag_get_utf8_value_size(
      libfwevt_xml_tag_t *xml_tag,
@@ -908,6 +926,7 @@ int libfwevt_xml_tag_get_utf8_value_size(
 /* Retrieves the UTF-8 formatted value
  * Returns 1 if successful or -1 on error
  */
+LIBFWEVT_DEPRECATED \
 LIBFWEVT_EXTERN \
 int libfwevt_xml_tag_get_utf8_value(
      libfwevt_xml_tag_t *xml_tag,
@@ -918,6 +937,7 @@ int libfwevt_xml_tag_get_utf8_value(
 /* Retrieves the size of the UTF-16 formatted value
  * Returns 1 if successful or -1 on error
  */
+LIBFWEVT_DEPRECATED \
 LIBFWEVT_EXTERN \
 int libfwevt_xml_tag_get_utf16_value_size(
      libfwevt_xml_tag_t *xml_tag,
@@ -927,6 +947,7 @@ int libfwevt_xml_tag_get_utf16_value_size(
 /* Retrieves the UTF-16 formatted value
  * Returns 1 if successful or -1 on error
  */
+LIBFWEVT_DEPRECATED \
 LIBFWEVT_EXTERN \
 int libfwevt_xml_tag_get_utf16_value(
      libfwevt_xml_tag_t *xml_tag,
@@ -1025,6 +1046,141 @@ int libfwevt_xml_tag_get_flags(
      uint8_t *flags,
      libfwevt_error_t **error );
 
+/* -------------------------------------------------------------------------
+ * XML value functions
+ * ------------------------------------------------------------------------- */
+
+/* Frees a XML value
+ * Returns 1 if successful or -1 on error
+ */
+LIBFWEVT_EXTERN \
+int libfwevt_xml_value_free(
+     libfwevt_xml_value_t **xml_value,
+     libfwevt_error_t **error );
+
+/* Retrieves the data size
+ * Returns 1 if successful or -1 on error
+ */
+LIBFWEVT_EXTERN \
+int libfwevt_xml_value_get_data_size(
+     libfwevt_xml_value_t *xml_value,
+     size_t *data_size,
+     libfwevt_error_t **error );
+
+/* Copies the data
+ * Returns 1 if successful or -1 on error
+ */
+LIBFWEVT_EXTERN \
+int libfwevt_xml_value_copy_data(
+     libfwevt_xml_value_t *xml_value,
+     uint8_t *data,
+     size_t data_size,
+     libfwevt_error_t **error );
+
+/* Copies the value data to an 8-bit value
+ * Returns 1 if successful, 0 if value not be retrieved or -1 on error
+ */
+LIBFWEVT_DEPRECATED \
+LIBFWEVT_EXTERN \
+int libfwevt_xml_value_copy_to_8bit(
+     libfwevt_xml_value_t *xml_value,
+     uint8_t *value_8bit,
+     libfwevt_error_t **error );
+
+/* Copies the value data to an 32-bit value
+ * Returns 1 if successful, 0 if value not be retrieved or -1 on error
+ */
+LIBFWEVT_DEPRECATED \
+LIBFWEVT_EXTERN \
+int libfwevt_xml_value_copy_to_32bit(
+     libfwevt_xml_value_t *xml_value,
+     uint32_t *value_32bit,
+     libfwevt_error_t **error );
+
+/* Copies the value data to an 64-bit value
+ * Returns 1 if successful, 0 if value not be retrieved or -1 on error
+ */
+LIBFWEVT_DEPRECATED \
+LIBFWEVT_EXTERN \
+int libfwevt_xml_value_copy_to_64bit(
+     libfwevt_xml_value_t *xml_value,
+     uint64_t *value_64bit,
+     libfwevt_error_t **error );
+
+/* Retrieves the value data as a 8-bit integer value
+ * Returns 1 if successful, 0 if value not be retrieved or -1 on error
+ */
+LIBFWEVT_EXTERN \
+int libfwevt_value_get_data_as_8bit_integer(
+     libfwevt_xml_value_t *xml_value,
+     uint8_t *value_8bit,
+     libfwevt_error_t **error );
+
+/* Retrieves the value data as a 32-bit integer value
+ * Returns 1 if successful, 0 if value not be retrieved or -1 on error
+ */
+LIBFWEVT_EXTERN \
+int libfwevt_value_get_data_as_32bit_integer(
+     libfwevt_xml_value_t *xml_value,
+     uint32_t *value_32bit,
+     libfwevt_error_t **error );
+
+/* Retrieves the value data as a 64-bit integer value
+ * Returns 1 if successful, 0 if value not be retrieved or -1 on error
+ */
+LIBFWEVT_EXTERN \
+int libfwevt_value_get_data_as_64bit_integer(
+     libfwevt_xml_value_t *xml_value,
+     uint64_t *value_64bit,
+     libfwevt_error_t **error );
+
+/* Retrieves the value data as a 64-bit FILETIME value
+ * Returns 1 if successful, 0 if value not be retrieved or -1 on error
+ */
+LIBFWEVT_EXTERN \
+int libfwevt_value_get_data_as_filetime(
+     libfwevt_xml_value_t *xml_value,
+     uint64_t *filetime,
+     libfwevt_error_t **error );
+
+/* Retrieves the size of an UTF-8 encoded string of the value data
+ * Returns 1 if successful, 0 if value not be retrieved or -1 on error
+ */
+LIBFWEVT_EXTERN \
+int libfwevt_xml_value_get_utf8_string_size(
+     libfwevt_xml_value_t *xml_value,
+     size_t *utf8_string_size,
+     libfwevt_error_t **error );
+
+/* Copies the value data to an UTF-8 encoded string
+ * Returns 1 if successful, 0 if value not be retrieved or -1 on error
+ */
+LIBFWEVT_EXTERN \
+int libfwevt_xml_value_copy_to_utf8_string(
+     libfwevt_xml_value_t *xml_value,
+     uint8_t *utf8_string,
+     size_t utf8_string_size,
+     libfwevt_error_t **error );
+
+/* Retrieves the size of an UTF-16 encoded string of the value data
+ * Returns 1 if successful, 0 if value not be retrieved or -1 on error
+ */
+LIBFWEVT_EXTERN \
+int libfwevt_xml_value_get_utf16_string_size(
+     libfwevt_xml_value_t *xml_value,
+     size_t *utf16_string_size,
+     libfwevt_error_t **error );
+
+/* Copies the value data to an UTF-16 encoded string
+ * Returns 1 if successful, 0 if value not be retrieved or -1 on error
+ */
+LIBFWEVT_EXTERN \
+int libfwevt_xml_value_copy_to_utf16_string(
+     libfwevt_xml_value_t *xml_value,
+     uint16_t *utf16_string,
+     size_t utf16_string_size,
+     libfwevt_error_t **error );
+
 #if defined( __cplusplus )
 }
 #endif

{libfwevt-20240419 → libfwevt-20240427}/libfwevt/Makefile.am

@@ -18,6 +18,7 @@ libfwevt_la_SOURCES = \
 	fwevt_template.h \
 	libfwevt.c \
 	libfwevt_channel.c libfwevt_channel.h \
+	libfwevt_date_time.c libfwevt_date_time.h \
 	libfwevt_debug.c libfwevt_debug.h \
 	libfwevt_definitions.h \
 	libfwevt_extern.h \
@@ -45,7 +46,8 @@ libfwevt_la_SOURCES = \
 	libfwevt_xml_document.c libfwevt_xml_document.h \
 	libfwevt_xml_tag.c libfwevt_xml_tag.h \
 	libfwevt_xml_template_value.c libfwevt_xml_template_value.h \
-	libfwevt_xml_token.c libfwevt_xml_token.h
+	libfwevt_xml_token.c libfwevt_xml_token.h \
+	libfwevt_xml_value.c libfwevt_xml_value.h
 
 libfwevt_la_LIBADD = \
 	@LIBCERROR_LIBADD@ \