mbed TLS library

Dependents:   HTTPClient-SSL WS_SERVER

Embed: (wiki syntax)

« Back to documentation index

net.h File Reference

net.h File Reference

Network communication functions. More...

Go to the source code of this file.

Functions

int net_connect (int *fd, const char *host, int port)
 Initiate a TCP connection with host:port.
int net_bind (int *fd, const char *bind_ip, int port)
 Create a listening socket on bind_ip:port.
int net_accept (int bind_fd, int *client_fd, void *client_ip)
 Accept a connection from a remote client.
int net_set_block (int fd)
 Set the socket blocking.
int net_set_nonblock (int fd)
 Set the socket non-blocking.
void net_usleep (unsigned long usec)
 Portable usleep helper.
int net_recv (void *ctx, unsigned char *buf, size_t len)
 Read at most 'len' characters.
int net_send (void *ctx, const unsigned char *buf, size_t len)
 Write at most 'len' characters.
void net_close (int fd)
 Gracefully shutdown the connection.

Detailed Description

Network communication functions.

Copyright (C) 2006-2011, ARM Limited, All Rights Reserved

This file is part of mbed TLS (https://tls.mbed.org)

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.

Definition in file net.h.


Function Documentation

int net_accept ( int  bind_fd,
int *  client_fd,
void *  client_ip 
)

Accept a connection from a remote client.

Parameters:
bind_fdRelevant socket
client_fdWill contain the connected client socket
client_ipWill contain the client IP address Must be at least 4 bytes, or 16 if IPv6 is supported
Returns:
0 if successful, POLARSSL_ERR_NET_ACCEPT_FAILED, or POLARSSL_ERR_NET_WANT_READ is bind_fd was set to non-blocking and accept() is blocking.

Definition at line 422 of file net.c.

int net_bind ( int *  fd,
const char *  bind_ip,
int  port 
)

Create a listening socket on bind_ip:port.

If bind_ip == NULL, all interfaces are binded.

Parameters:
fdSocket to use
bind_ipIP to bind to, can be NULL
portPort number to use
Returns:
0 if successful, or one of: POLARSSL_ERR_NET_SOCKET_FAILED, POLARSSL_ERR_NET_BIND_FAILED, POLARSSL_ERR_NET_LISTEN_FAILED

Definition at line 256 of file net.c.

void net_close ( int  fd )

Gracefully shutdown the connection.

Parameters:
fdThe socket to close

Definition at line 580 of file net.c.

int net_connect ( int *  fd,
const char *  host,
int  port 
)

Initiate a TCP connection with host:port.

Parameters:
fdSocket to use
hostHost to connect to
portPort to connect to
Returns:
0 if successful, or one of: POLARSSL_ERR_NET_SOCKET_FAILED, POLARSSL_ERR_NET_UNKNOWN_HOST, POLARSSL_ERR_NET_CONNECT_FAILED

Definition at line 170 of file net.c.

int net_recv ( void *  ctx,
unsigned char *  buf,
size_t  len 
)

Read at most 'len' characters.

If no error occurs, the actual amount read is returned.

Parameters:
ctxSocket
bufThe buffer to write to
lenMaximum length of the buffer
Returns:
This function returns the number of bytes received, or a non-zero error code; POLARSSL_ERR_NET_WANT_READ indicates read() is blocking.

Definition at line 518 of file net.c.

int net_send ( void *  ctx,
const unsigned char *  buf,
size_t  len 
)

Write at most 'len' characters.

If no error occurs, the actual amount read is returned.

Parameters:
ctxSocket
bufThe buffer to read from
lenThe length of the buffer
Returns:
This function returns the number of bytes sent, or a non-zero error code; POLARSSL_ERR_NET_WANT_WRITE indicates write() is blocking.

Definition at line 549 of file net.c.

int net_set_block ( int  fd )

Set the socket blocking.

Parameters:
fdSocket to set
Returns:
0 if successful, or a non-zero error code

Definition at line 475 of file net.c.

int net_set_nonblock ( int  fd )

Set the socket non-blocking.

Parameters:
fdSocket to set
Returns:
0 if successful, or a non-zero error code

Definition at line 486 of file net.c.

void net_usleep ( unsigned long  usec )

Portable usleep helper.

Parameters:
usecAmount of microseconds to sleep
Note:
Real amount of time slept will not be less than select()'s timeout granularity (typically, 10ms).

Definition at line 501 of file net.c.