socket_send6(3) [debian man page]

socket_send6(3) 					     Library Functions Manual						   socket_send6(3)

NAME

       socket_send6 - send a UDP datagram

SYNTAX

       #include <socket.h>

       ssize_t socket_send6(int s, const char* buf, size_t len,
		const char ip[16], uint16 port, uint32 scope_id);

DESCRIPTION

       socket_send6 sends len bytes starting at buf in a UDP datagram over the socket s to UDP port port on IP address ip.

       You can call socket_send6 without calling socket_bind6.	This has the effect as first calling socket_bind6 with IP address :: and port 0.

       The  meaning  of scope_id is dependent on the implementation and IPv6 IP.  On link-local IPv6 addresses it specifies the outgoing interface
       index.  The name (e.g. "eth0") for a given interface index can be queried with getifname.  scope_id should normally be set to 0.

RETURN VALUE

       socket_send6 returns 0 if the datagram was sent successfully.  If not, it returns -1 and sets errno appropriately.

EXAMPLE

	 #include <socket.h>

	 int s;
	 char ip[16];
	 uint16 p;
	 uint32 scope_id;

	 s = socket_tcp4();
	 socket_bind6(s,ip,p);
	 socket_send6(s,"hello, world",12,ip,p,scope_id);

SEE ALSO

       socket_send4(3), socket_getifidx(3)

																   socket_send6(3)

udp(7)							 Miscellaneous Information Manual						    udp(7)

NAME

       udp - Internet user datagram protocol (UDP)

SYNOPSIS

       #include <sys/socket.h> #include <netinet/in.h>

       The following is the socket call for AF_INET sockets:

       s = socket(AF_INET, SOCK_DGRAM, 0); The following is the socket call for AF_INET6 sockets:

       s = socket(AF_INET6, SOCK_DGRAM, 0);

DESCRIPTION

       UDP  is	a  simple,  unreliable datagram protocol that is used to support the SOCK_DGRAM abstraction for the Internet Protocol family.  UDP
       sockets are connectionless, and are normally used with the sendto() and recvfrom() functions, though the connect()  function  may  also	be
       used to fix the destination for future packets, in which case the recv() or read() and send() or write() functions may be used.

       UDP  address  formats are identical to those used by TCP.  In particular, UDP provides a port identifier in addition to the normal Internet
       address format.	Note that the UDP port space is separate from the TCP port space (that is, a UDP port may not  be  "connected"	to  a  TCP
       port).	In  addition,  IPv4  broadcast	packets may be sent (assuming the underlying network supports this) by using a reserved "broadcast
       address"; this address is network interface dependent.  There is no broadcast address in IPv6.

       Options at the IP transport level may be used with UDP; see the ip() reference page.

ERRORS

       If a socket operation fails, errno may be set to one of the following values: An attempt was made to create a socket with a port  that  has
       already	been  allocated.  An attempt was made to create a socket with a network address for which no network interface exists.	The socket
       is already connected.  This error occurs when trying to establish connection on a socket or when trying to send a datagram with the  desti-
       nation  address	specified.   The  system  ran out of memory for an internal data structure.  The destination address of a datagram was not
       specified, and the socket has not been connected.

RELATED INFORMATION

       Functions: getsockopt(2), recv(2), send(2), socket(2)

       Files: netintro(7), inet(7), ip(7) delim off

																	    udp(7)