uIP application functions
[Uip]


Detailed Description

Functions used by an application running of top of uIP.


Defines

#define uip_outstanding(conn)   ((conn)->len)
#define uip_send(data, len)
#define uip_datalen()
#define uip_urgdatalen()
#define uip_close()
#define uip_abort()
#define uip_stop()
#define uip_stopped(conn)
#define uip_restart()
#define uip_newdata()
#define uip_acked()
#define uip_connected()
#define uip_closed()
#define uip_aborted()
#define uip_timedout()
#define uip_rexmit()
#define uip_poll()
#define uip_initialmss()
#define uip_mss()
#define uip_udp_remove(conn)
#define uip_udp_send(len)

Functions

void uip_listen (u16_t port)
void uip_unlisten (u16_t port)
uip_connuip_connect (u16_t *ripaddr, u16_t port)
uip_udp_conn * uip_udp_new (u16_t *ripaddr, u16_t rport)


Define Documentation

 
#define uip_abort  ) 
 

Abort the current connection.

This function will abort (reset) the current connection, and is usually used when an error has occured that prevents using the uip_close() function.

Definition at line 475 of file uip.h.

 
#define uip_aborted  ) 
 

Has the connection been aborted by the other end?

Non-zero if the current connection has been aborted (reset) by the remote host.

Definition at line 564 of file uip.h.

 
#define uip_acked  ) 
 

Has previously sent data been acknowledged?

Will reduce to non-zero if the previously sent data has been acknowledged by the remote host. This means that the application can send new data.

Definition at line 532 of file uip.h.

 
#define uip_close  ) 
 

Close the current connection.

This function will close the current connection in a nice way.

Definition at line 464 of file uip.h.

 
#define uip_closed  ) 
 

Has the connection been closed by the other end?

Is non-zero if the connection has been closed by the remote host. The application may then do the necessary clean-ups.

Definition at line 554 of file uip.h.

 
#define uip_connected  ) 
 

Has the connection just been connected?

Reduces to non-zero if the current connection has been connected to a remote host. This will happen both if the connection has been actively opened (with uip_connect()) or passively opened (with uip_listen()).

Definition at line 544 of file uip.h.

Referenced by example5_app().

 
#define uip_datalen  ) 
 

The length of any incoming data that is currently avaliable (if avaliable) in the uip_appdata buffer.

The test function uip_data() must first be used to check if there is any data available at all.

Definition at line 444 of file uip.h.

 
#define uip_initialmss  ) 
 

Get the initial maxium segment size (MSS) of the current connection.

Definition at line 608 of file uip.h.

 
#define uip_mss  ) 
 

Get the current maxium segment size that can be sent on the current connection.

The current maxiumum segment size that can be sent on the connection is computed from the receiver's window and the MSS of the connection (which also is available by calling uip_initialmss()).

Definition at line 621 of file uip.h.

 
#define uip_newdata  ) 
 

Is new incoming data available?

Will reduce to non-zero if there is new data for the application present at the uip_appdata pointer. The size of the data is avaliable through the uip_len variable.

Definition at line 521 of file uip.h.

Referenced by udp_app().

#define uip_outstanding conn   )     ((conn)->len)
 

Definition at line 406 of file uip.h.

Referenced by uip_process().

 
#define uip_poll  ) 
 

Is the connection being polled by uIP?

Is non-zero if the reason the application is invoked is that the current connection has been idle for a while and should be polled.

The polling event can be used for sending data without having to wait for the remote host to send data.

Definition at line 600 of file uip.h.

 
#define uip_restart  ) 
 

Restart the current connection, if is has previously been stopped with uip_stop().

This function will open the receiver's window again so that we start receiving data for the current connection.

Definition at line 504 of file uip.h.

 
#define uip_rexmit  ) 
 

Do we need to retransmit previously data?

Reduces to non-zero if the previously sent data has been lost in the network, and the application should retransmit it. The application should send the exact same data as it did the last time, using the uip_send() function.

Definition at line 586 of file uip.h.

#define uip_send data,
len   ) 
 

Send data on the current connection.

