Blame docs/libs/html/gst-plugins-base-libs-GstRTSPConnection.html

Packit 971217
Packit 971217
<html>
Packit 971217
<head>
Packit 971217
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
Packit 971217
<title>GstRTSPConnection: GStreamer Base Plugins 1.0 Library Reference Manual</title>
Packit 971217
<meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
Packit 971217
<link rel="home" href="index.html" title="GStreamer Base Plugins 1.0 Library Reference Manual">
Packit 971217
<link rel="up" href="gstreamer-rtsp.html" title="RTSP Library">
Packit 971217
<link rel="prev" href="gstreamer-rtsp.html" title="RTSP Library">
Packit 971217
<link rel="next" href="gst-plugins-base-libs-GstRtspdefs.html" title="GstRtspdefs">
Packit 971217
<meta name="generator" content="GTK-Doc V1.27 (XML mode)">
Packit 971217
<link rel="stylesheet" href="style.css" type="text/css">
Packit 971217
</head>
Packit 971217
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
Packit 971217
Packit 971217
Packit 971217
Top  | 
Packit 971217
                  Description
Packit 971217
Packit 971217
Home
Packit 971217
Up
Packit 971217
Prev
Packit 971217
Next
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

GstRTSPConnection

Packit 971217

GstRTSPConnection — manage RTSP connections

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Functions

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
GstRTSPResult
Packit 971217
Packit 971217
Packit 971217
gst_rtsp_connection_create ()
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
GstRTSPResult
Packit 971217
Packit 971217
Packit 971217
gst_rtsp_connection_create_from_socket ()
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
GstRTSPResult
Packit 971217
Packit 971217
Packit 971217
gst_rtsp_connection_accept ()
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
GstRTSPResult
Packit 971217
Packit 971217
Packit 971217
gst_rtsp_connection_connect ()
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
GstRTSPResult
Packit 971217
Packit 971217
Packit 971217
gst_rtsp_connection_connect_with_response ()
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
GstRTSPResult
Packit 971217
Packit 971217
Packit 971217
gst_rtsp_connection_close ()
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
GstRTSPResult
Packit 971217
Packit 971217
Packit 971217
gst_rtsp_connection_free ()
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
GstRTSPResult
Packit 971217
Packit 971217
Packit 971217
gst_rtsp_connection_read ()
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
GstRTSPResult
Packit 971217
Packit 971217
Packit 971217
gst_rtsp_connection_write ()
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
GstRTSPResult
Packit 971217
Packit 971217
Packit 971217
gst_rtsp_connection_poll ()
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
GstRTSPResult
Packit 971217
Packit 971217
Packit 971217
gst_rtsp_connection_send ()
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
GstRTSPResult
Packit 971217
Packit 971217
Packit 971217
gst_rtsp_connection_receive ()
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
GstRTSPResult
Packit 971217
Packit 971217
Packit 971217
gst_rtsp_connection_next_timeout ()
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
GstRTSPResult
Packit 971217
Packit 971217
Packit 971217
gst_rtsp_connection_reset_timeout ()
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
GstRTSPResult
Packit 971217
Packit 971217
Packit 971217
gst_rtsp_connection_flush ()
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
GstRTSPResult
Packit 971217
Packit 971217
Packit 971217
gst_rtsp_connection_set_auth ()
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
void
Packit 971217
Packit 971217
Packit 971217
gst_rtsp_connection_set_auth_param ()
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
void
Packit 971217
Packit 971217
Packit 971217
gst_rtsp_connection_clear_auth_params ()
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
GstRTSPResult
Packit 971217
Packit 971217
Packit 971217
gst_rtsp_connection_set_qos_dscp ()
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
void
Packit 971217
Packit 971217
Packit 971217
gst_rtsp_connection_set_ip ()
Packit 971217
Packit 971217
Packit 971217
Packit 971217
const gchar *
Packit 971217
Packit 971217
Packit 971217
gst_rtsp_connection_get_ip ()
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
GstRTSPUrl *
Packit 971217
Packit 971217
Packit 971217
gst_rtsp_connection_get_url ()
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
void
Packit 971217
Packit 971217
Packit 971217
gst_rtsp_connection_set_tunneled ()
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
gboolean
Packit 971217
Packit 971217
Packit 971217
gst_rtsp_connection_is_tunneled ()
Packit 971217
Packit 971217
Packit 971217
Packit 971217
const gchar *
Packit 971217
Packit 971217
Packit 971217
gst_rtsp_connection_get_tunnelid ()
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
GstRTSPResult
Packit 971217
Packit 971217
Packit 971217
gst_rtsp_connection_do_tunnel ()
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
void
Packit 971217
Packit 971217
Packit 971217
gst_rtsp_connection_set_http_mode ()
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
GstRTSPResult
Packit 971217
Packit 971217
Packit 971217
gst_rtsp_connection_set_proxy ()
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
GSocket *
Packit 971217
Packit 971217
Packit 971217
gst_rtsp_connection_get_read_socket ()
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
GSocket *
Packit 971217
Packit 971217
Packit 971217
gst_rtsp_connection_get_write_socket ()
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
GTlsConnection *
Packit 971217
Packit 971217
Packit 971217
gst_rtsp_connection_get_tls ()
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
gboolean
Packit 971217
Packit 971217
Packit 971217
gst_rtsp_connection_set_tls_validation_flags ()
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
GTlsCertificateFlags
Packit 971217
Packit 971217
Packit 971217
gst_rtsp_connection_get_tls_validation_flags ()
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
void
Packit 971217
Packit 971217
Packit 971217
gst_rtsp_connection_set_tls_database ()
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
GTlsDatabase *
Packit 971217
Packit 971217
Packit 971217
gst_rtsp_connection_get_tls_database ()
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
void
Packit 971217
Packit 971217
Packit 971217
gst_rtsp_connection_set_tls_interaction ()
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
GTlsInteraction *
Packit 971217
Packit 971217
Packit 971217
gst_rtsp_connection_get_tls_interaction ()
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
gboolean
Packit 971217
Packit 971217
Packit 971217
gst_rtsp_connection_get_remember_session_id ()
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
void
Packit 971217
Packit 971217
Packit 971217
gst_rtsp_connection_set_remember_session_id ()
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
GstRTSPWatch *
Packit 971217
Packit 971217
Packit 971217
gst_rtsp_watch_new ()
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
void
Packit 971217
Packit 971217
Packit 971217
gst_rtsp_watch_unref ()
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
guint
Packit 971217
Packit 971217
Packit 971217
gst_rtsp_watch_attach ()
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
void
Packit 971217
Packit 971217
Packit 971217
gst_rtsp_watch_reset ()
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
GstRTSPResult
Packit 971217
Packit 971217
Packit 971217
gst_rtsp_watch_send_message ()
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
GstRTSPResult
Packit 971217
Packit 971217
Packit 971217
gst_rtsp_watch_write_data ()
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
void
Packit 971217
Packit 971217
Packit 971217
gst_rtsp_watch_get_send_backlog ()
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
void
Packit 971217
Packit 971217
Packit 971217
gst_rtsp_watch_set_send_backlog ()
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
void
Packit 971217
Packit 971217
Packit 971217
gst_rtsp_watch_set_flushing ()
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
GstRTSPResult
Packit 971217
Packit 971217
Packit 971217
gst_rtsp_watch_wait_backlog ()
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Types and Values

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
 
