| D-Bus
    1.12.10
    | 
Parsing addresses of D-Bus servers. More...
| Typedefs | |
| typedef struct DBusAddressEntry | DBusAddressEntry | 
| Opaque type representing one of the semicolon-separated items in an address. | |
| Functions | |
| void | dbus_address_entries_free (DBusAddressEntry **entries) | 
| Frees a NULL-terminated array of address entries.  More... | |
| const char * | dbus_address_entry_get_method (DBusAddressEntry *entry) | 
| Returns the method string of an address entry.  More... | |
| const char * | dbus_address_entry_get_value (DBusAddressEntry *entry, const char *key) | 
| Returns a value from a key of an entry.  More... | |
| dbus_bool_t | dbus_parse_address (const char *address, DBusAddressEntry ***entry_result, int *array_len, DBusError *error) | 
| Parses an address string of the form:  More... | |
| char * | dbus_address_escape_value (const char *value) | 
| Escapes the given string as a value in a key=value pair for a D-Bus address.  More... | |
| char * | dbus_address_unescape_value (const char *value, DBusError *error) | 
| Unescapes the given string as a value in a key=value pair for a D-Bus address.  More... | |
Parsing addresses of D-Bus servers.
| DBUS_EXPORT void dbus_address_entries_free | ( | DBusAddressEntry ** | entries | ) | 
Frees a NULL-terminated array of address entries.
| entries | the array. | 
Definition at line 189 of file dbus-address.c.
References dbus_free(), and NULL.
| DBUS_EXPORT const char * dbus_address_entry_get_method | ( | DBusAddressEntry * | entry | ) | 
Returns the method string of an address entry.
For example, given the address entry "tcp:host=example.com" it would return the string "tcp"
| entry | the entry. | 
Definition at line 227 of file dbus-address.c.
References DBusAddressEntry::method.
Referenced by _dbus_server_listen_platform_specific(), _dbus_server_listen_socket(), _dbus_transport_open_platform_specific(), and _dbus_transport_open_socket().
| DBUS_EXPORT const char * dbus_address_entry_get_value | ( | DBusAddressEntry * | entry, | 
| const char * | key | ||
| ) | 
Returns a value from a key of an entry.
For example, given the address "tcp:host=example.com,port=8073" if you asked for the key "host" you would get the value "example.com"
The returned value is already unescaped.
| entry | the entry. | 
| key | the key. | 
Definition at line 244 of file dbus-address.c.
References _dbus_assert, _dbus_list_get_first_link(), _dbus_list_get_next_link, _dbus_string_equal_c_str(), DBusList::data, DBusAddressEntry::keys, NULL, and DBusAddressEntry::values.
Referenced by _dbus_server_listen_platform_specific(), _dbus_server_listen_socket(), _dbus_transport_open(), _dbus_transport_open_platform_specific(), and _dbus_transport_open_socket().
| DBUS_EXPORT char * dbus_address_escape_value | ( | const char * | value | ) | 
Escapes the given string as a value in a key=value pair for a D-Bus address.
| value | the unescaped value | 
Definition at line 583 of file dbus-address.c.
References _dbus_address_append_escaped(), _dbus_string_free(), _dbus_string_init(), _dbus_string_init_const(), _dbus_string_steal_data(), and NULL.
| DBUS_EXPORT char * dbus_address_unescape_value | ( | const char * | value, | 
| DBusError * | error | ||
| ) | 
Unescapes the given string as a value in a key=value pair for a D-Bus address.
Note that dbus_address_entry_get_value() returns an already-unescaped value.
| value | the escaped value | 
| error | error to set if the unescaping fails | 
Definition at line 617 of file dbus-address.c.
References _dbus_string_init(), _dbus_string_init_const(), and NULL.
| DBUS_EXPORT dbus_bool_t dbus_parse_address | ( | const char * | address, | 
| DBusAddressEntry *** | entry_result, | ||
| int * | array_len, | ||
| DBusError * | error | ||
| ) | 
Parses an address string of the form:
method:key=value,key=value;method:key=value
See the D-Bus specification for complete docs on the format.
When connecting to an address, the first address entries in the semicolon-separated list should be tried first.
| address | the address. | 
| entry_result | return location to an array of entries. | 
| array_len | return location for array length. | 
| error | address where an error can be returned. | 
Definition at line 363 of file dbus-address.c.
References _dbus_string_init_const(), DBUS_ERROR_BAD_ADDRESS, dbus_set_error(), and NULL.
Referenced by dbus_server_listen().
 1.8.14
 1.8.14