This function is used to send out a single segment of TCP data. Only applications that have been invoked by uIP for event processing can send data.

The amount of data that actually is sent out after a call to this funcion is determined by the maximum amount of data TCP allows. uIP will automatically crop the data so that only the appropriate amount of data is sent. The function uip_mss() can be used to query uIP for the amount of data that actually will be sent.

Note:
This function does not guarantee that the sent data will arrive at the destination. If the data is lost in the network, the application will be invoked with the uip_rexmit() event being set. The application will then have to resend the data using this function.
Parameters:
data A pointer to the data which is to be sent.
len The maximum amount of data bytes to be sent.

Definition at line 433 of file uip.h.

Referenced by example5_app().

 
#define uip_stop  ) 
 

Tell the sending host to stop sending data.

This function will close our receiver's window so that we stop receiving data for the current connection.

Definition at line 485 of file uip.h.

#define uip_stopped conn   ) 
 

Find out if the current connection has been previously stopped with uip_stop().

Definition at line 493 of file uip.h.

 
#define uip_timedout  ) 
 

Has the connection timed out?

Non-zero if the current connection has been aborted due to too many retransmissions.

Definition at line 574 of file uip.h.

#define uip_udp_remove conn   ) 
 

Removed a UDP connection.

Parameters:
conn A pointer to the uip_udp_conn structure for the connection.

Definition at line 643 of file uip.h.

#define uip_udp_send len   ) 
 

Send a UDP datagram of length len on the current connection.

This function can only be called in response to a UDP event (poll or newdata). The data must be present in the uip_buf buffer, at the place pointed to by the uip_appdata pointer.

Parameters:
len The length of the data in the uip_buf buffer.

Definition at line 656 of file uip.h.

Referenced by udp_app().

 
#define uip_urgdatalen  ) 
 

The length of any out-of-band data (urgent data) that has arrived on the connection.

Note:
The configuration parameter UIP_URGDATA must be set for this function to be enabled.

Definition at line 455 of file uip.h.


Function Documentation

struct uip_conn* uip_connect u16_t ripaddr,
u16_t  port
 

Connect to a remote host using TCP.

This function is used to start a new connection to the specified port on the specied host. It allocates a new connection identifier, sets the connection to the SYN_SENT state and sets the retransmission timer to 0. This will cause a TCP SYN segment to be sent out the next time this connection is periodically processed, which usually is done within 0.5 seconds after the call to uip_connect().

Note:
This function is avaliable only if support for active open has been configured by defining UIP_ACTIVE_OPEN to 1 in uipopt.h.

Since this function requires the port number to be in network byte order, a convertion using HTONS() or htons() is necessary.

 u16_t ipaddr[2];

 uip_ipaddr(ipaddr, 192,168,1,2);
 uip_connect(ipaddr, HTONS(80)); 

Parameters:
ripaddr A pointer to a 4-byte array representing the IP address of the remote hot.
port A 16-bit port number in network byte order.
Returns:
A pointer to the uIP connection identifier for the new connection, or NULL if no connection could be allocated.

Referenced by uip_init().

void uip_listen u16_t  port  ) 
 

Start listening to the specified port.

Note:
Since this function expects the port number in network byte order, a conversion using HTONS() or htons() is necessary.

Parameters:
port A 16-bit port number in network byte order.

Definition at line 326 of file uip.c.

Referenced by example5_init().

struct uip_udp_conn* uip_udp_new u16_t ripaddr,
u16_t  rport
 

Set up a new UDP connection.

Parameters:
ripaddr A pointer to a 4-byte structure representing the IP address of the remote host.
rport The remote port number in network byte order.
Returns:
The uip_udp_conn structure for the new connection or NULL if no connection could be allocated.

Referenced by uip_init().

void uip_unlisten u16_t  port  ) 
 

Stop listening to the specified port.

Note:
Since this function expects the port number in network byte order, a conversion using HTONS() or htons() is necessary.

Parameters:
port A 16-bit port number in network byte order.

Definition at line 315 of file uip.c.


Generated on Fri Jan 6 22:23:19 2006 for EtherProgs by  doxygen 1.4.5