Packit 971217
GstRTSPConnection
Packit 971217
Packit 971217
Packit 971217
 
Packit 971217
GstRTSPWatch
Packit 971217
Packit 971217
Packit 971217
 
Packit 971217
GstRTSPWatchFuncs
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Includes

Packit 971217
#include <gst/rtsp/gstrtspconnection.h>
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Description

Packit 971217

This object manages the RTSP connection to the server. It provides function

Packit 971217
to receive and send bytes and messages.

Packit 971217
Packit 971217
Packit 971217

Functions

Packit 971217
Packit 971217

gst_rtsp_connection_create ()

Packit 971217
GstRTSPResult
Packit 971217
gst_rtsp_connection_create (const GstRTSPUrl *url,
Packit 971217
                            GstRTSPConnection **conn);
Packit 971217

Create a newly allocated GstRTSPConnection from url

Packit 971217
 and store it in conn
Packit 971217
.
Packit 971217
The connection will not yet attempt to connect to url
Packit 971217
, use
Packit 971217
gst_rtsp_connection_connect().

Packit 971217

A copy of url

Packit 971217
 will be made.

Packit 971217
Packit 971217

Parameters

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

url

Packit 971217

a GstRTSPUrl

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

conn

Packit 971217

storage for a GstRTSPConnection.

Packit 971217
[out][transfer full]
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Returns

Packit 971217

GST_RTSP_OK when conn

Packit 971217
contains a valid connection.

Packit 971217
Packit 971217
Packit 971217

Packit 971217
Packit 971217

gst_rtsp_connection_create_from_socket ()

Packit 971217
GstRTSPResult
Packit 971217
gst_rtsp_connection_create_from_socket
Packit 971217
                               (GSocket *socket,
Packit 971217
                                const gchar *ip,
Packit 971217
                                guint16 port,
Packit 971217
                                const gchar *initial_buffer,
Packit 971217
                                GstRTSPConnection **conn);
Packit 971217

Create a new GstRTSPConnection for handling communication on the existing

Packit 971217
socket socket
Packit 971217
. The initial_buffer
Packit 971217
 contains zero terminated data already
Packit 971217
read from socket
Packit 971217
 which should be used before starting to read new data.

Packit 971217
Packit 971217

Parameters

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

socket

Packit 971217

a GSocket

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

ip

Packit 971217

the IP address of the other end

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

port

Packit 971217

the port used by the other end

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

initial_buffer

Packit 971217

data already read from fd

Packit 971217

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

conn

Packit 971217

storage for a GstRTSPConnection.

Packit 971217
[out][transfer full]
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Returns

Packit 971217

GST_RTSP_OK when conn

Packit 971217
contains a valid connection.

Packit 971217
Packit 971217
Packit 971217

Packit 971217
Packit 971217

gst_rtsp_connection_accept ()

Packit 971217
GstRTSPResult
Packit 971217
gst_rtsp_connection_accept (GSocket *socket,
Packit 971217
                            GstRTSPConnection **conn,
Packit 971217
                            GCancellable *cancellable);
Packit 971217

Accept a new connection on socket

Packit 971217
 and create a new GstRTSPConnection for
Packit 971217
handling communication on new socket.

Packit 971217
Packit 971217

Parameters

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

socket

Packit 971217

a socket

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

conn

Packit 971217

storage for a GstRTSPConnection.

Packit 971217
[out][transfer full]
Packit 971217
Packit 971217
Packit 971217

cancellable

Packit 971217

a GCancellable to cancel the operation

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Returns

Packit 971217

GST_RTSP_OK when conn

Packit 971217
contains a valid connection.

Packit 971217
Packit 971217
Packit 971217

Packit 971217
Packit 971217

gst_rtsp_connection_connect ()

Packit 971217
GstRTSPResult
Packit 971217
gst_rtsp_connection_connect (GstRTSPConnection *conn,
Packit 971217
                             GTimeVal *timeout);
Packit 971217

Attempt to connect to the url of conn

Packit 971217
 made with
Packit 971217
gst_rtsp_connection_create(). If timeout
Packit 971217
 is NULL this function can block
Packit 971217
forever. If timeout
Packit 971217
 contains a valid timeout, this function will return
Packit 971217
GST_RTSP_ETIMEOUT after the timeout expired.

Packit 971217

This function can be cancelled with gst_rtsp_connection_flush().

Packit 971217
Packit 971217

Parameters

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

conn

Packit 971217

a GstRTSPConnection

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

timeout

Packit 971217

a GTimeVal timeout

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Returns

Packit 971217

GST_RTSP_OK when a connection could be made.

Packit 971217
Packit 971217
Packit 971217

Packit 971217
Packit 971217

gst_rtsp_connection_connect_with_response ()

Packit 971217
GstRTSPResult
Packit 971217
gst_rtsp_connection_connect_with_response
Packit 971217
                               (GstRTSPConnection *conn,
Packit 971217
                                GTimeVal *timeout,
Packit 971217
                                GstRTSPMessage *response);
Packit 971217

Attempt to connect to the url of conn

Packit 971217
 made with
Packit 971217
gst_rtsp_connection_create(). If timeout
Packit 971217
 is NULL this function can block
Packit 971217
forever. If timeout
Packit 971217
 contains a valid timeout, this function will return
Packit 971217
GST_RTSP_ETIMEOUT after the timeout expired.  If conn
Packit 971217
 is set to tunneled,
Packit 971217
response
Packit 971217
 will contain a response to the tunneling request messages.

