Clear the list of authentication directives stored in conn.
Close the connected conn. After this call, the connection is in the same
state as when it was first created.
Attempt to connect to the url of conn made with
gst_rtsp_connection_create(). If timeout is %NULL this function can block
forever. If timeout contains a valid timeout, this function will return
#GST_RTSP_ETIMEOUT after the timeout expired.
This function can be cancelled with gst_rtsp_connection_flush().
a GTimeVal timeout
Attempt to connect to the url of conn made with
gst_rtsp_connection_create(). If timeout is 0 this function can block
forever. If timeout contains a valid timeout, this function will return
#GST_RTSP_ETIMEOUT after the timeout expired.
This function can be cancelled with gst_rtsp_connection_flush().
a timeout in microseconds
Attempt to connect to the url of conn made with
gst_rtsp_connection_create(). If timeout is %NULL this function can block
forever. If timeout contains a valid timeout, this function will return
#GST_RTSP_ETIMEOUT after the timeout expired. If conn is set to tunneled,
response will contain a response to the tunneling request messages.
This function can be cancelled with gst_rtsp_connection_flush().
a GTimeVal timeout
a #GstRTSPMessage
Attempt to connect to the url of conn made with
gst_rtsp_connection_create(). If timeout is 0 this function can block
forever. If timeout contains a valid timeout, this function will return
#GST_RTSP_ETIMEOUT after the timeout expired. If conn is set to tunneled,
response will contain a response to the tunneling request messages.
This function can be cancelled with gst_rtsp_connection_flush().
a timeout in microseconds
a #GstRTSPMessage
If conn received the first tunnel connection and conn2 received
the second tunnel connection, link the two connections together so that
conn manages the tunneled connection.
After this call, conn2 cannot be used anymore and must be freed with
gst_rtsp_connection_free().
If conn2 is %NULL then only the base64 decoding context will be setup for
conn.
a #GstRTSPConnection or %NULL
Start or stop the flushing action on conn. When flushing, all current
and future actions on conn will return #GST_RTSP_EINTR until the connection
is set to non-flushing mode again.
start or stop the flush
Close and free conn.
Get the ignore_x_server_reply value.
Retrieve the IP address of the other end of conn.
Get the TLS connection of conn.
For client side this will return the #GTlsClientConnection when connected over TLS.
For server side connections, this function will create a GTlsServerConnection when called the first time and will return that same connection on subsequent calls. The server is then responsible for configuring the TLS connection.
Gets the anchor certificate authorities database that will be used after a server certificate can't be verified with the default certificate database.
Gets a #GTlsInteraction object to be used when the connection or certificate database need to interact with the user. This will be used to prompt the user for passwords where necessary.
Gets the TLS validation flags used to verify the peer certificate when a TLS connection is established.
Get the tunnel session id the connection.
Retrieve the URL of the other end of conn.
Get the tunneling state of the connection.
Calculate the next timeout for conn, storing the result in timeout.
a timeout
Calculate the next timeout for conn
Wait up to the specified timeout for the connection to become available for
at least one of the operations specified in events. When the function returns
with #GST_RTSP_OK, revents will contain a bitmask of available operations on
conn.
timeout can be %NULL, in which case this function might block forever.
This function can be cancelled with gst_rtsp_connection_flush().
a bitmask of #GstRTSPEvent flags to check
location for result flags
a timeout
Wait up to the specified timeout for the connection to become available for
at least one of the operations specified in events. When the function returns
with #GST_RTSP_OK, revents will contain a bitmask of available operations on
conn.
timeout can be 0, in which case this function might block forever.
This function can be cancelled with gst_rtsp_connection_flush().
a bitmask of #GstRTSPEvent flags to check
location for result flags
a timeout in microseconds
Attempt to read size bytes into data from the connected conn, blocking up to
the specified timeout. timeout can be %NULL, in which case this function
might block forever.
This function can be cancelled with gst_rtsp_connection_flush().
the data to read
the size of data
a timeout value or %NULL
Attempt to read size bytes into data from the connected conn, blocking up to
the specified timeout. timeout can be 0, in which case this function
might block forever.
This function can be cancelled with gst_rtsp_connection_flush().
the data to read
the size of data
a timeout value in microseconds
Attempt to read into message from the connected conn, blocking up to
the specified timeout. timeout can be %NULL, in which case this function
might block forever.
This function can be cancelled with gst_rtsp_connection_flush().
the message to read
a timeout value or %NULL
Attempt to read into message from the connected conn, blocking up to
the specified timeout. timeout can be 0, in which case this function
might block forever.
This function can be cancelled with gst_rtsp_connection_flush().
the message to read
a timeout value or 0
Reset the timeout of conn.
Attempt to send message to the connected conn, blocking up to
the specified timeout. timeout can be %NULL, in which case this function
might block forever.
This function can be cancelled with gst_rtsp_connection_flush().
the message to send
a timeout value or %NULL
Attempt to send messages to the connected conn, blocking up to
the specified timeout. timeout can be %NULL, in which case this function
might block forever.
This function can be cancelled with gst_rtsp_connection_flush().
the messages to send
a timeout value or %NULL
Attempt to send messages to the connected conn, blocking up to
the specified timeout. timeout can be 0, in which case this function
might block forever.
This function can be cancelled with gst_rtsp_connection_flush().
the messages to send
a timeout value in microseconds
Attempt to send message to the connected conn, blocking up to
the specified timeout. timeout can be 0, in which case this function
might block forever.
This function can be cancelled with gst_rtsp_connection_flush().
the message to send
a timeout value in microseconds
Sets a custom accept-certificate function for checking certificates for
validity. This will directly map to #GTlsConnection 's "accept-certificate"
signal and be performed after the default checks of #GstRTSPConnection
(checking against the #GTlsDatabase with the given #GTlsCertificateFlags)
have failed. If no #GTlsDatabase is set on this connection, only func will
be called.
a #GstRTSPConnectionAcceptCertificateFunc to check certificates
Configure conn for authentication mode method with user and pass as the
user and password respectively.
authentication method
the user
the password
Setup conn with authentication directives. This is not necessary for
methods #GST_RTSP_AUTH_NONE and #GST_RTSP_AUTH_BASIC. For
#GST_RTSP_AUTH_DIGEST, directives should be taken from the digest challenge
in the WWW-Authenticate response header and can include realm, domain,
nonce, opaque, stale, algorithm, qop as per RFC2617.
authentication directive
value
Configure conn to use the specified Content-Length limit.
Both requests and responses are validated. If content-length is
exceeded, ENOMEM error will be returned.
Content-Length limit
By setting the HTTP mode to %TRUE the message parsing will support HTTP messages in addition to the RTSP messages. It will also disable the automatic handling of setting up an HTTP tunnel.
%TRUE to enable manual HTTP mode
Set whether to ignore the x-server-ip-address header reply or not. If the header is ignored, the original address will be used instead.
%TRUE to ignore the x-server-ip-address header reply or %FALSE to comply with it (%FALSE is the default).
Set the IP address of the server.
an ip address
Set the proxy host and port.
the proxy host
the proxy port
Configure conn to use the specified DSCP value.
DSCP value
Sets if the #GstRTSPConnection should remember the session id from the last response received and force it onto any further requests.
The default value is %TRUE
%TRUE if the connection should remember the session id
Sets the anchor certificate authorities database. This certificate database will be used to verify the server's certificate in case it can't be verified with the default certificate database first.
a #GTlsDatabase
Sets a #GTlsInteraction object to be used when the connection or certificate database need to interact with the user. This will be used to prompt the user for passwords where necessary.
a #GTlsInteraction
Sets the TLS validation flags to be used to verify the peer certificate when a TLS connection is established.
the validation flags.
Set the HTTP tunneling state of the connection. This must be configured before
the conn is connected.
the new state
Attempt to write size bytes of data to the connected conn, blocking up to
the specified timeout. timeout can be %NULL, in which case this function
might block forever.
This function can be cancelled with gst_rtsp_connection_flush().
the data to write
the size of data
a timeout value or %NULL
Attempt to write size bytes of data to the connected conn, blocking up to
the specified timeout. timeout can be 0, in which case this function
might block forever.
This function can be cancelled with gst_rtsp_connection_flush().
the data to write
the size of data
a timeout value or 0
Accept a new connection on socket and create a new #GstRTSPConnection for
handling communication on new socket.
a socket
a #GCancellable to cancel the operation
Create a newly allocated #GstRTSPConnection from url and store it in conn.
The connection will not yet attempt to connect to url, use
gst_rtsp_connection_connect().
A copy of url will be made.
a #GstRTSPUrl
Create a new #GstRTSPConnection for handling communication on the existing
socket socket. The initial_buffer contains zero terminated data already
read from socket which should be used before starting to read new data.
a #GSocket
the IP address of the other end
the port used by the other end
data already read from fd
This object manages the RTSP connection to the server. It provides function to receive and send bytes and messages.