mirrors/gstreamer
mirrors/gstreamer
1
1
Fork 0
mirror of https://gitlab.freedesktop.org/gstreamer/gstreamer.git synced 2024-11-25 11:11:08 +00:00
Code Issues 1 Projects Releases Wiki Activity

netbuffer: document that the port is network order

Browse source 
Document the fact that we store the port number in network order in
GstNetAddress and that the caller should byteswap appropriately.
This commit is contained in:
Wim Taymans 2009-05-26 15:37:18 +02:00
parent 2e5c946501
commit 796f8e2f76
1 changed files with 18 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

18
gst-libs/gst/netbuffer/gstnetbuffer.c
View file

@ -137,6 +137,9 @@ gst_netbuffer_new (void)
* @port: a port number to set.
*
* Set @naddr with the IPv4 @address and @port pair.
*
* Note that @port must be expressed in network byte order, use g_htons() to convert
* it to network byte order order.
*/
void
gst_netaddress_set_ip4_address (GstNetAddress * naddr, guint32 address,
@ -156,6 +159,9 @@ gst_netaddress_set_ip4_address (GstNetAddress * naddr, guint32 address,
* @port: a port number to set.
*
* Set @naddr with the IPv6 @address and @port pair.
*
* Note that @port must be expressed in network byte order, use g_htons() to convert
* it to network byte order order.
*/
void
gst_netaddress_set_ip6_address (GstNetAddress * naddr, guint8 address[16],
@ -193,6 +199,9 @@ gst_netaddress_get_net_type (GstNetAddress * naddr)
* Get the IPv4 address stored in @naddr into @address. This function requires
* that the address type of @naddr is of type #GST_NET_TYPE_IP4.
*
* Note that @port is expressed in network byte order, use g_ntohs() to convert
* it to host order.
*
* Returns: TRUE if the address could be retrieved.
*/
gboolean
@ -223,6 +232,9 @@ gst_netaddress_get_ip4_address (GstNetAddress * naddr, guint32 * address,
* If @naddr is of type GST_NET_TYPE_IP4, the transitional IP6 address is
* returned.
*
* Note that @port is expressed in network byte order, use g_ntohs() to convert
* it to host order.
*
* Returns: TRUE if the address could be retrieved.
*/
gboolean
@ -258,6 +270,9 @@ gst_netaddress_get_ip6_address (GstNetAddress * naddr, guint8 address[16],
*
* Get just the address bytes stored in @naddr into @address.
*
* Note that @port is expressed in network byte order, use g_ntohs() to convert
* it to host order.
*
* Returns: number of bytes actually copied
*
* Since: 0.10.22
@ -296,6 +311,9 @@ gst_netaddress_get_address_bytes (GstNetAddress * naddr, guint8 address[16],
*
* Set just the address bytes stored in @naddr into @address.
*
* Note that @port must be expressed in network byte order, use g_htons() to convert
* it to network byte order order.
*
* Returns: number of bytes actually copied
*
* Since: 0.10.22