Packit 971217

This function can be cancelled with gst_rtsp_connection_flush().

Packit 971217
Packit 971217

Parameters

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

conn

Packit 971217

a GstRTSPConnection

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

timeout

Packit 971217

a GTimeVal timeout

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

response

Packit 971217

a GstRTSPMessage

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Returns

Packit 971217

GST_RTSP_OK when a connection could be made.

Packit 971217

Since 1.8

Packit 971217
Packit 971217
Packit 971217

Packit 971217
Packit 971217

gst_rtsp_connection_close ()

Packit 971217
GstRTSPResult
Packit 971217
gst_rtsp_connection_close (GstRTSPConnection *conn);
Packit 971217

Close the connected conn

Packit 971217
. After this call, the connection is in the same
Packit 971217
state as when it was first created.

Packit 971217
Packit 971217

Parameters

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

conn

Packit 971217

a GstRTSPConnection

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Returns

Packit 971217

GST_RTSP_OK on success.

Packit 971217
Packit 971217
Packit 971217

Packit 971217
Packit 971217

gst_rtsp_connection_free ()

Packit 971217
GstRTSPResult
Packit 971217
gst_rtsp_connection_free (GstRTSPConnection *conn);
Packit 971217

Close and free conn

Packit 971217
.

Packit 971217
Packit 971217

Parameters

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

conn

Packit 971217

a GstRTSPConnection

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Returns

Packit 971217

GST_RTSP_OK on success.

Packit 971217
Packit 971217
Packit 971217

Packit 971217
Packit 971217

gst_rtsp_connection_read ()

Packit 971217
GstRTSPResult
Packit 971217
gst_rtsp_connection_read (GstRTSPConnection *conn,
Packit 971217
                          guint8 *data,
Packit 971217
                          guint size,
Packit 971217
                          GTimeVal *timeout);
Packit 971217

Attempt to read size

Packit 971217
 bytes into data
Packit 971217
 from the connected conn
Packit 971217
, blocking up to
Packit 971217
the specified timeout
Packit 971217
. timeout
Packit 971217
 can be NULL, in which case this function
Packit 971217
might block forever.

Packit 971217

This function can be cancelled with gst_rtsp_connection_flush().

Packit 971217
Packit 971217

Parameters

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

conn

Packit 971217

a GstRTSPConnection

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

data

Packit 971217

the data to read

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

size

Packit 971217

the size of data

Packit 971217

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

timeout

Packit 971217

a timeout value or NULL

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Returns

Packit 971217

GST_RTSP_OK on success.

Packit 971217
Packit 971217
Packit 971217

Packit 971217
Packit 971217

gst_rtsp_connection_write ()

Packit 971217
GstRTSPResult
Packit 971217
gst_rtsp_connection_write (GstRTSPConnection *conn,
Packit 971217
                           const guint8 *data,
Packit 971217
                           guint size,
Packit 971217
                           GTimeVal *timeout);
Packit 971217

Attempt to write size

Packit 971217
 bytes of data
Packit 971217
 to the connected conn
Packit 971217
, blocking up to
Packit 971217
the specified timeout
Packit 971217
. timeout
Packit 971217
 can be NULL, in which case this function
Packit 971217
might block forever.

Packit 971217

This function can be cancelled with gst_rtsp_connection_flush().

Packit 971217
Packit 971217

Parameters

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

conn

Packit 971217

a GstRTSPConnection

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

data

Packit 971217

the data to write

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

size

Packit 971217

the size of data

Packit 971217

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

timeout

Packit 971217

a timeout value or NULL

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Returns

Packit 971217

GST_RTSP_OK on success.

Packit 971217
Packit 971217
Packit 971217

Packit 971217
Packit 971217

gst_rtsp_connection_poll ()

Packit 971217
GstRTSPResult
Packit 971217
gst_rtsp_connection_poll (GstRTSPConnection *conn,
Packit 971217
                          GstRTSPEvent events,
Packit 971217
                          GstRTSPEvent *revents,
Packit 971217
                          GTimeVal *timeout);
Packit 971217

Wait up to the specified timeout

Packit 971217
 for the connection to become available for
Packit 971217
at least one of the operations specified in events
Packit 971217
. When the function returns
Packit 971217
with GST_RTSP_OK, revents
Packit 971217
 will contain a bitmask of available operations on
Packit 971217
conn
Packit 971217
.

Packit 971217

timeout

Packit 971217
 can be NULL, in which case this function might block forever.

Packit 971217

This function can be cancelled with gst_rtsp_connection_flush().

Packit 971217
Packit 971217

Parameters

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

conn

Packit 971217

a GstRTSPConnection

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

events

Packit 971217

a bitmask of GstRTSPEvent flags to check

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

revents

Packit 971217

location for result flags

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

timeout

Packit 971217

a timeout

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Returns

Packit 971217

GST_RTSP_OK on success.

Packit 971217
Packit 971217
Packit 971217

Packit 971217
Packit 971217

gst_rtsp_connection_send ()

Packit 971217
GstRTSPResult
Packit 971217
gst_rtsp_connection_send (GstRTSPConnection *conn,
Packit 971217
                          GstRTSPMessage *message,
Packit 971217
                          GTimeVal *timeout);
Packit 971217

Attempt to send message

Packit 971217
 to the connected conn
Packit 971217
, blocking up to
Packit 971217
the specified timeout
Packit 971217
. timeout
Packit 971217
 can be NULL, in which case this function
Packit 971217
might block forever.

Packit 971217

This function can be cancelled with gst_rtsp_connection_flush().

Packit 971217
Packit 971217

Parameters

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

conn

Packit 971217

a GstRTSPConnection

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

message

Packit 971217

the message to send

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

timeout

Packit 971217

a timeout value or NULL

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Returns

Packit 971217

GST_RTSP_OK on success.

Packit 971217
Packit 971217
Packit 971217

Packit 971217
Packit 971217

gst_rtsp_connection_receive ()

Packit 971217
GstRTSPResult
Packit 971217
gst_rtsp_connection_receive (GstRTSPConnection *conn,
Packit 971217
                             GstRTSPMessage *message,
Packit 971217
                             GTimeVal *timeout);
Packit 971217

Attempt to read into message

Packit 971217
 from the connected conn
Packit 971217
, blocking up to
Packit 971217
the specified timeout
Packit 971217
. timeout
Packit 971217
 can be NULL, in which case this function
Packit 971217
might block forever.

