Commit 7de8206d authored by Philip Withnall's avatar Philip Withnall
Browse files

agent: Document interaction between closing and removing streams

GIOStream and nice_agent_remove_stream() interact slightly subtly when
closing down the stream.

parent 9a267fff
......@@ -442,7 +442,10 @@ nice_agent_add_stream (
* @agent: The #NiceAgent Object
* @stream_id: The ID of the stream to remove
* Remove and free a previously created data stream from @agent
* Remove and free a previously created data stream from @agent. If any I/O
* streams have been created using nice_agent_get_io_stream(), they should be
* closed completely using g_io_stream_close() before this is called, or they
* will get broken pipe errors.
......@@ -53,7 +53,8 @@
* If g_io_stream_close() is called on a #NiceIOStream, the I/O stream and
* underlying #NiceAgent stream will be closed in both directions, but the
* underlying stream will not be removed. Use nice_agent_remove_stream() to do
* that.
* that, but only do so after g_io_stream_close() has completed, or the stream
* will return broken pipe errors.
* Since: 0.1.5
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment