/** @file ../include/netinet/in.h

@internalComponent

*/

/** @struct sockaddr_in

Socket address, internet style.

@publishedAll

@externallyDefinedApi

*/

/** @var sockaddr_in::sin_family

AF_INET. 

*/

/** @var sockaddr_in::sin_port

Port number. . 

*/

/** @var sockaddr_in::sin_addr

IP address. 

*/

/** @var sockaddr_in::sin_zero

There's also this sin_zero field which some people claim must be set to zero. Other people don't claim anything about it (the Linux documentation doesn't even mention it at all), and setting it to zero doesn't seem to be actually necessary. 

So, if you feel like it, set it to zero using memset().

*/

/** @struct  in_addr

Internet address (a structure for historical reasons).

@publishedAll

@externallyDefinedApi

*/

/** @var in_addr::s_addr

s_addr is a 4-byte number that represents one digit in an IP address per byte

*/

/** @typedef  typedef	uint32_t	in_addr_t

Internet address manipulation

@publishedAll

@externallyDefinedApi

*/

/** @typedef  typedef	uint16_t	in_port_t

Internet port manipulation

@publishedAll

@externallyDefinedApi

*/

/** @def IPPROTO_IP

Internet protocol.

@publishedAll

@externallyDefinedApi

*/

/** @def IPPROTO_ICMP	

Control message protocol.

@publishedAll

@externallyDefinedApi

*/

/** @def IPPROTO_TCP

tcp  KProtocolInetTcp 

@publishedAll

@externallyDefinedApi

*/

/** @def IPPROTO_UDP

user datagram protocol KProtocolInetUdp 

@publishedAll

@externallyDefinedApi

*/

/** @def INADDR_ANY

IPv4 local host address.

@publishedAll

@externallyDefinedApi

*/

/** @def INADDR_BROADCAST

IPv4 broadcast address.

@publishedAll

@externallyDefinedApi

*/

/** @fn  bindresvport(int sd, struct sockaddr_in *sin)

@param sd

@param sin

  The bindresvport function is used to bind a socket descriptor to a privileged IP port, i.e. a port with a number in the range 0-1023.

 If sin is a pointer to a struct sockaddr_in the appropriate fields in the structure should be 

  defined. Note that sin-\>sin_family must be initialized to the address 

  family of the socket, passed by sd. If sin-\>sin_port is '0' an anonymous port (in the range 600-1023) will be chosen and, if bind is successful, the sin-\>sin_port will be updated to contain the allocated 

  port.

 If sin is the NULL pointer an anonymous port will be allocated (as above). However, 

  there is no way for bindresvport to return the allocated port in this case.

 The function prototype of bindresvport is biased to AF_INET socket.

Examples:

@code

#include <sys/socket.h>

#include <netinet/in.h>

#include <unistd.h>

void BindResvPort()

{

   int sockfd;

   sockaddr_in selfAddr;

   sockfd = socket(AF_INET,SOCK_STREAM,IPPROTO_TCP);

   selfAddr.sin_family = AF_INET;

   selfAddr.sin_addr.s_addr = INADDR_ANY;

   selfAddr.sin_port = htons(100);

   bindresvport(sockfd, &selfAddr;);

   close(sockfd);

}

@endcode

@return   The bindresvport() function returns the value 0 if successful. Otherwise 

it returns the value -1 and sets the global variable errno to indicate the error.

@see bind()

@see getsockopt()

@see setsockopt()

@publishedAll

@externallyDefinedApi

*/

/** @def IN_BADCLASS(i)

Definitions of bits in internet address integers. 

@publishedAll

@released

*/

/** @def IN_CLASSA(i)

Definitions of bits in internet address integers. On subnets, the decomposition of addresses to host and net parts is done according to subnet mask, not the masks here.

@publishedAll

@released

*/

/** @def IN_CLASSA_NET

Definitions of bits in internet address integers. On subnets, the decomposition of addresses to host and net parts is done according to subnet mask, not the masks here.

@publishedAll

@released

*/

/** @def IN_CLASSA_NSHIFT	

Definitions of bits in internet address integers. On subnets, the decomposition of addresses to host and net parts is done according to subnet mask, not the masks here.

@publishedAll

@released

*/

/** @def IN_CLASSA_HOST

Definitions of bits in internet address integers. On subnets, the decomposition of addresses to host and net parts is done according to subnet mask, not the masks here.

@publishedAll

@released

*/

/** @def IN_CLASSA_MAX	

Definitions of bits in internet address integers. On subnets, the decomposition of addresses to host and net parts is done according to subnet mask, not the masks here.

@publishedAll

@released

*/

/** @def IN_CLASSB(i) 

Definitions of bits in internet address integers. On subnets, the decomposition of addresses to host and net parts is done according to subnet mask, not the masks here.

@publishedAll

@released

*/

/** @def IN_CLASSB_NET

Definitions of bits in internet address integers. On subnets, the decomposition of addresses to host and net parts is done according to subnet mask, not the masks here.

@publishedAll

@released

*/

/** @def IN_CLASSB_NSHIFT

Definitions of bits in internet address integers. On subnets, the decomposition of addresses to host and net parts is done according to subnet mask, not the masks here.

@publishedAll

@released

*/

/** @def IN_CLASSB_HOST	

Definitions of bits in internet address integers. On subnets, the decomposition of addresses to host and net parts is done according to subnet mask, not the masks here.

@publishedAll

@released

*/

