PR_NewUDPSocket

Creates a new UDP socket.

Syntax

#include <prio.h>

PRFileDesc* PR_NewUDPSocket(void);

Returns

The function returns one of the following values:

  • Upon successful completion, a pointer to the PRFileDesc object created for the newly opened UDP socket.

  • If the creation of a new UDP socket failed, NULL.

Description

UDP (User Datagram Protocol) is a connectionless, unreliable datagram protocol of the TCP/IP protocol suite. UDP datagrams may be lost or delivered in duplicates or out of sequence.

PR_NewUDPSocket creates a new UDP socket. The socket may be bound to a well-known port number with PR_Bind. Datagrams can be sent with PR_SendTo and received with PR_RecvFrom. When the socket is no longer needed, it should be closed with a call to PR_Close.

See Also

PR_NewUDPSocket is deprecated because it is hardcoded to create an IPv4 UDP socket. New code should use PR_OpenUDPSocket instead, which allows the address family (IPv4 or IPv6) of the new UDP socket to be specified.