Packit 971217

This function can be cancelled with gst_rtsp_connection_flush().

Packit 971217
Packit 971217

Parameters

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

conn

Packit 971217

a GstRTSPConnection

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

message

Packit 971217

the message to read

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

timeout

Packit 971217

a timeout value or NULL

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Returns

Packit 971217

GST_RTSP_OK on success.

Packit 971217
Packit 971217
Packit 971217

Packit 971217
Packit 971217

gst_rtsp_connection_next_timeout ()

Packit 971217
GstRTSPResult
Packit 971217
gst_rtsp_connection_next_timeout (GstRTSPConnection *conn,
Packit 971217
                                  GTimeVal *timeout);
Packit 971217

Calculate the next timeout for conn

Packit 971217
, storing the result in timeout
Packit 971217
.

Packit 971217
Packit 971217

Parameters

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

conn

Packit 971217

a GstRTSPConnection

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

timeout

Packit 971217

a timeout

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Returns

Packit 971217

GST_RTSP_OK.

Packit 971217
Packit 971217
Packit 971217

Packit 971217
Packit 971217

gst_rtsp_connection_reset_timeout ()

Packit 971217
GstRTSPResult
Packit 971217
gst_rtsp_connection_reset_timeout (GstRTSPConnection *conn);
Packit 971217

Reset the timeout of conn

Packit 971217
.

Packit 971217
Packit 971217

Parameters

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

conn

Packit 971217

a GstRTSPConnection

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Returns

Packit 971217

GST_RTSP_OK.

Packit 971217
Packit 971217
Packit 971217

Packit 971217
Packit 971217

gst_rtsp_connection_flush ()

Packit 971217
GstRTSPResult
Packit 971217
gst_rtsp_connection_flush (GstRTSPConnection *conn,
Packit 971217
                           gboolean flush);
Packit 971217

Start or stop the flushing action on conn

Packit 971217
. When flushing, all current
Packit 971217
and future actions on conn
Packit 971217
 will return GST_RTSP_EINTR until the connection
Packit 971217
is set to non-flushing mode again.

Packit 971217
Packit 971217

Parameters

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

conn

Packit 971217

a GstRTSPConnection

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

flush

Packit 971217

start or stop the flush

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Returns

Packit 971217

GST_RTSP_OK.

Packit 971217
Packit 971217
Packit 971217

Packit 971217
Packit 971217

gst_rtsp_connection_set_auth ()

Packit 971217
GstRTSPResult
Packit 971217
gst_rtsp_connection_set_auth (GstRTSPConnection *conn,
Packit 971217
                              GstRTSPAuthMethod method,
Packit 971217
                              const gchar *user,
Packit 971217
                              const gchar *pass);
Packit 971217

Configure conn

Packit 971217
 for authentication mode method
Packit 971217
 with user
Packit 971217
 and pass
Packit 971217
 as the
Packit 971217
user and password respectively.

Packit 971217
Packit 971217

Parameters

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

conn

Packit 971217

a GstRTSPConnection

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

method

Packit 971217

authentication method

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

user

Packit 971217

the user

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

pass

Packit 971217

the password

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Returns

Packit 971217

GST_RTSP_OK.

Packit 971217
Packit 971217
Packit 971217

Packit 971217
Packit 971217

gst_rtsp_connection_set_auth_param ()

Packit 971217
void
Packit 971217
gst_rtsp_connection_set_auth_param (GstRTSPConnection *conn,
Packit 971217
                                    const gchar *param,
Packit 971217
                                    const gchar *value);
Packit 971217

Setup conn

Packit 971217
 with authentication directives. This is not necesary for
Packit 971217
methods GST_RTSP_AUTH_NONE and GST_RTSP_AUTH_BASIC. For
Packit 971217
GST_RTSP_AUTH_DIGEST, directives should be taken from the digest challenge
Packit 971217
in the WWW-Authenticate response header and can include realm, domain,
Packit 971217
nonce, opaque, stale, algorithm, qop as per RFC2617.

Packit 971217
Packit 971217

Parameters

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

conn

Packit 971217

a GstRTSPConnection

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

param

Packit 971217

authentication directive

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

value

Packit 971217

value

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Packit 971217
Packit 971217

gst_rtsp_connection_clear_auth_params ()

Packit 971217
void
Packit 971217
gst_rtsp_connection_clear_auth_params (GstRTSPConnection *conn);
Packit 971217

Clear the list of authentication directives stored in conn

Packit 971217
.

Packit 971217
Packit 971217

Parameters

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

conn

Packit 971217

a GstRTSPConnection

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Packit 971217
Packit 971217

gst_rtsp_connection_set_qos_dscp ()

Packit 971217
GstRTSPResult
Packit 971217
gst_rtsp_connection_set_qos_dscp (GstRTSPConnection *conn,
Packit 971217
                                  guint qos_dscp);
Packit 971217

Configure conn

Packit 971217
 to use the specified DSCP value.

Packit 971217
Packit 971217

Parameters

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

conn

Packit 971217

a GstRTSPConnection

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

qos_dscp

Packit 971217

DSCP value

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Returns

Packit 971217

GST_RTSP_OK on success.

Packit 971217
Packit 971217
Packit 971217

Packit 971217
Packit 971217

gst_rtsp_connection_set_ip ()

Packit 971217
void
Packit 971217
gst_rtsp_connection_set_ip (GstRTSPConnection *conn,
Packit 971217
                            const gchar *ip);
Packit 971217

Set the IP address of the server.

Packit 971217
Packit 971217

Parameters

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

conn

Packit 971217

a GstRTSPConnection

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

ip

Packit 971217

an ip address

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Packit 971217
Packit 971217

gst_rtsp_connection_get_ip ()

Packit 971217
const gchar *
Packit 971217
gst_rtsp_connection_get_ip (const GstRTSPConnection *conn);
Packit 971217

Retrieve the IP address of the other end of conn

Packit 971217
.

Packit 971217
Packit 971217

Parameters

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

conn

Packit 971217

a GstRTSPConnection

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Returns

Packit 971217

The IP address as a string. this value remains valid until the

Packit 971217
connection is closed.

Packit 971217
Packit 971217
Packit 971217

Packit 971217
Packit 971217

gst_rtsp_connection_get_url ()

Packit 971217
GstRTSPUrl *
Packit 971217
gst_rtsp_connection_get_url (const GstRTSPConnection *conn);
Packit 971217

