Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
libcreg(3)		    Library Functions Manual		    libcreg(3)

NAME
       libcreg.h  --  Library to access	the Windows 9x/Me Registry File	(CREG)
       format

SYNOPSIS
       #include	<libcreg.h>

       Support functions

       const char *
       libcreg_get_version(void);

       int
       libcreg_get_access_flags_read(void);

       int
       libcreg_get_codepage(int	*codepage, libcreg_error_t **error);

       int
       libcreg_set_codepage(int	codepage, libcreg_error_t **error);

       int
       libcreg_check_file_signature(const	    char	    *filename,
	   libcreg_error_t **error);

       Available when compiled with wide character string support:

       int
       libcreg_check_file_signature_wide(const	      wchar_t	    *filename,
	   libcreg_error_t **error);

       Available when compiled with libbfio support:

       int
       libcreg_check_file_signature_file_io_handle(libbfio_handle_*tbfio_handle,
	   libcreg_error_t **error);

       Notify functions

       void
       libcreg_notify_set_verbose(int verbose);

       int
       libcreg_notify_set_stream(FILE *stream, libcreg_error_t **error);

       int
       libcreg_notify_stream_open(const		    char	    *filename,
	   libcreg_error_t **error);

       int
       libcreg_notify_stream_close(libcreg_error_t **error);

       Error functions

       void
       libcreg_error_free(libcreg_error_t **error);

       int
       libcreg_error_fprint(libcreg_error_t *error, FILE *stream);

       int
       libcreg_error_sprint(libcreg_error_t	*error,	    char      *string,
	   size_t size);

       int
       libcreg_error_backtrace_fprint(libcreg_error_t *error, FILE *stream);

       int
       libcreg_error_backtrace_sprint(libcreg_error_t  *error,	char  *string,
	   size_t size);

       File functions

       int
       libcreg_file_initialize(libcreg_file_t			       **file,
	   libcreg_error_t **error);

       int
       libcreg_file_free(libcreg_file_t	**file,	libcreg_error_t	**error);

       int
       libcreg_file_signal_abort(libcreg_file_t				*file,
	   libcreg_error_t **error);

       int
       libcreg_file_open(libcreg_file_t	  *file,   const    char    *filename,
	   int access_flags, libcreg_error_t **error);

       int
       libcreg_file_close(libcreg_file_t *file,	libcreg_error_t	**error);

       int
       libcreg_file_is_corrupted(libcreg_file_t				*file,
	   libcreg_error_t **error);

       int
       libcreg_file_get_ascii_codepage(libcreg_file_t			*file,
	   int *ascii_codepage,	libcreg_error_t	**error);

       int
       libcreg_file_set_ascii_codepage(libcreg_file_t			*file,
	   int ascii_codepage, libcreg_error_t **error);

       int
       libcreg_file_get_format_version(libcreg_file_t			*file,
	   uint16_t	  *major_version,	uint16_t       *minor_version,
	   libcreg_error_t **error);

       int
       libcreg_file_get_type(libcreg_file_t   *file,   uint32_t	   *file_type,
	   libcreg_error_t **error);

       int
       libcreg_file_get_root_key(libcreg_file_t				*file,
	   libcreg_key_t **root_key, libcreg_error_t **error);

       int
       libcreg_file_get_key_by_utf8_path(libcreg_file_t			*file,
	   const     uint8_t	*utf8_string,	 size_t	   utf8_string_length,
	   libcreg_key_t **key,	libcreg_error_t	**error);

       int
       libcreg_file_get_key_by_utf16_path(libcreg_file_t		*file,
	   const    uint16_t	*utf16_string,	 size_t	  utf16_string_length,
	   libcreg_key_t **key,	libcreg_error_t	**error);

       Available when compiled with wide character string support:

       int
       libcreg_file_open_wide(libcreg_file_t *file, const  wchar_t  *filename,
	   int access_flags, libcreg_error_t **error);

       Available when compiled with libbfio support:

       int
       libcreg_file_open_file_io_handle(libcreg_file_t			*file,
	   libbfio_handle_t	 *file_io_handle,      int	 access_flags,
	   libcreg_error_t **error);

       Key functions

       int
       libcreg_key_free(libcreg_key_t **key, libcreg_error_t **error);

       int
       libcreg_key_is_corrupted(libcreg_key_t *key, libcreg_error_t **error);

       int
       libcreg_key_get_offset(libcreg_key_t	*key,	  off64_t     *offset,
	   libcreg_error_t **error);

       int
       libcreg_key_get_name_size(libcreg_key_t	*key,	size_t	 *string_size,
	   libcreg_error_t **error);

       int
       libcreg_key_get_name(libcreg_key_t      *key,	  uint8_t     *string,
	   size_t string_size, libcreg_error_t **error);

       int
       libcreg_key_get_utf8_name_size(libcreg_key_t			 *key,
	   size_t *utf8_string_size, libcreg_error_t **error);

       int
       libcreg_key_get_utf8_name(libcreg_key_t	 *key,	uint8_t	 *utf8_string,
	   size_t utf8_string_size, libcreg_error_t **error);

       int
       libcreg_key_get_utf16_name_size(libcreg_key_t			 *key,
	   size_t *utf16_string_size, libcreg_error_t **error);

       int
       libcreg_key_get_utf16_name(libcreg_key_t	 *key, uint16_t	*utf16_string,
	   size_t utf16_string_size, libcreg_error_t **error);

       int
       libcreg_key_get_number_of_values(libcreg_key_t			 *key,
	   int *number_of_values, libcreg_error_t **error);

       int
       libcreg_key_get_value_by_index(libcreg_key_t   *key,  int  value_index,
	   libcreg_value_t **value, libcreg_error_t **error);

       int
       libcreg_key_get_value_by_utf8_name(libcreg_key_t			 *key,
	   const     uint8_t	*utf8_string,	 size_t	   utf8_string_length,
	   libcreg_value_t **value, libcreg_error_t **error);

       int
       libcreg_key_get_value_by_utf16_name(libcreg_key_t		 *key,
	   const    uint16_t	*utf16_string,	 size_t	  utf16_string_length,
	   libcreg_value_t **value, libcreg_error_t **error);

       int
       libcreg_key_get_number_of_sub_keys(libcreg_key_t			 *key,
	   int *number_of_sub_keys, libcreg_error_t **error);

       int
       libcreg_key_get_sub_key_by_index(libcreg_key_t *key, int	sub_key_index,
	   libcreg_key_t **sub_key, libcreg_error_t **error);

       int
       libcreg_key_get_sub_key_by_utf8_name(libcreg_key_t		 *key,
	   const    uint8_t    *utf8_string,	size_t	   utf8_string_length,
	   libcreg_key_t **sub_key, libcreg_error_t **error);

       int
       libcreg_key_get_sub_key_by_utf8_path(libcreg_key_t		 *key,
	   const    uint8_t    *utf8_string,	size_t	   utf8_string_length,
	   libcreg_key_t **sub_key, libcreg_error_t **error);

       int
       libcreg_key_get_sub_key_by_utf16_name(libcreg_key_t		 *key,
	   const   uint16_t   *utf16_string,	size_t	  utf16_string_length,
	   libcreg_key_t **sub_key, libcreg_error_t **error);

       int
       libcreg_key_get_sub_key_by_utf16_path(libcreg_key_t		 *key,
	   const   uint16_t   *utf16_string,	size_t	  utf16_string_length,
	   libcreg_key_t **sub_key, libcreg_error_t **error);

       Value functions

       int
       libcreg_value_free(libcreg_value_t **value, libcreg_error_t **error);

       int
       libcreg_value_is_corrupted(libcreg_value_t		       *value,
	   libcreg_error_t **error);

       int
       libcreg_value_get_offset(libcreg_value_t	  *value,   off64_t   *offset,
	   libcreg_error_t **error);

       int
       libcreg_value_get_name_size(libcreg_value_t		       *value,
	   size_t *string_size,	libcreg_error_t	**error);

       int
       libcreg_value_get_name(libcreg_value_t	*value,	   uint8_t    *string,
	   size_t string_size, libcreg_error_t **error);

       int
       libcreg_value_get_utf8_name_size(libcreg_value_t		       *value,
	   size_t *utf8_string_size, libcreg_error_t **error);

       int
       libcreg_value_get_utf8_name(libcreg_value_t		       *value,
	   uint8_t	  *utf8_string,	       size_t	     utf8_string_size,
	   libcreg_error_t **error);

       int
       libcreg_value_get_utf16_name_size(libcreg_value_t	       *value,
	   size_t *utf16_string_size, libcreg_error_t **error);

       int
       libcreg_value_get_utf16_name(libcreg_value_t		       *value,
	   uint16_t	  *utf16_string,       size_t	    utf16_string_size,
	   libcreg_error_t **error);

       int
       libcreg_value_get_value_type(libcreg_value_t		       *value,
	   uint32_t *value_type, libcreg_error_t **error);

       int
       libcreg_value_get_value_data_size(libcreg_value_t	       *value,
	   size_t *value_data_size, libcreg_error_t **error);

       int
       libcreg_value_get_value_data(libcreg_value_t		       *value,
	   uint8_t	  *value_data,	       size_t	      value_data_size,
	   libcreg_error_t **error);

       int
       libcreg_value_get_value_32bit(libcreg_value_t		       *value,
	   uint32_t *value_32bit, libcreg_error_t **error);

       int
       libcreg_value_get_value_64bit(libcreg_value_t		       *value,
	   uint64_t *value_64bit, libcreg_error_t **error);

       int
       libcreg_value_get_value_utf8_string_size(libcreg_value_t	       *value,
	   size_t *utf8_string_size, libcreg_error_t **error);

       int
       libcreg_value_get_value_utf8_string(libcreg_value_t	       *value,
	   uint8_t	  *utf8_string,	       size_t	     utf8_string_size,
	   libcreg_error_t **error);

       int
       libcreg_value_get_value_utf16_string_size(libcreg_value_t       *value,
	   size_t *utf16_string_size, libcreg_error_t **error);

       int
       libcreg_value_get_value_utf16_string(libcreg_value_t	       *value,
	   uint16_t	  *utf16_string,       size_t	    utf16_string_size,
	   libcreg_error_t **error);

       int
       libcreg_value_get_value_binary_data_size(libcreg_value_t	       *value,
	   size_t *size, libcreg_error_t **error);

       int
       libcreg_value_get_value_binary_data(libcreg_value_t	       *value,
	   uint8_t *binary_data, size_t	size, libcreg_error_t **error);

