|
Greenbone Vulnerability Management Libraries 22.26.0
|
Headers for simple XML reader. More...
Go to the source code of this file.
Data Structures | |
| struct | context_data_t |
| XML context. More... | |
| struct | entity_s |
| XML element. More... | |
| struct | xml_search_data_t |
| Data for xml search functions. More... | |
Typedefs | |
| typedef GSList * | entities_t |
| Entities. | |
| typedef struct entity_s * | entity_t |
| typedef struct _xmlNode * | element_t |
| typedef struct xml_file_iterator_struct * | xml_file_iterator_t |
Functions | |
| void | xml_handle_start_element (context_data_t *, const gchar *, const gchar **, const gchar **) |
| Handle the start of an OMP XML element. | |
| void | xml_handle_end_element (context_data_t *, const gchar *) |
| Handle the end of an XML element. | |
| void | xml_handle_text (context_data_t *, const gchar *, gsize) |
| Handle additional text of an XML element. | |
| entities_t | next_entities (entities_t) |
| Return all the entities from an entities_t after the first. | |
| entity_t | first_entity (entities_t) |
| Return the first entity from an entities_t. | |
| entity_t | add_entity (entities_t *, const char *, const char *) |
| Add an XML entity to a tree of entities. | |
| int | compare_entities (entity_t, entity_t) |
| Compare two XML entity. | |
| entity_t | entity_child (entity_t, const char *) |
| Get a child of an entity. | |
| const char * | entity_attribute (entity_t, const char *) |
| Get an attribute of an entity. | |
| char * | entity_name (entity_t entity) |
| Get the name an entity. | |
| char * | entity_text (entity_t entity) |
| Get the text an entity. | |
| void | free_entity (entity_t) |
| Free an entity, recursively. | |
| void | print_entity (FILE *, entity_t) |
| Print an XML entity. | |
| void | print_entity_format (entity_t, gpointer indentation) |
| Print an XML entity to stdout, recursively printing its children. | |
| int | try_read_entity_and_string (gnutls_session_t *, int, entity_t *, GString **) |
| Try read an XML entity tree from the manager. | |
| int | read_entity_and_string (gnutls_session_t *, entity_t *, GString **) |
| Try read an XML entity tree from the manager. | |
| int | read_entity_and_string_c (gvm_connection_t *, entity_t *, GString **) |
| Try read an XML entity tree from the manager. | |
| int | read_entity_and_text (gnutls_session_t *, entity_t *, char **) |
| Read an XML entity tree from the manager. | |
| int | read_entity_and_text_c (gvm_connection_t *, entity_t *, char **) |
| Read an XML entity tree from the manager. | |
| int | try_read_entity (gnutls_session_t *, int, entity_t *) |
| Try read an XML entity tree from the manager. | |
| int | try_read_entity_c (gvm_connection_t *, int, entity_t *) |
| Try read an XML entity tree from the manager. | |
| int | read_entity (gnutls_session_t *, entity_t *) |
| Read an XML entity tree from the manager. | |
| int | read_entity_s (int, entity_t *) |
| Read an XML entity tree from the socket. | |
| int | read_entity_c (gvm_connection_t *, entity_t *) |
| Read an XML entity tree from the manager. | |
| int | read_string (gnutls_session_t *, GString **) |
| Read entity and text. Free the entity immediately. | |
| int | read_string_c (gvm_connection_t *, GString **) |
| Read entity and text. Free the entity immediately. | |
| int | read_text_c (gvm_connection_t *, char **) |
| Read text from the server. | |
| int | parse_entity (const char *, entity_t *) |
| Read an XML entity tree from a string. | |
| void | print_entity_to_string (entity_t entity, GString *string) |
| Print an XML entity tree to a GString, appending it if string is not. | |
| int | xml_count_entities (entities_t) |
| Count the number of entities. | |
| void | xml_string_append (GString *, const char *,...) |
| Append formatted escaped XML to a string. | |
| int | find_element_in_xml_file (gchar *, gchar *, GHashTable *) |
| Tests if an XML file contains an element with given attributes. | |
| int | parse_element (const gchar *, element_t *) |
| Read an XML element tree from a string. | |
| void | element_free (element_t) |
| Free an entire element tree. | |
| const gchar * | element_name (element_t) |
| Get the name of an element. | |
| gchar * | element_attribute (element_t, const gchar *) |
| Get an attribute of an element. | |
| gchar * | element_text (element_t) |
| Get text of an element. | |
| element_t | element_child (element_t, const gchar *) |
| Get a child of an element. | |
| element_t | element_first_child (element_t) |
| Get the first child of an element. | |
| element_t | element_next (element_t) |
| Get the next sibling of an element. | |
| gchar * | element_to_string (element_t element) |
| Output the XML element as a string. | |
| void | print_element_to_string (element_t element, GString *string) |
| Print an XML element tree to a GString, appending it if string is not. | |
| xml_file_iterator_t | xml_file_iterator_new (void) |
| Allocates a new, uninitialized XML file iterator. | |
| int | xml_file_iterator_init_from_file_path (xml_file_iterator_t, const char *, int) |
| Initializes an XML file iterator to read from a given path. | |
| void | xml_file_iterator_free (xml_file_iterator_t) |
| Frees an XML file iterator and all of its internal data structures. | |
| int | xml_file_iterator_rewind (xml_file_iterator_t) |
| Rewinds an XML file iterator by rewinding the file and creating a new XML parser context. | |
| element_t | xml_file_iterator_next (xml_file_iterator_t, gchar **) |
| Get the next subelement from a XML file iterator. | |
Headers for simple XML reader.
| typedef struct _xmlNode* element_t |
| typedef GSList* entities_t |
Entities.
| typedef struct xml_file_iterator_struct* xml_file_iterator_t |
| entity_t add_entity | ( | entities_t * | entities, |
| const char * | name, | ||
| const char * | text ) |
Add an XML entity to a tree of entities.
| [in] | entities | The tree of entities |
| [in] | name | Name of the entity. Copied, copy is freed by free_entity. |
| [in] | text | Text of the entity. Copied, copy is freed by free_entity. |
Compare two XML entity.
| [in] | entity1 | First entity. |
| [in] | entity2 | First entity. |
| gchar * element_attribute | ( | element_t | element, |
| const gchar * | name ) |
Get an attribute of an element.
| [in] | element | Element. |
| [in] | name | Name of the attribute. |
Get a child of an element.
| [in] | element | Element. |
| [in] | name | Name of the child. |
Get the first child of an element.
| [in] | element | Element. |
| void element_free | ( | element_t | element | ) |
Free an entire element tree.
Beware that this frees the entire tree that element is part of, including any ancestors.
| [in] | element | Element. |
| const gchar * element_name | ( | element_t | element | ) |
Get the name of an element.
| [in] | element | Element. |
Get the next sibling of an element.
| [in] | element | Element. |
| gchar * element_text | ( | element_t | element | ) |
Get text of an element.
If element is not NULL then the return is guaranteed to be a string. So if the caller has NULL checked element then there is no need for the caller to NULL check the return.
| [in] | element | Element. |
| gchar * element_to_string | ( | element_t | element | ) |
Output the XML element as a string.
The generated XML string will include namespace definitions from ancestor elements.
| [in] | element | The element to output as a string. |
| const char * entity_attribute | ( | entity_t | entity, |
| const char * | name ) |
Get an attribute of an entity.
| [in] | entity | Entity. |
| [in] | name | Name of the attribute. |
Get a child of an entity.
| [in] | entity | Entity. |
| [in] | name | Name of the child. |
| char * entity_name | ( | entity_t | entity | ) |
Get the name an entity.
| [in] | entity | Entity. |
| char * entity_text | ( | entity_t | entity | ) |
Get the text an entity.
| [in] | entity | Entity. |
| int find_element_in_xml_file | ( | gchar * | file_path, |
| gchar * | find_element, | ||
| GHashTable * | find_attributes ) |
Tests if an XML file contains an element with given attributes.
| [in] | file_path | Path of the XML file. |
| [in] | find_element | Name of the element to find. |
| [in] | find_attributes | GHashTable of attributes to find. |
| entity_t first_entity | ( | entities_t | entities | ) |
Return the first entity from an entities_t.
| [in] | entities | The list of entities. |
| void free_entity | ( | entity_t | entity | ) |
Free an entity, recursively.
| [in] | entity | The entity, can be NULL. |
| entities_t next_entities | ( | entities_t | entities | ) |
Return all the entities from an entities_t after the first.
| [in] | entities | The list of entities. |
| int parse_element | ( | const gchar * | string, |
| element_t * | element ) |
Read an XML element tree from a string.
Caller must not free string until caller is finished using element.
| [in] | string | Input string. |
| [out] | element | Location for parsed element tree, or NULL if not required. If given, set to NULL on failure. Free with element_free. |
| int parse_entity | ( | const char * | string, |
| entity_t * | entity ) |
Read an XML entity tree from a string.
| [in] | string | Input string. |
| [out] | entity | Pointer to an entity tree. |
| void print_element_to_string | ( | element_t | element, |
| GString * | string ) |
Print an XML element tree to a GString, appending it if string is not.
empty.
| [in] | element | Element tree to print to string. |
| [in,out] | string | String to write to. |
| void print_entity | ( | FILE * | stream, |
| entity_t | entity ) |
Print an XML entity.
| [in] | entity | The entity. |
| [in] | stream | The stream to which to print. |
| void print_entity_format | ( | entity_t | entity, |
| gpointer | indent ) |
Print an XML entity to stdout, recursively printing its children.
Does very basic indentation for pretty printing.
This function is used as the (callback) GFunc in g_slist_foreach.
| [in] | entity | The entity. |
| [in] | indent | Indentation level, indentation width is 2 spaces. Use GINT_TO_POINTER to convert a integer value when passing this parameter. |
| void print_entity_to_string | ( | entity_t | entity, |
| GString * | string ) |
Print an XML entity tree to a GString, appending it if string is not.
empty.
| [in] | entity | Entity tree to print to string. |
| [in,out] | string | String to write to. |
| int read_entity | ( | gnutls_session_t * | session, |
| entity_t * | entity ) |
Read an XML entity tree from the manager.
| [in] | session | Pointer to GNUTLS session. |
| [out] | entity | Pointer to an entity tree. |
| int read_entity_and_string | ( | gnutls_session_t * | session, |
| entity_t * | entity, | ||
| GString ** | string_return ) |
Try read an XML entity tree from the manager.
| [in] | session | Pointer to GNUTLS session. |
| [out] | entity | Pointer to an entity tree. |
| [out] | string_return | An optional return location for the text read from the session. If NULL then it simply remains NULL. If a pointer to NULL then it points to a freshly allocated GString on successful return. Otherwise it points to an existing GString onto which the text is appended. |
| int read_entity_and_string_c | ( | gvm_connection_t * | connection, |
| entity_t * | entity, | ||
| GString ** | string_return ) |
Try read an XML entity tree from the manager.
| [in] | connection | Connection. |
| [out] | entity | Pointer to an entity tree. |
| [out] | string_return | An optional return location for the text read from the session. If NULL then it simply remains NULL. If a pointer to NULL then it points to a freshly allocated GString on successful return. Otherwise it points to an existing GString onto which the text is appended. |
| int read_entity_and_text | ( | gnutls_session_t * | session, |
| entity_t * | entity, | ||
| char ** | text ) |
Read an XML entity tree from the manager.
| [in] | session | Pointer to GNUTLS session. |
| [out] | entity | Pointer to an entity tree. |
| [out] | text | A pointer to a pointer, at which to store the address of a newly allocated string holding the text read from the session, if the text is required, else NULL. |
| int read_entity_and_text_c | ( | gvm_connection_t * | connection, |
| entity_t * | entity, | ||
| char ** | text ) |
Read an XML entity tree from the manager.
| [in] | connection | Connection. |
| [out] | entity | Entity tree. |
| [out] | text | A pointer to a pointer, at which to store the address of a newly allocated string holding the text read from the session, if the text is required, else NULL. |
| int read_entity_c | ( | gvm_connection_t * | connection, |
| entity_t * | entity ) |
Read an XML entity tree from the manager.
| [in] | connection | Connection. |
| [out] | entity | Pointer to an entity tree. |
| int read_entity_s | ( | int | socket, |
| entity_t * | entity ) |
Read an XML entity tree from the socket.
| [in] | socket | Socket to read from. |
| [out] | entity | Pointer to an entity tree. |
| int read_string | ( | gnutls_session_t * | session, |
| GString ** | string ) |
Read entity and text. Free the entity immediately.
| [in] | session | Pointer to GNUTLS session to read from. |
| [out] | string | Return location for the string. |
| int read_string_c | ( | gvm_connection_t * | connection, |
| GString ** | string ) |
Read entity and text. Free the entity immediately.
| [in] | connection | Connection. |
| [out] | string | Return location for the string. |
| int read_text_c | ( | gvm_connection_t * | connection, |
| char ** | text ) |
Read text from the server.
| [in] | connection | Connection. |
| [out] | text | A pointer to a pointer, at which to store the address of a newly allocated string holding the text read from the session. |
| int try_read_entity | ( | gnutls_session_t * | session, |
| int | timeout, | ||
| entity_t * | entity ) |
Try read an XML entity tree from the manager.
| [in] | session | Pointer to GNUTLS session. |
| [in] | timeout | Server idle time before giving up, in seconds. 0 to wait forever. |
| [out] | entity | Pointer to an entity tree. |
| int try_read_entity_and_string | ( | gnutls_session_t * | session, |
| int | timeout, | ||
| entity_t * | entity, | ||
| GString ** | string_return ) |
Try read an XML entity tree from the manager.
| [in] | session | Pointer to GNUTLS session. |
| [in] | timeout | Server idle time before giving up, in seconds. 0 to wait forever. |
| [out] | entity | Pointer to an entity tree. |
| [out] | string_return | An optional return location for the text read from the session. If NULL then it simply remains NULL. If a pointer to NULL then it points to a freshly allocated GString on successful return. Otherwise it points to an existing GString onto which the text is appended. |
| int try_read_entity_c | ( | gvm_connection_t * | connection, |
| int | timeout, | ||
| entity_t * | entity ) |
Try read an XML entity tree from the manager.
| [in] | connection | Connection. |
| [in] | timeout | Server idle time before giving up, in seconds. 0 to wait forever. |
| [out] | entity | Pointer to an entity tree. |
| int xml_count_entities | ( | entities_t | entities | ) |
Count the number of entities.
| [in] | entities | Entities. |
| void xml_file_iterator_free | ( | xml_file_iterator_t | iterator | ) |
Frees an XML file iterator and all of its internal data structures.
| [in] | iterator | The XML file iterator to free. |
| int xml_file_iterator_init_from_file_path | ( | xml_file_iterator_t | iterator, |
| const char * | file_path, | ||
| int | output_depth ) |
Initializes an XML file iterator to read from a given path.
| [in] | iterator | Pointer to the iterator to initialize. |
| [in] | file_path | Path to the file to read from. |
| [in] | output_depth | XML tree depth at which to return elements. |
| xml_file_iterator_t xml_file_iterator_new | ( | void | ) |
Allocates a new, uninitialized XML file iterator.
Free with xml_file_iterator_free.
| element_t xml_file_iterator_next | ( | xml_file_iterator_t | iterator, |
| gchar ** | error ) |
Get the next subelement from a XML file iterator.
| [in] | iterator | The XML file iterator to get the element from. |
| [out] | error | Error message output, set to NULL on success / EOF |
| int xml_file_iterator_rewind | ( | xml_file_iterator_t | iterator | ) |
Rewinds an XML file iterator by rewinding the file and creating a new XML parser context.
| [in] | iterator | The XML file iterator to rewind. |
| void xml_handle_end_element | ( | context_data_t * | context, |
| const gchar * | element_name ) |
Handle the end of an XML element.
| [in] | context | Parser context. |
| [in] | element_name | XML element name. |
| void xml_handle_start_element | ( | context_data_t * | context, |
| const gchar * | element_name, | ||
| const gchar ** | attribute_names, | ||
| const gchar ** | attribute_values ) |
Handle the start of an OMP XML element.
| [in] | context | Parser context. |
| [in] | element_name | XML element name. |
| [in] | attribute_names | XML attribute name. |
| [in] | attribute_values | XML attribute values. |
| void xml_handle_text | ( | context_data_t * | context, |
| const gchar * | text, | ||
| gsize | text_len ) |
Handle additional text of an XML element.
| [in] | context | Parser context. |
| [in] | text | The text. |
| [in] | text_len | Length of the text. |
| void xml_string_append | ( | GString * | xml, |
| const char * | format, | ||
| ... ) |
Append formatted escaped XML to a string.
| [in] | xml | XML string. |
| [in] | format | Format string. |
| [in] | ... | Arguments for format string. |