Retrieve the URL of the other end of conn

Packit 971217
.

Packit 971217
Packit 971217

Parameters

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

conn

Packit 971217

a GstRTSPConnection

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Returns

Packit 971217

The URL. This value remains valid until the

Packit 971217
connection is freed.

Packit 971217
Packit 971217
Packit 971217

Packit 971217
Packit 971217

gst_rtsp_connection_set_tunneled ()

Packit 971217
void
Packit 971217
gst_rtsp_connection_set_tunneled (GstRTSPConnection *conn,
Packit 971217
                                  gboolean tunneled);
Packit 971217

Set the HTTP tunneling state of the connection. This must be configured before

Packit 971217
the conn
Packit 971217
 is connected.

Packit 971217
Packit 971217

Parameters

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

conn

Packit 971217

a GstRTSPConnection

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

tunneled

Packit 971217

the new state

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Packit 971217
Packit 971217

gst_rtsp_connection_is_tunneled ()

Packit 971217
gboolean
Packit 971217
gst_rtsp_connection_is_tunneled (const GstRTSPConnection *conn);
Packit 971217

Get the tunneling state of the connection.

Packit 971217
Packit 971217

Parameters

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

conn

Packit 971217

a GstRTSPConnection

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Returns

Packit 971217

if conn

Packit 971217
is using HTTP tunneling.

Packit 971217
Packit 971217
Packit 971217

Packit 971217
Packit 971217

gst_rtsp_connection_get_tunnelid ()

Packit 971217
const gchar *
Packit 971217
gst_rtsp_connection_get_tunnelid (const GstRTSPConnection *conn);
Packit 971217

Get the tunnel session id the connection.

Packit 971217
Packit 971217

Parameters

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

conn

Packit 971217

a GstRTSPConnection

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Returns

Packit 971217

returns a non-empty string if conn

Packit 971217
is being tunneled over HTTP.

Packit 971217
Packit 971217
Packit 971217

Packit 971217
Packit 971217

gst_rtsp_connection_do_tunnel ()

Packit 971217
GstRTSPResult
Packit 971217
gst_rtsp_connection_do_tunnel (GstRTSPConnection *conn,
Packit 971217
                               GstRTSPConnection *conn2);
Packit 971217

If conn

Packit 971217
 received the first tunnel connection and conn2
Packit 971217
 received
Packit 971217
the second tunnel connection, link the two connections together so that
Packit 971217
conn
Packit 971217
 manages the tunneled connection.

Packit 971217

After this call, conn2

Packit 971217
 cannot be used anymore and must be freed with
Packit 971217
gst_rtsp_connection_free().

Packit 971217

If conn2

Packit 971217
 is NULL then only the base64 decoding context will be setup for
Packit 971217
conn
Packit 971217
.

Packit 971217
Packit 971217

Parameters

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

conn

Packit 971217

a GstRTSPConnection

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

conn2

Packit 971217

a GstRTSPConnection or NULL

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Returns

Packit 971217

return GST_RTSP_OK on success.

Packit 971217
Packit 971217
Packit 971217

Packit 971217
Packit 971217

gst_rtsp_connection_set_http_mode ()

Packit 971217
void
Packit 971217
gst_rtsp_connection_set_http_mode (GstRTSPConnection *conn,
Packit 971217
                                   gboolean enable);
Packit 971217

By setting the HTTP mode to TRUE the message parsing will support HTTP

Packit 971217
messages in addition to the RTSP messages. It will also disable the
Packit 971217
automatic handling of setting up an HTTP tunnel.

Packit 971217
Packit 971217

Parameters

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

conn

Packit 971217

a GstRTSPConnection

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

enable

Packit 971217

TRUE to enable manual HTTP mode

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Packit 971217
Packit 971217

gst_rtsp_connection_set_proxy ()

Packit 971217
GstRTSPResult
Packit 971217
gst_rtsp_connection_set_proxy (GstRTSPConnection *conn,
Packit 971217
                               const gchar *host,
Packit 971217
                               guint port);
Packit 971217

Set the proxy host and port.

Packit 971217
Packit 971217

Parameters

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

conn

Packit 971217

a GstRTSPConnection

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

host

Packit 971217

the proxy host

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

port

Packit 971217

the proxy port

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Returns

Packit 971217

GST_RTSP_OK.

Packit 971217
Packit 971217
Packit 971217

Packit 971217
Packit 971217

gst_rtsp_connection_get_read_socket ()

Packit 971217
GSocket *
Packit 971217
gst_rtsp_connection_get_read_socket (const GstRTSPConnection *conn);
Packit 971217

Get the file descriptor for reading.

Packit 971217
Packit 971217

Parameters

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

conn

Packit 971217

a GstRTSPConnection

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Returns

Packit 971217

the file descriptor used for reading or NULL on

Packit 971217
error. The file descriptor remains valid until the connection is closed. 

Packit 971217

[transfer none]

Packit 971217
Packit 971217
Packit 971217

Packit 971217
Packit 971217

gst_rtsp_connection_get_write_socket ()

Packit 971217
GSocket *
Packit 971217
gst_rtsp_connection_get_write_socket (const GstRTSPConnection *conn);
Packit 971217

Get the file descriptor for writing.

Packit 971217
Packit 971217

Parameters

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

conn

Packit 971217

a GstRTSPConnection

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Returns

Packit 971217

the file descriptor used for writing or NULL on

Packit 971217
error. The file descriptor remains valid until the connection is closed. 

Packit 971217

[transfer none]

Packit 971217
Packit 971217
Packit 971217

Packit 971217
Packit 971217

gst_rtsp_connection_get_tls ()

Packit 971217
GTlsConnection *
Packit 971217
gst_rtsp_connection_get_tls (GstRTSPConnection *conn,
Packit 971217
                             GError **error);
Packit 971217

Get the TLS connection of conn

Packit 971217
.

Packit 971217

For client side this will return the GTlsClientConnection when connected

Packit 971217
over TLS.

Packit 971217

For server side connections, this function will create a GTlsServerConnection

Packit 971217
when called the first time and will return that same connection on subsequent
Packit 971217
calls. The server is then responsible for configuring the TLS connection.

Packit 971217
Packit 971217

Parameters

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

conn

Packit 971217

a GstRTSPConnection

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

error

Packit 971217

GError for error reporting, or NULL to ignore.

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Returns

Packit 971217

the TLS connection for conn

Packit 971217
. 

Packit 971217

[transfer none]