DESCRIPTION
       The libcreg_get_version() function is used to retrieve the library ver-
       sion.

RETURN VALUES
       Most  of	the functions return NULL or -1	on error, dependent on the re-
       turn type.  For the actual return values	see "libcreg.h".

ENVIRONMENT
       None

FILES
       None

NOTES
       libcreg can be compiled with wide character support (wchar_t).

       To  compile  libcreg  with  wide	 character  support  use:  ./configure
       --enable-wide-character-type=yes
	or define: _UNICODE
	or UNICODE
	during compilation.

       LIBCREG_WIDE_CHARACTER_TYPE
	in libcreg/features.h can be used to determine if libcreg was compiled
       with wide character support.

BUGS
       Please	report	bugs  of  any  kind  on	 the  project  issue  tracker:
       https://github.com/libyal/libcreg/issues

AUTHOR
       These man pages are generated from "libcreg.h".

COPYRIGHT
       Copyright (C) 2013-2024,	Joachim	Metz <joachim.metz@gmail.com>.

       This is free software; see the source for copying conditions.  There is
       NO warranty; not	even for MERCHANTABILITY or FITNESS FOR	 A  PARTICULAR
       PURPOSE.

SEE ALSO
       the libcreg.h include file

libcreg				April 10, 2019			    libcreg(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=libcreg&sektion=3&manpath=FreeBSD+Ports+15.0>

home | help