globus_rsl.h(3)

globus_rsl.h 💖

okay bestie, welcome to the Library Functions Manual page for globus_rsl.h — yes it's the Globus RSL Parsing header, and yes it's lowkey a whole vibe. RSL stands for Resource Specification Language btw, iykyk. let's get into it 🦋

---

✨ NAME ✨

globus_rsl.h — Globus RSL Parsing. that's it, that's the name, she's simple and she's iconic 💅

---

✨ SYNOPSIS ✨

#include 'globus_module.h'
#include 'globus_list.h'
#include 'globus_symboltable.h'
#include 'globus_hashtable.h'

🎀 Functions 🎀

• int globus_rsl_is_relation (globus_rsl_t *ast) — RSL relation test. is this thing a relation? asking for a friend.
• int globus_rsl_is_boolean (globus_rsl_t *ast) — RSL boolean test. boolean check, no cap.
• int globus_rsl_is_relation_eq (globus_rsl_t *ast) — RSL equality operation test. is it giving ==?
• int globus_rsl_is_relation_lessthan (globus_rsl_t *ast) — RSL less than operation test. is it giving <?
• int globus_rsl_is_relation_attribute_equal (globus_rsl_t *ast, char *attribute) — RSL attribute name test. does this attribute name match? 👀
• int globus_rsl_is_boolean_and (globus_rsl_t *ast) — RSL boolean and test. and energy.
• int globus_rsl_is_boolean_or (globus_rsl_t *ast) — RSL boolean or test. or energy.
• int globus_rsl_is_boolean_multi (globus_rsl_t *ast) — RSL boolean multi test. multi boolean, she contains multitudes.
• int globus_rsl_value_is_literal (globus_rsl_value_t *ast) — RSL literal string test.
• int globus_rsl_value_is_sequence (globus_rsl_value_t *ast) — RSL value sequence test.
• int globus_rsl_value_is_variable (globus_rsl_value_t *ast) — RSL value variable test.
• int globus_rsl_value_is_concatenation (globus_rsl_value_t *ast) — RSL value concatenation test.
• globus_rsl_t * globus_rsl_make_boolean (int my_operator, globus_list_t *children) — RSL boolean constructor. build urself a boolean bestie ✨
• globus_rsl_t * globus_rsl_make_relation (int my_operator, char *attributename, globus_rsl_value_t *value_sequence) — RSL relation constructor.
• globus_rsl_value_t * globus_rsl_value_make_literal (char *string) — RSL literal constructor.
• globus_rsl_value_t * globus_rsl_value_make_sequence (globus_list_t *value_list) — RSL value sequence constructor.
• globus_rsl_value_t * globus_rsl_value_make_variable (globus_rsl_value_t *sequence) — RSL variable reference constructor.
• globus_rsl_value_t * globus_rsl_value_make_concatenation (globus_rsl_value_t *left_value, globus_rsl_value_t *right_value) — RSL concatenation constructor.
• globus_rsl_t * globus_rsl_copy_recursive (globus_rsl_t *globus_rsl_ptr) — Create a deep copy of an RSL syntax tree. deep copy = the whole entire tree, not just the vibes.
• globus_rsl_value_t * globus_rsl_value_copy_recursive (globus_rsl_value_t *globus_rsl_value_ptr) — Create a deep copy of an RSL value.
• int globus_rsl_boolean_get_operator (globus_rsl_t *ast_node) — Get the RSL operator used in a boolean RSL composition.
• globus_list_t * globus_rsl_boolean_get_operand_list (globus_rsl_t *ast_node) — Get the RSL operand list from a boolean RSL composition.
• globus_list_t ** globus_rsl_boolean_get_operand_list_ref (globus_rsl_t *boolean_node) — Get a reference to the RSL operand list from a boolean RSL composition. a reference, ok, so she's pointing at the real thing.
• char * globus_rsl_relation_get_attribute (globus_rsl_t *ast_node) — Get an RSL relation attribute name.
• int globus_rsl_relation_get_operator (globus_rsl_t *ast_node) — Get an RSL relation operator.
• globus_rsl_value_t * globus_rsl_relation_get_value_sequence (globus_rsl_t *ast_node) — Get the value of an RSL relation.
• globus_rsl_value_t * globus_rsl_relation_get_single_value (globus_rsl_t *ast_node) — Get the single value of an RSL relation.
• char * globus_rsl_value_literal_get_string (globus_rsl_value_t *literal_node) — Get the string value of an RSL literal.
• globus_list_t * globus_rsl_value_sequence_get_value_list (globus_rsl_value_t *sequence_node) — Get the value list from an RSL value sequence.
• globus_rsl_value_t * globus_rsl_value_variable_get_sequence (globus_rsl_value_t *variable_node) — Get the value sequence from an RSL variable reference.
• char * globus_rsl_value_variable_get_name (globus_rsl_value_t *variable_node) — Get the name of an RSL variable reference.
• char * globus_rsl_value_variable_get_default (globus_rsl_value_t *variable_node) — Get the default value of an RSL variable reference.
• globus_rsl_value_t * globus_rsl_value_concatenation_get_left (globus_rsl_value_t *concatenation_node) — Get the left side of a concatenation value.
• globus_rsl_value_t * globus_rsl_value_concatenation_get_right (globus_rsl_value_t *concatenation_node) — Get the right side of a concatenation value.
• globus_list_t ** globus_rsl_value_sequence_get_list_ref (globus_rsl_value_t *sequence_node) — Get a reference to the list of values in a sequence.
• int globus_rsl_value_concatenation_set_left (globus_rsl_value_t *concatenate_node, globus_rsl_value_t *new_left_node) — Set the left-hand value of a concatenation.
• int globus_rsl_value_concatenation_set_right (globus_rsl_value_t *concatenate_node, globus_rsl_value_t *new_right_node) — Set the right-hand value of a concatenation.
• int globus_rsl_value_eval (globus_rsl_value_t *ast_node, globus_symboltable_t *symbol_table, char **string_value, int rsl_substitute_flag) — Evaluate RSL substitions in an RSL value node.
• int globus_rsl_eval (globus_rsl_t *ast_node, globus_symboltable_t *symbol_table) — Evaluate an RSL syntax tree.
• int globus_rsl_value_free (globus_rsl_value_t *val) — Free an RSL value node.
• int globus_rsl_free (globus_rsl_t *ast_node) — Free an RSL syntax tree node.
• int globus_rsl_value_free_recursive (globus_rsl_value_t *globus_rsl_value_ptr) — Free an RSL value and all its child nodes. yes, ALL of them.
• int globus_rsl_free_recursive (globus_rsl_t *ast_node) — Free an RSL syntax tree and all its child nodes.
• int globus_rsl_value_print_recursive (globus_rsl_value_t *globus_rsl_value_ptr) — Print the value of a globus_rsl_value_t to standard output.
• int globus_rsl_print_recursive (globus_rsl_t *ast_node) — Print the value of an RSL syntax tree to standard output.
• int globus_rsl_value_variable_get_size (globus_rsl_value_t *variable_node) — Get the size of the value list within an RSL variable reference node.
• globus_list_t * globus_list_copy_reverse (globus_list_t *orig) — Create a reverse-order copy of a list. backwards but make it fashion 💅
• int globus_rsl_value_list_literal_replace (globus_list_t *value_list, char *string_value) — Replace the first value in a value list with a literal.
• int globus_rsl_value_list_param_get (globus_list_t *ast_node_list, int required_type, char ***value, int *value_ctr) — Get the values of an RSL value list.
• int globus_rsl_param_get (globus_rsl_t *ast_node, int required_type, char *param, char ***values) — Get the value strings for an RSL attribute.
• globus_list_t * globus_rsl_param_get_values (globus_rsl_t *ast_node, char *param) — Get the list of values for an RSL attribute.
• globus_rsl_t * globus_rsl_parse (char *rsl_spec) — Parse an RSL string.
• char * globus_rsl_unparse (globus_rsl_t *rsl_spec) — Convert an RSL parse tree to a string.
• char * globus_rsl_value_unparse (globus_rsl_value_t *rsl_value) — Convert an RSL value pointer to a string.

---

💜 Detailed Description 💜

Globus RSL Parsing. that's the whole description bestie, she's mysterious, she's giving main character energy 🌈

---

🌸 Function Documentation 🌸

globus_rsl_t * globus_rsl_parse (char * buf)

Parse an RSL string. the globus_rsl_parse() function parses the string pointed to by the buf parameter into an RSL syntax tree.

⚠️ heads up bestie: the caller is responsible for freeing that tree by calling globus_rsl_free_recursive(). don't just walk away from her, that's rude and also a memory leak 😭

Parameters

• buf — A NULL-terminated string that contains an RSL relation or boolean composition.

Returns

Upon success, the globus_rsl_parse() function returns the parse tree generated by processing its input. If an error occurs, globus_rsl_parse() returns NULL. not me getting NULL back and pretending I'm fine 🙈

---

👑 Author 👑

Generated automatically by Doxygen for globus_rsl from the source code. doxygen really said "I'll write it myself" and honestly? ate. ✨

---

and that's the page, bestie!! this was globus_rsl Version 11.4, straight from the globus_rsl library, and you just read the whole entire thing like the academic weapon you are 💖🎀🦋 go free your syntax trees (recursively!!) and slay the day, mwah 💅