Packit 971217
Packit 971217

Since: 1.2

Packit 971217
Packit 971217

Packit 971217
Packit 971217

gst_rtsp_connection_set_tls_validation_flags ()

Packit 971217
gboolean
Packit 971217
gst_rtsp_connection_set_tls_validation_flags
Packit 971217
                               (GstRTSPConnection *conn,
Packit 971217
                                GTlsCertificateFlags flags);
Packit 971217

Sets the TLS validation flags to be used to verify the peer

Packit 971217
certificate when a TLS connection is established.

Packit 971217
Packit 971217

Parameters

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

conn

Packit 971217

a GstRTSPConnection

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

flags

Packit 971217

the validation flags.

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Returns

Packit 971217

TRUE if the validation flags are set correctly, or FALSE if

Packit 971217
conn
Packit 971217
is NULL or is not a TLS connection.

Packit 971217
Packit 971217

Since: 1.2.1

Packit 971217
Packit 971217

Packit 971217
Packit 971217

gst_rtsp_connection_get_tls_validation_flags ()

Packit 971217
GTlsCertificateFlags
Packit 971217
gst_rtsp_connection_get_tls_validation_flags
Packit 971217
                               (GstRTSPConnection *conn);
Packit 971217

Gets the TLS validation flags used to verify the peer certificate

Packit 971217
when a TLS connection is established.

Packit 971217
Packit 971217

Parameters

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

conn

Packit 971217

a GstRTSPConnection

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Returns

Packit 971217

the validationg flags.

Packit 971217
Packit 971217

Since: 1.2.1

Packit 971217
Packit 971217

Packit 971217
Packit 971217

gst_rtsp_connection_set_tls_database ()

Packit 971217
void
Packit 971217
gst_rtsp_connection_set_tls_database (GstRTSPConnection *conn,
Packit 971217
                                      GTlsDatabase *database);
Packit 971217

Sets the anchor certificate authorities database. This certificate

Packit 971217
database will be used to verify the server's certificate in case it
Packit 971217
can't be verified with the default certificate database first.

Packit 971217
Packit 971217

Parameters

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

conn

Packit 971217

a GstRTSPConnection

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

database

Packit 971217

a GTlsDatabase

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Since: 1.4

Packit 971217
Packit 971217

Packit 971217
Packit 971217

gst_rtsp_connection_get_tls_database ()

Packit 971217
GTlsDatabase *
Packit 971217
gst_rtsp_connection_get_tls_database (GstRTSPConnection *conn);
Packit 971217

Gets the anchor certificate authorities database that will be used

Packit 971217
after a server certificate can't be verified with the default
Packit 971217
certificate database.

Packit 971217
Packit 971217

Parameters

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

conn

Packit 971217

a GstRTSPConnection

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Returns

Packit 971217

the anchor certificate authorities database, or NULL if no

Packit 971217
database has been previously set. Use g_object_unref() to release the
Packit 971217
certificate database. 

Packit 971217

[transfer full]

Packit 971217
Packit 971217

Since: 1.4

Packit 971217
Packit 971217

Packit 971217
Packit 971217

gst_rtsp_connection_set_tls_interaction ()

Packit 971217
void
Packit 971217
gst_rtsp_connection_set_tls_interaction
Packit 971217
                               (GstRTSPConnection *conn,
Packit 971217
                                GTlsInteraction *interaction);
Packit 971217

Sets a GTlsInteraction object to be used when the connection or certificate

Packit 971217
database need to interact with the user. This will be used to prompt the
Packit 971217
user for passwords where necessary.

Packit 971217
Packit 971217

Parameters

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

conn

Packit 971217

a GstRTSPConnection

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

interaction

Packit 971217

a GTlsInteraction

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Since: 1.6

Packit 971217
Packit 971217

Packit 971217
Packit 971217

gst_rtsp_connection_get_tls_interaction ()

Packit 971217
GTlsInteraction *
Packit 971217
gst_rtsp_connection_get_tls_interaction
Packit 971217
                               (GstRTSPConnection *conn);
Packit 971217

Gets a GTlsInteraction object to be used when the connection or certificate

Packit 971217
database need to interact with the user. This will be used to prompt the
Packit 971217
user for passwords where necessary.

Packit 971217
Packit 971217

Parameters

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

conn

Packit 971217

a GstRTSPConnection

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Returns

Packit 971217

a reference on the GTlsInteraction. Use

Packit 971217
g_object_unref() to release. 

Packit 971217

[transfer full]

Packit 971217
Packit 971217

Since: 1.6

Packit 971217
Packit 971217

Packit 971217
Packit 971217

gst_rtsp_connection_get_remember_session_id ()

Packit 971217
gboolean
Packit 971217
gst_rtsp_connection_get_remember_session_id
Packit 971217
                               (GstRTSPConnection *conn);
Packit 971217
Packit 971217

Parameters

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

conn

Packit 971217

a GstRTSPConnection

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Returns

Packit 971217

TRUE if the GstRTSPConnection remembers the session id in the

Packit 971217
last response to set it on any further request.

Packit 971217
Packit 971217
Packit 971217

Packit 971217
Packit 971217

gst_rtsp_connection_set_remember_session_id ()

Packit 971217
void
Packit 971217
gst_rtsp_connection_set_remember_session_id
Packit 971217
                               (GstRTSPConnection *conn,
Packit 971217
                                gboolean remember);
Packit 971217

Sets if the GstRTSPConnection should remember the session id from the last

Packit 971217
response received and force it onto any further requests.

Packit 971217

The default value is TRUE

Packit 971217
Packit 971217

Parameters

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

conn

Packit 971217

a GstRTSPConnection

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

remember

Packit 971217

TRUE if the connection should remember the session id

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Packit 971217
Packit 971217

gst_rtsp_watch_new ()

Packit 971217
GstRTSPWatch *
Packit 971217
gst_rtsp_watch_new (GstRTSPConnection *conn,
Packit 971217
                    GstRTSPWatchFuncs *funcs,
Packit 971217
                    gpointer user_data,
Packit 971217
                    GDestroyNotify notify);
Packit 971217

Create a watch object for conn

Packit 971217
. The functions provided in funcs
Packit 971217
 will be
Packit 971217
called with user_data
Packit 971217
 when activity happened on the watch.

Packit 971217

The new watch is usually created so that it can be attached to a

Packit 971217
maincontext with gst_rtsp_watch_attach().

Packit 971217

conn

