Man page - globus_url_parse(3)
Packages contains this manual
- globus_logging.h(3)
- globus_debug.h(3)
- globus_hashtable_copy_func_t(3)
- globus_symboltable.h(3)
- globus_list_first(3)
- globus_handle_table_increment_reference_by(3)
- globus_thread_key_destructor_func_t(3)
- globus_callback_space_register_signal_handler(3)
- globus_list_empty(3)
- globus_hashtable_voidp_hash(3)
- globus_priority_q_init(3)
- globus_error_initialize_errno_error(3)
- globus_callback_api(3)
- globus_callback_error_type_t(3)
- globus_error_match(3)
- globus_cond(3)
- globus_handle_table_t(3)
- globus_module(3)
- globus_list_search(3)
- globus_fifo(3)
- globus_errno_error_accessor(3)
- globus_hashtable_next(3)
- globus_thread_exit(3)
- globus_rmutex_unlock(3)
- globus_uuid_import(3)
- globus_hashtable_last(3)
- globus_callback_spaces(3)
- globus_condattr_setspace(3)
- globus_hashtable_empty(3)
- globus_list_cons(3)
- globus_errno_error_object(3)
- globus_extension_lookup(3)
- globus_callback_signal(3)
- globus_cond_timedwait(3)
- globus_priority_q_destroy(3)
- globus_error_print_chain(3)
- globus_signal_poll(3)
- globus_mutex_trylock(3)
- globus_callback_signal_poll(3)
- globus_url_copy(3)
- globus_error_get_long_desc(3)
- globus_hashtable_hash_func_t(3)
- globus_mutexattr_init(3)
- globus_abstime_cmp(3)
- globus_memory_push_node(3)
- globus_memory_destroy(3)
- globus_priority_q_enqueue(3)
- globus_print.h(3)
- globus_condattr_getspace(3)
- globus_thread_sigmask(3)
- globus_thread_t(3)
- globus_error_api(3)
- globus_memory_init(3)
- globus_thread_key_t(3)
- globus_url_parse_rfc1738(3)
- globus_fifo_copy(3)
- globus_callback_space_destroy(3)
- globus_priority_q_modify(3)
- globus_callback_unregister_signal_handler(3)
- globus_uuid(3)
- globus_callback_get_timeout(3)
- globus_fifo_destroy_all(3)
- globus_version_print(3)
- globus_error_errno_search(3)
- globus_tilde_expand.h(3)
- globus_errno_error_api(3)
- globus_list_min(3)
- globus_time.h(3)
- globus_module_deactivate(3)
- globus_list_size(3)
- globus_priority_q(3)
- globus_handle_table_lookup(3)
- globus_error_construct_string(3)
- globus_fifo_move(3)
- globus_handle_t(3)
- globus_error_set_type(3)
- globus_list.h(3)
- globus_thread_once(3)
- globus_error_set_long_desc(3)
- globus_fifo_t(3)
- globus_thread_key_create(3)
- globus_error_set_source(3)
- globus_list_sort(3)
- globus_thread_setspecific(3)
- globus_callback_adjust_oneshot(3)
- globus_list_rest(3)
- globus_error_wrap_errno_error(3)
- globus_url.h(3)
- globus_condattr_init(3)
- globus_options.h(3)
- globus_uuid_create(3)
- globus_priority_q_size(3)
- globus_callback_space_get(3)
- globus_common.h(3)
- globus_thread_pool(3)
- globus_threadattr_t(3)
- globus_poll_nonblocking(3)
- globus_list_pred_t(3)
- globus_error_set_short_desc(3)
- globus_rmutexattr_t(3)
- globus_thread.h(3)
- globus_list_copy(3)
- globus_time_reltime_is_infinity(3)
- globus_thread_kill(3)
- globus_callback_space_behavior_t(3)
- globus_thread_cancellable_func(3)
- globus_hashtable_insert(3)
- globus_callback_adjust_period(3)
- globus_priority_q.h(3)
- globus_thread_setcancelstate(3)
- globus_hashtable_to_list(3)
- globus_error_errno_set_errno(3)
- globus_error_get_cause(3)
- globus_generic_error_accessor(3)
- globus_libc_join(3)
- globus_hashtable_string_keyeq(3)
- globus_list_search_pred(3)
- globus_url_destroy(3)
- globus_callback_space_attr_init(3)
- globus_error_get_short_desc(3)
- globus_fifo.h(3)
- globus_condattr_destroy(3)
- globus_priority_q_first_priority(3)
- globus_callback_space_register_oneshot(3)
- globus_fifo_size(3)
- globus_memory.h(3)
- globus_list(3)
- globus_args.h(3)
- globus_priority_q_cmp_func_t(3)
- globus_mutexattr_t(3)
- globus_hashtable(3)
- globus_cond_wait(3)
- globus_error_generic.h(3)
- globus_hashtable_remove(3)
- globus_thread(3)
- globus_error_set_cause(3)
- globus_url_t(3)
- globus_url_get_scheme(3)
- globus_error_construct_errno_error(3)
- globus_error_get_source(3)
- globus_callback_space_attr_set_behavior(3)
- globus_common_include.h(3)
- globus_callback_space_register_periodic(3)
- globus_strptime.h(3)
- globus_thread_create(3)
- globus_error_construct_multiple(3)
- globus_handle_table(3)
- globus_error_errno.h(3)
- globus_mutex_unlock(3)
- globus_thread_preemptive_threads(3)
- globus_thread_cancel(3)
- globus_mutex_t(3)
- globus_error_initialize_error(3)
- globus_extension_register_builtin(3)
- globus_module_activate_array(3)
- globus_list_t(3)
- globus_url(3)
- globus_callback_func_t(3)
- globus_priority_q_empty(3)
- globus_mutex_destroy(3)
- globus_callback_space_poll(3)
- globus_extension_activate(3)
- globus_url_parse(3)
- globus_byte_t(3)
- globus_hashtable_voidp_keyeq(3)
- globus_error_errno_match(3)
- globus_module_get_version(3)
- globus_fifo_init(3)
- globus_tilde_expand(3)
- globus_i_am_only_thread(3)
- globus_handle_table_increment_reference(3)
- globus_priority_q_first(3)
- globus_uuid_fields(3)
- globus_thread_testcancel(3)
- globus_fifo_enqueue(3)
- globus_hashtable_destructor_func_t(3)
- globus_error_errno_get_errno(3)
- globus_thread_self(3)
- globus_thread_once_t(3)
- globus_module_deactivate_proxy_cb_t(3)
- globus_bool_t(3)
- globus_url_scheme_t(3)
- globus_error_multiple_remove_chain(3)
- globus_fifo_tail_peek(3)
- globus_poll_blocking(3)
- globus_error_mutliple_add_chain(3)
- globus_thread_key_delete(3)
- globus_rmutex_init(3)
- globus_libc.h(3)
- globus_object_cache.h(3)
- globus_fifo_peek(3)
- globus_fifo_convert_to_list(3)
- globus_mutex_init(3)
- globus_hashtable_iterators(3)
- globus_thread_yield(3)
- globus_list_free(3)
- globus_callback_has_time_expired(3)
- globus_poll(3)
- globus_list_insert(3)
- globus_error.h(3)
- globus_generic_error_api(3)
- globus_priority_q_s(3)
- globus_callback(3)
- globus_common(3)
- globus_priority_q_t(3)
- globus_callback_poll(3)
- globus_error_get_type(3)
- globus_hashtable_size(3)
- globus_handle_destructor_t(3)
- globus_priority_q_remove(3)
- globus_fifo_remove(3)
- globus_mutex_lock(3)
- globus_error_v_construct_error(3)
- globus_handle_table_decrement_reference(3)
- globus_module.h(3)
- globus_module_descriptor_s(3)
- globus_memory(3)
- globus_result_t(3)
- globus_callback_space_attr_destroy(3)
- globus_hashtable_destroy(3)
- globus_callback_was_restarted(3)
- globus_priority_q_dequeue(3)
- globus_error_print_friendly_t(3)
- globus_handle_table_init(3)
- globus_hashtable_int_hash(3)
- globus_thread_rmutex.h(3)
- globus_cond_broadcast(3)
- globus_module_activate(3)
- globus_module_setenv(3)
- globus_callback_space_reference(3)
- globus_callback_unregister(3)
- globus_hashtable_int_keyeq(3)
- globus_rmutex_t(3)
- globus_callback_register_signal_handler(3)
- globus_size_t(3)
- globus_condattr_t(3)
- globus_config.h(3)
- globus_module_activate_proxy(3)
- globus_types.h(3)
- globus_memory_pop_node(3)
- globus_fifo_destroy(3)
- globus_callback_space_attr_get_behavior(3)
- globus_time_abstime_is_infinity(3)
- globus_callback_add_wakeup_handler(3)
- globus_hashtable_update(3)
- globus_callback_register_periodic(3)
- globus_module_print_version(3)
- globus_list_relation_t(3)
- globus_mutexattr_destroy(3)
- globus_handle_table_destroy(3)
- globus_extension.h(3)
- globus_callback_space_attr_t(3)
- globus_cond_signal(3)
- globus_libc_contact_string_to_ints(3)
- globus_hashtable_lookup(3)
- globus_error_construct_error(3)
- globus_reltime_cmp(3)
- globus_hashtable_keyeq_func_t(3)
- globus_error_string.h(3)
- globus_url_parse_loose(3)
- globus_callback_space_get_depth(3)
- globus_hashtable_string_hash(3)
- globus_hashtable_first(3)
- globus_states.h(3)
- globus_rmutex_destroy(3)
- globus_callback_handle_t(3)
- globus_callback.h(3)
- globus_handle_table.h(3)
- globus_callback_space_init(3)
- globus_thread_getspecific(3)
- globus_cond_t(3)
- globus_generic_error_utility(3)
- globus_hashtable_prev(3)
- globus_cond_init(3)
- globus_errno_error_utility(3)
- globus_callback_space_t(3)
- globus_thread_common.h(3)
- globus_uuid.h(3)
- globus_time_has_expired(3)
- globus_module_get_module_pointer(3)
- globus_thread_key(3)
- globus_rmutex_lock(3)
- globus_logging_update_pid(3)
- globus_eval_path(3)
- globus_callback_register_oneshot(3)
- globus_generic_error_object(3)
- globus_range_list.h(3)
- globus_hashtable.h(3)
- globus_fifo_dequeue(3)
- globus_list_replace_first(3)
- globus_callback_space_is_single(3)
- globus_release.h(3)
- globus_handle_table_insert(3)
- globus_thread_set_model(3)
- globus_error_print_friendly(3)
- globus_mutex(3)
- globus_thread_equal(3)
- globus_cond_destroy(3)
- globus_module_getenv(3)
- globus_module_print_activated_versions(3)
- globus_thread_pool.h(3)
- globus_socklen_t(3)
- globus_list_remove(3)
- globus_fifo_empty(3)
- globus_hashtable_init(3)
apt-get install libglobus-common-doc
Manual
globus_url
NAMESYNOPSIS
Data Structures
Enumerations
Functions
Detailed Description
Enumeration Type Documentation
enum globus_url_scheme_t
Function Documentation
int globus_url_copy (globus_url_t * dst, const globus_url_t * src)
int globus_url_destroy (globus_url_t * url)
int globus_url_get_scheme (const char * url_string, globus_url_scheme_t *scheme_type)
int globus_url_parse (const char * url_string, globus_url_t * url)
int globus_url_parse_loose (const char * url_string, globus_url_t * url)
int globus_url_parse_rfc1738 (const char * url_string, globus_url_t * url)
Author
NAME
globus_url - URL String Parser
- URL String Parser.
SYNOPSIS
Data Structures
struct
globus_url_t
Parsed URLs.
Enumerations
enum
globus_url_scheme_t
{
GLOBUS_URL_SCHEME_FTP
=0,
GLOBUS_URL_SCHEME_GSIFTP
,
GLOBUS_URL_SCHEME_HTTP
,
GLOBUS_URL_SCHEME_HTTPS
,
GLOBUS_URL_SCHEME_LDAP
,
GLOBUS_URL_SCHEME_FILE
,
GLOBUS_URL_SCHEME_X_NEXUS
,
GLOBUS_URL_SCHEME_X_GASS_CACHE
,
GLOBUS_URL_SCHEME_UNKNOWN
,
GLOBUS_URL_SCHEME_SSHFTP
,
GLOBUS_URL_NUM_SCHEMES
}
URL Schemes.
Functions
int
globus_url_parse
(const char *url_string,
globus_url_t
*url)
int
globus_url_parse_rfc1738
(const char *url_string,
globus_url_t
*url)
int
globus_url_parse_loose
(const char *url_string,
globus_url_t
*url)
int
globus_url_destroy
(
globus_url_t
*url)
int
globus_url_get_scheme
(const char *url_string,
globus_url_scheme_t
*scheme_type)
int
globus_url_copy
(
globus_url_t
*dst, const
globus_url_t
*src)
Detailed Description
URL String Parser.
The Globus URL functions provide a simple mechanism for parsing a URL string into a data structure, and for determining the scheme of an URL string.
Enumeration Type Documentation
enum globus_url_scheme_t
URL Schemes. The Globus URL library supports a set of URL schemes (protocols). This enumeration can be used to quickly dispatch a parsed URL based on a constant value.
See also
globus_url_t::scheme_type
Enumerator
GLOBUS_URL_SCHEME_FTP
File Transfer Protocol
GLOBUS_URL_SCHEME_GSIFTP
GSI-enhanced File Transfer Protocol
GLOBUS_URL_SCHEME_HTTP
HyperText Transfer Protocol
GLOBUS_URL_SCHEME_HTTPS
Secure HyperText Transfer Protocol
GLOBUS_URL_SCHEME_LDAP
Lightweight Directory Access Protocol
GLOBUS_URL_SCHEME_FILE
File Location
GLOBUS_URL_SCHEME_X_NEXUS
Nexus endpoint
GLOBUS_URL_SCHEME_X_GASS_CACHE
GASS Cache Entry
GLOBUS_URL_SCHEME_UNKNOWN
Any other URL of the form scheme :// something
GLOBUS_URL_NUM_SCHEMES
Total number of URL schemes supported
Function Documentation
int globus_url_copy (globus_url_t * dst, const globus_url_t * src)
Create a copy of an URL structure.
This function copies the contents of a url structure into another.
Parameters
dst
The URL structure to
be populated with a copy of the contents of src.
src
The original URL.
Return values
GLOBUS_SUCCESS
The URL
was successfully copied.
GLOBUS_URL_ERROR_NULL_URL
One of the URLs was
GLOBUS_NULL.
GLOBUS_URL_ERROR_OUT_OF_MEMORY;
The library was unable
to allocate memory to create the the
globus_url_t
contents.
int globus_url_destroy (globus_url_t * url)
Destroy a globus_url_t structure.
This function frees all memory associated with a globus_url_t structure.
Parameters
url The url structure to destroy
Return values
GLOBUS_SUCCESS The URL was successfully destroyed.
int globus_url_get_scheme (const char * url_string, globus_url_scheme_t *scheme_type)
Get the scheme of an URL.
This function determines the scheme type of the url string, and populates the variable pointed to by second parameter with that value. This performs a less expensive parsing than globus_url_parse() and is suitable for applications which need only to choose a handler based on the URL scheme.
Parameters
url_string
The string
containing the URL.
scheme_type
A pointer to a globus_url_scheme_t which
will be set to the scheme.
Return values
GLOBUS_SUCCESS
The URL
scheme was recognized, and scheme_type has been updated.
GLOBUS_URL_ERROR_BAD_SCHEME
The URL scheme was not
recognized.
int globus_url_parse (const char * url_string, globus_url_t * url)
Parse a string containing a URL into a globus_url_t
Parameters
url_string
String to
parse
url
Pointer to
globus_url_t
to be filled with the
fields of the url
Return values
GLOBUS_SUCCESS
The
string was successfully parsed.
GLOBUS_URL_ERROR_NULL_STRING
The url_string was
GLOBUS_NULL.
GLOBUS_URL_ERROR_NULL_URL
The URL pointer was
GLOBUS_NULL.
GLOBUS_URL_ERROR_BAD_SCHEME
The URL scheme (protocol)
contained invalid characters.
GLOBUS_URL_ERROR_BAD_USER
The user part of the URL
contained invalid characters.
GLOBUS_URL_ERROR_BAD_PASSWORD
The password part of the
URL contained invalid characters.
GLOBUS_URL_ERROR_BAD_HOST
The host part of the URL
contained invalid characters.
GLOBUS_URL_ERROR_BAD_PORT
The port part of the URL
contained invalid characters.
GLOBUS_URL_ERROR_BAD_PATH
The path part of the URL
contained invalid characters.
GLOBUS_URL_ERROR_BAD_DN
-9 The DN part of an LDAP URL
contained invalid characters.
GLOBUS_URL_ERROR_BAD_ATTRIBUTES
-10 The attributes part
of an LDAP URL contained invalid characters.
GLOBUS_URL_ERROR_BAD_SCOPE
-11 The scope part of an LDAP
URL contained invalid characters.
GLOBUS_URL_ERROR_BAD_FILTER
-12 The filter part of an
LDAP URL contained invalid characters.
GLOBUS_URL_ERROR_OUT_OF_MEMORY
-13 The library was
unable to allocate memory to create the the
globus_url_t
contents.
GLOBUS_URL_ERROR_INTERNAL_ERROR
-14 Some unexpected
error occurred parsing the URL.
int globus_url_parse_loose (const char * url_string, globus_url_t * url)
Parse a string containing a URL into a globus_url_t Looser restrictions on characters allowed in the path part of the URL.
Parameters
url_string
String to
parse
url
Pointer to
globus_url_t
to be filled with the
fields of the url
Return values
GLOBUS_SUCCESS
The
string was successfully parsed.
GLOBUS_URL_ERROR_NULL_STRING
The url_string was
GLOBUS_NULL.
GLOBUS_URL_ERROR_NULL_URL
The URL pointer was
GLOBUS_NULL.
GLOBUS_URL_ERROR_BAD_SCHEME
The URL scheme (protocol)
contained invalid characters.
GLOBUS_URL_ERROR_BAD_USER
The user part of the URL
contained invalid characters.
GLOBUS_URL_ERROR_BAD_PASSWORD
The password part of the
URL contained invalid characters.
GLOBUS_URL_ERROR_BAD_HOST
The host part of the URL
contained invalid characters.
GLOBUS_URL_ERROR_BAD_PORT
The port part of the URL
contained invalid characters.
GLOBUS_URL_ERROR_BAD_PATH
The path part of the URL
contained invalid characters.
GLOBUS_URL_ERROR_BAD_DN
-9 The DN part of an LDAP URL
contained invalid characters.
GLOBUS_URL_ERROR_BAD_ATTRIBUTES
-10 The attributes part
of an LDAP URL contained invalid characters.
GLOBUS_URL_ERROR_BAD_SCOPE
-11 The scope part of an LDAP
URL contained invalid characters.
GLOBUS_URL_ERROR_BAD_FILTER
-12 The filter part of an
LDAP URL contained invalid characters.
GLOBUS_URL_ERROR_OUT_OF_MEMORY
-13 The library was
unable to allocate memory to create the the
globus_url_t
contents.
GLOBUS_URL_ERROR_INTERNAL_ERROR
-14 Some unexpected
error occurred parsing the URL.
int globus_url_parse_rfc1738 (const char * url_string, globus_url_t * url)
Parse a string containing a URL into a globus_url_t
Parameters
url_string
String to
parse
url
Pointer to
globus_url_t
to be filled with the
fields of the url
Return values
GLOBUS_SUCCESS
The
string was successfully parsed.
GLOBUS_URL_ERROR_NULL_STRING
The url_string was
GLOBUS_NULL.
GLOBUS_URL_ERROR_NULL_URL
The URL pointer was
GLOBUS_NULL.
GLOBUS_URL_ERROR_BAD_SCHEME
The URL scheme (protocol)
contained invalid characters.
GLOBUS_URL_ERROR_BAD_USER
The user part of the URL
contained invalid characters.
GLOBUS_URL_ERROR_BAD_PASSWORD
The password part of the
URL contained invalid characters.
GLOBUS_URL_ERROR_BAD_HOST
The host part of the URL
contained invalid characters.
GLOBUS_URL_ERROR_BAD_PORT
The port part of the URL
contained invalid characters.
GLOBUS_URL_ERROR_BAD_PATH
The path part of the URL
contained invalid characters.
GLOBUS_URL_ERROR_BAD_DN
-9 The DN part of an LDAP URL
contained invalid characters.
GLOBUS_URL_ERROR_BAD_ATTRIBUTES
-10 The attributes part
of an LDAP URL contained invalid characters.
GLOBUS_URL_ERROR_BAD_SCOPE
-11 The scope part of an LDAP
URL contained invalid characters.
GLOBUS_URL_ERROR_BAD_FILTER
-12 The filter part of an
LDAP URL contained invalid characters.
GLOBUS_URL_ERROR_OUT_OF_MEMORY
-13 The library was
unable to allocate memory to create the the
globus_url_t
contents.
GLOBUS_URL_ERROR_INTERNAL_ERROR
-14 Some unexpected
error occurred parsing the URL.
Author
Generated automatically by Doxygen for globus_common from the source code.