mbed TLS v2.2.0
|
Network communication functions.
Copyright (C) 2006-2015, ARM Limited, All Rights Reserved SPDX-License-Identifier: Apache-2.0
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
This file is part of mbed TLS (https://tls.mbed.org)
Definition in file net.h.
#include <config-sl-crypto-all-acceleration.h>
#include "ssl.h"
#include <stddef.h>
#include <stdint.h>
Go to the source code of this file.
Data Structures | |
struct | mbedtls_net_context |
Wrapper type for sockets. More... | |
Macros | |
#define | MBEDTLS_ERR_NET_SOCKET_FAILED -0x0042 |
Failed to open a socket. More... | |
#define | MBEDTLS_ERR_NET_CONNECT_FAILED -0x0044 |
The connection to the given server / port failed. More... | |
#define | MBEDTLS_ERR_NET_BIND_FAILED -0x0046 |
Binding of the socket failed. More... | |
#define | MBEDTLS_ERR_NET_LISTEN_FAILED -0x0048 |
Could not listen on the socket. More... | |
#define | MBEDTLS_ERR_NET_ACCEPT_FAILED -0x004A |
Could not accept the incoming connection. More... | |
#define | MBEDTLS_ERR_NET_RECV_FAILED -0x004C |
Reading information from the socket failed. More... | |
#define | MBEDTLS_ERR_NET_SEND_FAILED -0x004E |
Sending information through the socket failed. More... | |
#define | MBEDTLS_ERR_NET_CONN_RESET -0x0050 |
Connection was reset by peer. More... | |
#define | MBEDTLS_ERR_NET_UNKNOWN_HOST -0x0052 |
Failed to get an IP address for the given hostname. More... | |
#define | MBEDTLS_ERR_NET_BUFFER_TOO_SMALL -0x0043 |
Buffer is too small to hold the data. More... | |
#define | MBEDTLS_ERR_NET_INVALID_CONTEXT -0x0045 |
The context is invalid, eg because it was free()ed. More... | |
#define | MBEDTLS_NET_LISTEN_BACKLOG 10 |
The backlog that listen() should use. More... | |
#define | MBEDTLS_NET_PROTO_TCP 0 |
The TCP transport protocol. More... | |
#define | MBEDTLS_NET_PROTO_UDP 1 |
The UDP transport protocol. More... | |
Functions | |
void | mbedtls_net_init (mbedtls_net_context *ctx) |
Initialize a context Just makes the context ready to be used or freed safely. More... | |
int | mbedtls_net_connect (mbedtls_net_context *ctx, const char *host, const char *port, int proto) |
Initiate a connection with host:port in the given protocol. More... | |
int | mbedtls_net_bind (mbedtls_net_context *ctx, const char *bind_ip, const char *port, int proto) |
Create a receiving socket on bind_ip:port in the chosen protocol. More... | |
int | mbedtls_net_accept (mbedtls_net_context *bind_ctx, mbedtls_net_context *client_ctx, void *client_ip, size_t buf_size, size_t *ip_len) |
Accept a connection from a remote client. More... | |
int | mbedtls_net_set_block (mbedtls_net_context *ctx) |
Set the socket blocking. More... | |
int | mbedtls_net_set_nonblock (mbedtls_net_context *ctx) |
Set the socket non-blocking. More... | |
void | mbedtls_net_usleep (unsigned long usec) |
Portable usleep helper. More... | |
int | mbedtls_net_recv (void *ctx, unsigned char *buf, size_t len) |
Read at most 'len' characters. More... | |
int | mbedtls_net_send (void *ctx, const unsigned char *buf, size_t len) |
Write at most 'len' characters. More... | |
int | mbedtls_net_recv_timeout (void *ctx, unsigned char *buf, size_t len, uint32_t timeout) |
Read at most 'len' characters, blocking for at most 'timeout' seconds. More... | |
void | mbedtls_net_free (mbedtls_net_context *ctx) |
Gracefully shutdown the connection and free associated data. More... | |
#define MBEDTLS_ERR_NET_ACCEPT_FAILED -0x004A |
#define MBEDTLS_ERR_NET_BIND_FAILED -0x0046 |
#define MBEDTLS_ERR_NET_BUFFER_TOO_SMALL -0x0043 |
#define MBEDTLS_ERR_NET_CONN_RESET -0x0050 |
#define MBEDTLS_ERR_NET_CONNECT_FAILED -0x0044 |
#define MBEDTLS_ERR_NET_INVALID_CONTEXT -0x0045 |
#define MBEDTLS_ERR_NET_LISTEN_FAILED -0x0048 |
#define MBEDTLS_ERR_NET_RECV_FAILED -0x004C |
#define MBEDTLS_ERR_NET_SEND_FAILED -0x004E |
#define MBEDTLS_ERR_NET_SOCKET_FAILED -0x0042 |
#define MBEDTLS_ERR_NET_UNKNOWN_HOST -0x0052 |
#define MBEDTLS_NET_LISTEN_BACKLOG 10 |
int mbedtls_net_accept | ( | mbedtls_net_context * | bind_ctx, |
mbedtls_net_context * | client_ctx, | ||
void * | client_ip, | ||
size_t | buf_size, | ||
size_t * | ip_len | ||
) |
Accept a connection from a remote client.
bind_ctx | Relevant socket |
client_ctx | Will contain the connected client socket |
client_ip | Will contain the client IP address |
buf_size | Size of the client_ip buffer |
ip_len | Will receive the size of the client IP written |
int mbedtls_net_bind | ( | mbedtls_net_context * | ctx, |
const char * | bind_ip, | ||
const char * | port, | ||
int | proto | ||
) |
Create a receiving socket on bind_ip:port in the chosen protocol.
If bind_ip == NULL, all interfaces are bound.
ctx | Socket to use |
bind_ip | IP to bind to, can be NULL |
port | Port number to use |
proto | Protocol: MBEDTLS_NET_PROTO_TCP or MBEDTLS_NET_PROTO_UDP |
int mbedtls_net_connect | ( | mbedtls_net_context * | ctx, |
const char * | host, | ||
const char * | port, | ||
int | proto | ||
) |
Initiate a connection with host:port in the given protocol.
ctx | Socket to use |
host | Host to connect to |
port | Port to connect to |
proto | Protocol: MBEDTLS_NET_PROTO_TCP or MBEDTLS_NET_PROTO_UDP |
void mbedtls_net_free | ( | mbedtls_net_context * | ctx | ) |
Gracefully shutdown the connection and free associated data.
ctx | The context to free |
void mbedtls_net_init | ( | mbedtls_net_context * | ctx | ) |
Initialize a context Just makes the context ready to be used or freed safely.
ctx | Context to initialize |
int mbedtls_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.
ctx | Socket |
buf | The buffer to write to |
len | Maximum length of the buffer |
int mbedtls_net_recv_timeout | ( | void * | ctx, |
unsigned char * | buf, | ||
size_t | len, | ||
uint32_t | timeout | ||
) |
Read at most 'len' characters, blocking for at most 'timeout' seconds.
If no error occurs, the actual amount read is returned.
ctx | Socket |
buf | The buffer to write to |
len | Maximum length of the buffer |
timeout | Maximum number of milliseconds to wait for data 0 means no timeout (wait forever) |
int mbedtls_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.
ctx | Socket |
buf | The buffer to read from |
len | The length of the buffer |
int mbedtls_net_set_block | ( | mbedtls_net_context * | ctx | ) |
Set the socket blocking.
ctx | Socket to set |
int mbedtls_net_set_nonblock | ( | mbedtls_net_context * | ctx | ) |
Set the socket non-blocking.
ctx | Socket to set |
void mbedtls_net_usleep | ( | unsigned long | usec | ) |
Portable usleep helper.
usec | Amount of microseconds to sleep |