Packit 971217
 must exist for the entire lifetime of the watch.

Packit 971217

[skip]

Packit 971217
Packit 971217

Parameters

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

conn

Packit 971217

a GstRTSPConnection

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

funcs

Packit 971217

watch functions

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

user_data

Packit 971217

user data to pass to funcs

Packit 971217

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

notify

Packit 971217

notify when user_data

Packit 971217
is not referenced anymore

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Returns

Packit 971217

a GstRTSPWatch that can be used for asynchronous RTSP

Packit 971217
communication. Free with gst_rtsp_watch_unref() after usage.

Packit 971217
Packit 971217
Packit 971217

Packit 971217
Packit 971217

gst_rtsp_watch_unref ()

Packit 971217
void
Packit 971217
gst_rtsp_watch_unref (GstRTSPWatch *watch);
Packit 971217

Decreases the reference count of watch

Packit 971217
 by one. If the resulting reference
Packit 971217
count is zero the watch and associated memory will be destroyed.

Packit 971217
Packit 971217

Parameters

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

watch

Packit 971217

a GstRTSPWatch

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Packit 971217
Packit 971217

gst_rtsp_watch_attach ()

Packit 971217
guint
Packit 971217
gst_rtsp_watch_attach (GstRTSPWatch *watch,
Packit 971217
                       GMainContext *context);
Packit 971217

Adds a GstRTSPWatch to a context so that it will be executed within that context.

Packit 971217
Packit 971217

Parameters

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

watch

Packit 971217

a GstRTSPWatch

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

context

Packit 971217

a GMainContext (if NULL, the default context will be used)

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Returns

Packit 971217

the ID (greater than 0) for the watch within the GMainContext.

Packit 971217
Packit 971217
Packit 971217

Packit 971217
Packit 971217

gst_rtsp_watch_reset ()

Packit 971217
void
Packit 971217
gst_rtsp_watch_reset (GstRTSPWatch *watch);
Packit 971217

Reset watch

Packit 971217
, this is usually called after gst_rtsp_connection_do_tunnel()
Packit 971217
when the file descriptors of the connection might have changed.

Packit 971217
Packit 971217

Parameters

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

watch

Packit 971217

a GstRTSPWatch

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Packit 971217
Packit 971217

gst_rtsp_watch_send_message ()

Packit 971217
GstRTSPResult
Packit 971217
gst_rtsp_watch_send_message (GstRTSPWatch *watch,
Packit 971217
                             GstRTSPMessage *message,
Packit 971217
                             guint *id);
Packit 971217

Send a message

Packit 971217
 using the connection of the watch
Packit 971217
. If it cannot be sent
Packit 971217
immediately, it will be queued for transmission in watch
Packit 971217
. The contents of
Packit 971217
message
Packit 971217
 will then be serialized and transmitted when the connection of the
Packit 971217
watch
Packit 971217
 becomes writable. In case the message
Packit 971217
 is queued, the ID returned in
Packit 971217
id
Packit 971217
 will be non-zero and used as the ID argument in the message_sent
Packit 971217
callback.

Packit 971217
Packit 971217

Parameters

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

watch

Packit 971217

a GstRTSPWatch

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

message

Packit 971217

a GstRTSPMessage

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

id

Packit 971217

location for a message ID or NULL.

Packit 971217
[out][allow-none]
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Returns

Packit 971217

GST_RTSP_OK on success.

Packit 971217
Packit 971217
Packit 971217

Packit 971217
Packit 971217

gst_rtsp_watch_write_data ()

Packit 971217
GstRTSPResult
Packit 971217
gst_rtsp_watch_write_data (GstRTSPWatch *watch,
Packit 971217
                           const guint8 *data,
Packit 971217
                           guint size,
Packit 971217
                           guint *id);
Packit 971217

Write data

Packit 971217
 using the connection of the watch
Packit 971217
. If it cannot be sent
Packit 971217
immediately, it will be queued for transmission in watch
Packit 971217
. The contents of
Packit 971217
message
Packit 971217
 will then be serialized and transmitted when the connection of the
Packit 971217
watch
Packit 971217
 becomes writable. In case the message
Packit 971217
 is queued, the ID returned in
Packit 971217
id
Packit 971217
 will be non-zero and used as the ID argument in the message_sent
Packit 971217
callback.

Packit 971217

This function will take ownership of data

Packit 971217
 and g_free() it after use.

Packit 971217

If the amount of queued data exceeds the limits set with

Packit 971217
gst_rtsp_watch_set_send_backlog(), this function will return
Packit 971217
GST_RTSP_ENOMEM.

Packit 971217
Packit 971217

Parameters

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

watch

Packit 971217

a GstRTSPWatch

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

data

Packit 971217

the data to queue.

Packit 971217
[array length=size][transfer full]
Packit 971217
Packit 971217
Packit 971217

size

Packit 971217

the size of data

Packit 971217

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

id

Packit 971217

location for a message ID or NULL.

Packit 971217
[out][allow-none]
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Returns

Packit 971217

GST_RTSP_OK on success. GST_RTSP_ENOMEM when the backlog limits

Packit 971217
are reached. GST_RTSP_EINTR when watch
Packit 971217
was flushing.

Packit 971217
Packit 971217
Packit 971217

Packit 971217
Packit 971217

gst_rtsp_watch_get_send_backlog ()

Packit 971217
void
Packit 971217
gst_rtsp_watch_get_send_backlog (GstRTSPWatch *watch,
Packit 971217
                                 gsize *bytes,
Packit 971217
                                 guint *messages);
Packit 971217

Get the maximum amount of bytes and messages that will be queued in watch

Packit 971217
.
Packit 971217
See gst_rtsp_watch_set_send_backlog().

Packit 971217
Packit 971217

Parameters

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

watch

Packit 971217

a GstRTSPWatch

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

bytes

Packit 971217

maximum bytes.

Packit 971217
[out][allow-none]
Packit 971217
Packit 971217
Packit 971217

messages

Packit 971217

maximum messages.

Packit 971217
[out][allow-none]
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Since: 1.2

Packit 971217
Packit 971217

Packit 971217
Packit 971217

gst_rtsp_watch_set_send_backlog ()

Packit 971217
void
Packit 971217
gst_rtsp_watch_set_send_backlog (GstRTSPWatch *watch,
Packit 971217
                                 gsize bytes,
Packit 971217
                                 guint messages);
Packit 971217

Set the maximum amount of bytes and messages that will be queued in watch

