[gssdp] client: Update documentation
- From: Jens Georg <jensgeorg src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gssdp] client: Update documentation
- Date: Mon, 4 Feb 2019 20:19:15 +0000 (UTC)
commit 2f4bf88127f09d43066373fbcb1db4b07a5da51f
Author: Jens Georg <mail jensge org>
Date: Mon Feb 4 21:18:55 2019 +0100
client: Update documentation
doc/gssdp-sections.txt | 5 ++++-
libgssdp/gssdp-client.c | 33 ++++++++++++++++++++++++++++++++-
2 files changed, 36 insertions(+), 2 deletions(-)
---
diff --git a/doc/gssdp-sections.txt b/doc/gssdp-sections.txt
index e07cedb..779ca31 100644
--- a/doc/gssdp-sections.txt
+++ b/doc/gssdp-sections.txt
@@ -15,7 +15,9 @@ gssdp_client_get_active
gssdp_client_get_address
gssdp_client_get_family
gssdp_client_get_index
-gssdp_client_new_full
+gssdp_client_get_uda_version
+gssdp_client_set_boot_id
+gssdp_client_set_config_id
gssdp_client_append_header
gssdp_client_clear_headers
gssdp_client_remove_header
@@ -78,6 +80,7 @@ gssdp_resource_browser_get_mx
gssdp_resource_browser_set_active
gssdp_resource_browser_get_active
gssdp_resource_browser_rescan
+gssdp_resource_group_update
<SUBSECTION Standard>
GSSDP_RESOURCE_BROWSER
GSSDP_IS_RESOURCE_BROWSER
diff --git a/libgssdp/gssdp-client.c b/libgssdp/gssdp-client.c
index d290fcb..16ca464 100644
--- a/libgssdp/gssdp-client.c
+++ b/libgssdp/gssdp-client.c
@@ -1136,6 +1136,13 @@ gssdp_client_get_index (GSSDPClient *client)
return priv->device.index;
}
+/**
+ * gssdp_client_get_family:
+ * @client: A #GSSDPClient
+ *
+ * Returns: IP protocol version (%G_SOCKET_FAMILY_IPV4 or G_SOCKET_FAMILY_IPV6)
+ * this client uses
+ */
GSocketFamily
gssdp_client_get_family (GSSDPClient *client)
{
@@ -1145,6 +1152,12 @@ gssdp_client_get_family (GSSDPClient *client)
return g_inet_address_get_family (priv->device.host_addr);
}
+/**
+ * gssdp_client_get_uda_version:
+ * @client: A #GSSDPClient
+ *
+ * Returns: the UDA protocol version this client adheres to
+ */
GSSDPUDAVersion
gssdp_client_get_uda_version (GSSDPClient *client)
{
@@ -1154,6 +1167,17 @@ gssdp_client_get_uda_version (GSSDPClient *client)
return priv->uda_version;
}
+/**
+ * gssdp_client_set_boot_id:
+ * @client: A #GSSDPClient
+ * @boot_id: The new boot-id for the client
+ *
+ * Will set the new boot-id for this SSDP client. Does nothing if the UDA
+ * version used by the client is UDA 1.0
+ *
+ * The boot-id is used to signalize changes in the network configuration
+ * for multi-homed hosts
+ */
void
gssdp_client_set_boot_id (GSSDPClient *client, gint32 boot_id)
{
@@ -1175,6 +1199,14 @@ gssdp_client_set_boot_id (GSSDPClient *client, gint32 boot_id)
}
+/**
+ * gssdp_client_set_config_id:
+ * @client: A #GSSDPClient
+ * @config_id: The new config-id for the client
+ *
+ * The config-id is used to allow caching of the device or service description.
+ * It should be changed if that changes.
+ */
void
gssdp_client_set_config_id (GSSDPClient *client, gint32 config_id)
{
@@ -1194,7 +1226,6 @@ gssdp_client_set_config_id (GSSDPClient *client, gint32 config_id)
}
-
/**
* _gssdp_client_send_message:
* @client: A #GSSDPClient
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]