/** @def IN_CLASSB_MAX	

Definitions of bits in internet address integers. On subnets, the decomposition of addresses to host and net parts is done according to subnet mask, not the masks here.

@publishedAll

@released

*/

/** @def IN_CLASSC(i)

Definitions of bits in internet address integers. On subnets, the decomposition of addresses to host and net parts is done according to subnet mask, not the masks here.

@publishedAll

@released

*/

/** @def IN_CLASSC_NET	

Definitions of bits in internet address integers. On subnets, the decomposition of addresses to host and net parts is done according to subnet mask, not the masks here.

@publishedAll

@released

*/

/** @def IN_CLASSC_NSHIFT

Definitions of bits in internet address integers. On subnets, the decomposition of addresses to host and net parts is done according to subnet mask, not the masks here.

@publishedAll

@released

*/

/** @def IN_CLASSC_HOST	

Definitions of bits in internet address integers. On subnets, the decomposition of addresses to host and net parts is done according to subnet mask, not the masks here.

@publishedAll

@released

*/

/** @def IN_CLASSD(i)

Definitions of bits in internet address integers. On subnets, the decomposition of addresses to host and net parts is done according to subnet mask, not the masks here.

@publishedAll

@released

*/

/** @def IN_CLASSD_NET

Definitions of bits in internet address integers. On subnets, the decomposition of addresses to host and net parts is done according to subnet mask, not the masks here.

@publishedAll

@released

*/

/** @def IN_CLASSD_NSHIFT

Definitions of bits in internet address integers. On subnets, the decomposition of addresses to host and net parts is done according to subnet mask, not the masks here.

@publishedAll

@released

*/

/** @def IN_CLASSD_HOST

Definitions of bits in internet address integers. On subnets, the decomposition of addresses to host and net parts is done according to subnet mask, not the masks here.

@publishedAll

@released

*/

/** @def IN_EXPERIMENTAL(i)

Definitions of bits in internet address integers. On subnets, the decomposition of addresses to host and net parts is done according to subnet mask, not the masks here.

@publishedAll

@released

*/

/** @def IN_LOOPBACKNET	

Definitions of bits in internet address integers. On subnets, the decomposition of addresses to host and net parts is done according to subnet mask, not the masks here.

@publishedAll

@released

*/

/** @def IN_MULTICAST(i)	

Definitions of bits in internet address integers. On subnets, the decomposition of addresses to host and net parts is done according to subnet mask, not the masks here.

@publishedAll

@released

*/

/** @def INADDR_LOOPBACK

Definitions of bits in internet address integers. On subnets, the decomposition of addresses to host and net parts is done according to subnet mask, not the masks here.

@publishedAll

@released

*/

/** @def INADDR_MAX_LOCAL_GROUP

Definitions of bits in internet address integers.

@publishedAll

@released

*/

/** @def INADDR_NONE	

Definitions of bits in internet address integers.

@publishedAll

@released

*/

/** @def INADDR_UNSPEC_GROUP	

Definitions of bits in internet address integers.

@publishedAll

@released

*/

/** @def INADDR_ALLHOSTS_GROUP

Definitions of bits in internet address integers.

@publishedAll

@released

*/

/** @def IP_DEFAULT_MULTICAST_LOOP

Defaults and limits for options. normally hear sends if a member 

@publishedAll

@released

*/

/** @def IP_DEFAULT_MULTICAST_TTL 

Defaults and limits for options. normally limit m'casts to 1 hop 

@publishedAll

@released

*/

/** @def IP_ADD_MEMBERSHIP

ip_mreq; add an IP group membership

@publishedAll

@released

*/

/** @def IP_DROP_MEMBERSHIP

ip_mreq; drop an IP group membership

@publishedAll

@released

*/

/** @def IP_HDRINCL

int; header is included with data

@publishedAll

@released

*/

/** @struct ip_mreq

Argument structure for IP_ADD_MEMBERSHIP and IP_DROP_MEMBERSHIP.

@publishedAll

@released

*/

/** @var ip_mreq::imr_multiaddr

IP multicast address of group

*/

/** @var ip_mreq::imr_interface

local IP address of interface 

*/

/** @def IP_MULTICAST_IF	

set or get IP multicast interface

@publishedAll

@released

*/

/** @def IP_MULTICAST_LOOP

u_char; set or get IP multicast loopback 

@publishedAll

@released

*/

/** @def IP_MULTICAST_TTL

set or get IP multicast timetolive

@publishedAll

@released

*/

/** @def IP_OPTIONS

Options for use with [gs]etsockopt at the IP level. First word of comment is data type; bool is stored in int.

buf or ip_opts; set or get IP options

@publishedAll

@released

*/

/** @def IP_RECVDSTADDR

Options for use with [gs]etsockopt at the IP level. First word of comment is data type; bool is stored in int.

bool; receive IP dst addr wdgram 

@publishedAll

@released

*/

/** @def IP_RECVOPTS

Options for use with [gs]etsockopt at the IP level. First word of comment is data type; bool is stored in int.

bool; receive all IP opts w dgram 

@publishedAll

@released

*/

/** @def IP_RECVRETOPTS	

Options for use with [gs]etsockopt at the IP level. First word of comment is data type; bool is stored in int.

bool; receive IP opts for response

@publishedAll

@released

*/

/** @def IP_RETOPTS

Options for use with [gs]etsockopt at the IP level. First word of comment is data type; bool is stored in int.

ip_opts; set or get IP options

@publishedAll

@released

*/