Packit 971217
.
Packit 971217
When the maximum amounts are exceeded, gst_rtsp_watch_write_data() and
Packit 971217
gst_rtsp_watch_send_message() will return GST_RTSP_ENOMEM.

Packit 971217

A value of 0 for bytes

Packit 971217
 or messages
Packit 971217
 means no limits.

Packit 971217
Packit 971217

Parameters

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

watch

Packit 971217

a GstRTSPWatch

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

bytes

Packit 971217

maximum bytes

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

messages

Packit 971217

maximum messages

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Since: 1.2

Packit 971217
Packit 971217

Packit 971217
Packit 971217

gst_rtsp_watch_set_flushing ()

Packit 971217
void
Packit 971217
gst_rtsp_watch_set_flushing (GstRTSPWatch *watch,
Packit 971217
                             gboolean flushing);
Packit 971217

When flushing

Packit 971217
 is TRUE, abort a call to gst_rtsp_watch_wait_backlog()
Packit 971217
and make sure gst_rtsp_watch_write_data() returns immediately with
Packit 971217
GST_RTSP_EINTR. And empty the queue.

Packit 971217
Packit 971217

Parameters

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

watch

Packit 971217

a GstRTSPWatch

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

flushing

Packit 971217

new flushing state

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Since: 1.4

Packit 971217
Packit 971217

Packit 971217
Packit 971217

gst_rtsp_watch_wait_backlog ()

Packit 971217
GstRTSPResult
Packit 971217
gst_rtsp_watch_wait_backlog (GstRTSPWatch *watch,
Packit 971217
                             GTimeVal *timeout);
Packit 971217

Wait until there is place in the backlog queue, timeout

Packit 971217
 is reached
Packit 971217
or watch
Packit 971217
 is set to flushing.

Packit 971217

If timeout

Packit 971217
 is NULL this function can block forever. If timeout
Packit 971217
Packit 971217
contains a valid timeout, this function will return GST_RTSP_ETIMEOUT
Packit 971217
after the timeout expired.

Packit 971217

The typically use of this function is when gst_rtsp_watch_write_data

Packit 971217
returns GST_RTSP_ENOMEM. The caller then calls this function to wait for
Packit 971217
free space in the backlog queue and try again.

Packit 971217
Packit 971217

Parameters

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

watch

Packit 971217

a GstRTSPWatch

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

timeout

Packit 971217

a GTimeVal timeout

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Returns

Packit 971217

GST_RTSP_OK when if there is room in queue.

Packit 971217
GST_RTSP_ETIMEOUT when timeout
Packit 971217
was reached.
Packit 971217
GST_RTSP_EINTR when watch
Packit 971217
is flushing
Packit 971217
GST_RTSP_EINVAL when called with invalid parameters.

Packit 971217
Packit 971217

Since: 1.4

Packit 971217
Packit 971217
Packit 971217
Packit 971217

Types and Values

Packit 971217
Packit 971217

GstRTSPConnection

Packit 971217
typedef struct _GstRTSPConnection GstRTSPConnection;
Packit 971217

Opaque RTSP connection object.

Packit 971217
Packit 971217

Packit 971217
Packit 971217

GstRTSPWatch

Packit 971217
typedef struct _GstRTSPWatch GstRTSPWatch;
Packit 971217

Opaque RTSP watch object that can be used for asynchronous RTSP

Packit 971217
operations.

Packit 971217
Packit 971217

Packit 971217
Packit 971217

GstRTSPWatchFuncs

Packit 971217
typedef struct {
Packit 971217
  GstRTSPResult     (*message_received) (GstRTSPWatch *watch, GstRTSPMessage *message,
Packit 971217
                                         gpointer user_data);
Packit 971217
  GstRTSPResult     (*message_sent)     (GstRTSPWatch *watch, guint id,
Packit 971217
                                         gpointer user_data);
Packit 971217
  GstRTSPResult     (*closed)           (GstRTSPWatch *watch, gpointer user_data);
Packit 971217
  GstRTSPResult     (*error)            (GstRTSPWatch *watch, GstRTSPResult result,
Packit 971217
                                         gpointer user_data);
Packit 971217
  GstRTSPStatusCode (*tunnel_start)     (GstRTSPWatch *watch, gpointer user_data);
Packit 971217
  GstRTSPResult     (*tunnel_complete)  (GstRTSPWatch *watch, gpointer user_data);
Packit 971217
  GstRTSPResult     (*error_full)       (GstRTSPWatch *watch, GstRTSPResult result,
Packit 971217
                                         GstRTSPMessage *message, guint id,
Packit 971217
                                         gpointer user_data);
Packit 971217
  GstRTSPResult     (*tunnel_lost)      (GstRTSPWatch *watch, gpointer user_data);
Packit 971217
  GstRTSPResult     (*tunnel_http_response) (GstRTSPWatch *watch,
Packit 971217
                                             GstRTSPMessage *request,
Packit 971217
                                             GstRTSPMessage *response,
Packit 971217
                                             gpointer user_data);
Packit 971217
} GstRTSPWatchFuncs;
Packit 971217
Packit 971217

Callback functions from a GstRTSPWatch.

Packit 971217
Packit 971217

Members

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

message_received ()

Packit 971217

callback when a message was received

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

message_sent ()

Packit 971217

callback when a message was sent

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

closed ()

Packit 971217

callback when the connection is closed

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

error ()

Packit 971217

callback when an error occured

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

tunnel_start ()

Packit 971217

a client started a tunneled connection. The tunnelid of the

Packit 971217
connection must be saved.

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

tunnel_complete ()

Packit 971217

a client finished a tunneled connection. In this callback

Packit 971217
you usually pair the tunnelid of this connection with the saved one using
Packit 971217
gst_rtsp_connection_do_tunnel().

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

error_full ()

Packit 971217

callback when an error occured with more information than

Packit 971217
the error
Packit 971217
callback.

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

tunnel_lost ()

Packit 971217

callback when the post connection of a tunnel is closed.

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

tunnel_http_response ()

Packit 971217

callback when an HTTP response to the GET request

Packit 971217
is about to be sent for a tunneled connection. The response can be
Packit 971217
modified in the callback. Since 1.4.

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

See Also

Packit 971217

gstrtspurl

Packit 971217
Packit 971217
Packit 971217
Packit 971217

Generated by GTK-Doc V1.27
Packit 971217
</body>
Packit 971217
</html>