gssdp_client_new ()

GSSDPClient *
gssdp_client_new (const char *iface,
                  GError **error);

gssdp_client_new_with_port ()

GSSDPClient *
gssdp_client_new_with_port (const char *iface,
                            guint16 msearch_port,
                            GError **error);

gssdp_client_set_server_id ()

void
gssdp_client_set_server_id (GSSDPClient *client,
                            const char *server_id);

Sets the server ID of client to server_id .

gssdp_client_get_server_id ()

const char *
gssdp_client_get_server_id (GSSDPClient *client);

gssdp_client_get_interface ()

const char *
gssdp_client_get_interface (GSSDPClient *client);

Get the name of the network interface associated to client .

gssdp_client_get_host_ip ()

const char *
gssdp_client_get_host_ip (GSSDPClient *client);

Get the IP address we advertise ourselves as using.

gssdp_client_set_network ()

void
gssdp_client_set_network (GSSDPClient *client,
                          const char *network);

Sets the network identification of client to network .

gssdp_client_get_network ()

const char *
gssdp_client_get_network (GSSDPClient *client);

Get the network this client is associated with.

gssdp_client_get_active ()

gboolean
gssdp_client_get_active (GSSDPClient *client);

gssdp_client_get_address ()

GInetAddress *
gssdp_client_get_address (GSSDPClient *client);

gssdp_client_get_family ()

GSocketFamily
gssdp_client_get_family (GSSDPClient *client);

gssdp_client_get_index ()

guint
gssdp_client_get_index (GSSDPClient *client);

gssdp_client_get_uda_version ()

GSSDPUDAVersion
gssdp_client_get_uda_version (GSSDPClient *client);

gssdp_client_set_boot_id ()

void
gssdp_client_set_boot_id (GSSDPClient *client,
                          gint32 boot_id);

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

gssdp_client_set_config_id ()

void
gssdp_client_set_config_id (GSSDPClient *client,
                            gint32 config_id);

The config-id is used to allow caching of the device or service description. It should be changed if that changes.

gssdp_client_append_header ()

void
gssdp_client_append_header (GSSDPClient *client,
                            const char *name,
                            const char *value);

Adds a header field to the message sent by this client . It is intended to be used by clients requiring vendor specific header fields. (If there is an existing header with name name , then this creates a second one).

gssdp_client_clear_headers ()

void
gssdp_client_clear_headers (GSSDPClient *client);

Removes all the headers for this client .

gssdp_client_remove_header ()

void
gssdp_client_remove_header (GSSDPClient *client,
                            const char *name);

Removes name from the list of headers . If there are multiple values for name , they are all removed.

gssdp_client_add_cache_entry ()

void
gssdp_client_add_cache_entry (GSSDPClient *client,
                              const char *ip_address,
                              const char *user_agent);

gssdp_client_guess_user_agent ()

const char *
gssdp_client_guess_user_agent (GSSDPClient *client,
                               const char *ip_address);

GSSDPClient

typedef struct _GSSDPClient GSSDPClient;

enum GSSDPUDAVersion

The “active” property

  “active”                   gboolean

Whether this client is active or not (passive). When active (default), the client sends messages on the network, otherwise not. In most cases, you don't want to touch this property.

Owner: GSSDPClient

Flags: Read / Write

Default value: TRUE

The “address-family” property

  “address-family”           GSocketFamily

The IP protocol address family this client works on. When specified during construction without giving a concrete address, it will be used to determine the proper address.

If not specified, will contain the currrent address family after the call to g_initable_init(). Use G_SOCKET_FAMILY_INVALID to specifiy using the default socket family (legacy IP)

Owner: GSSDPClient

Flags: Read / Write / Construct Only

Default value: G_SOCKET_FAMILY_INVALID

Since: 1.1.1

The “boot-id” property

  “boot-id”                  gint

The value of the BOOTID.UPNP.ORG header

Since 1.1.2

Owner: GSSDPClient

Flags: Read / Write / Construct

Allowed values: >= -1

Default value: -1

The “config-id” property

  “config-id”                gint

The value of the BOOTID.UPNP.ORG header

Since 1.1.2

Owner: GSSDPClient

Flags: Read / Write / Construct

Allowed values: >= -1

Default value: -1

The “host-ip” property

  “host-ip”                  gchar *

The IP address of the assoicated network interface.

Owner: GSSDPClient

Flags: Read / Write / Construct

Default value: NULL

The “host-mask” property

  “host-mask”                GInetAddressMask *

The network mask of the assoicated network interface.

Owner: GSSDPClient

Flags: Read / Write / Construct

The “interface” property

  “interface”                gchar *

The name of the network interface this client is associated with. Set to NULL to autodetect.

Owner: GSSDPClient

Flags: Read / Write / Construct Only

Default value: NULL

The “msearch-port” property

  “msearch-port”             guint

UDP port to use for sending multicast M-SEARCH requests on the network. If not set (or set to 0) a random port will be used. This property can be only set during object construction.

Owner: GSSDPClient

Flags: Read / Write / Construct Only

Allowed values: <= 65535

Default value: 0

The “network” property

  “network”                  gchar *

The network this client is currently connected to. You could set this to anything you want to identify the network this client is associated with. If you are using GUPnPContextManager and associated interface is a WiFi interface, this property is set to the ESSID of the network. Otherwise, expect this to be the network IP address by default.

Owner: GSSDPClient

Flags: Read / Write / Construct

Default value: NULL

The “server-id” property

  “server-id”                gchar *

The SSDP server's identifier.

Owner: GSSDPClient

Flags: Read / Write

Default value: NULL

The “socket-ttl” property

  “socket-ttl”               guint

Time-to-live value to use for all sockets created by this client. If not set (or set to 0) the value recommended by UPnP will be used. This property can only be set during object construction.

Owner: GSSDPClient

Flags: Read / Write / Construct Only

Allowed values: <= 255

Default value: 0

The “uda-version” property

  “uda-version”              GSSDPUDAVersion

The UPnP version the client adheres to.

Owner: GSSDPClient

Flags: Read / Write / Construct Only

Default value: GSSDP_UDA_VERSION_1_0

Since: 1.1.1

The “message-received” signal

void
user_function (GSSDPClient        *client,
               gchar              *from_ip,
               guint               from_port,
               gint                type,
               SoupMessageHeaders *headers,
               gpointer            user_data)

Internal signal.

[skip]

Flags: Run Last

Stability Level: Private