diff options
Diffstat (limited to 'src/charon/network/socket.h')
-rw-r--r-- | src/charon/network/socket.h | 112 |
1 files changed, 112 insertions, 0 deletions
diff --git a/src/charon/network/socket.h b/src/charon/network/socket.h new file mode 100644 index 000000000..ef60fa7b6 --- /dev/null +++ b/src/charon/network/socket.h @@ -0,0 +1,112 @@ +/** + * @file socket.h + * + * @brief Interface for socket_t. + * + */ + +/* + * Copyright (C) 2006 Tobias Brunner, Daniel Roethlisberger + * Copyright (C) 2005-2006 Martin Willi + * Copyright (C) 2005 Jan Hutter + * Hochschule fuer Technik Rapperswil + * + * 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. See <http://www.fsf.org/copyleft/gpl.txt>. + * + * 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. + */ + +#ifndef SOCKET_H_ +#define SOCKET_H_ + +typedef struct socket_t socket_t; + +#include <library.h> +#include <network/packet.h> +#include <utils/host.h> +#include <utils/linked_list.h> + +/** + * @brief Maximum size of a packet. + * + * 3000 Bytes should be sufficient, see IKEv2 RFC. + * + * @ingroup network + */ +#define MAX_PACKET 3000 + +/** + * @brief Abstraction of all sockets (IPv6/IPv6 send/receive). + * + * All available sockets are bound and the receive function + * reads from them. To allow binding of other daemons (pluto) to + * UDP/500, this implementation uses RAW sockets. An installed + * "Linux socket filter" filters out all non-IKEv2 traffic and handles + * just IKEv2 messages. An other daemon (pluto) must handle all traffic + * seperatly, e.g. ignore IKEv2 traffic, since charon handles that. + * + * @b Constructors: + * - socket_create() + * + * @ingroup network + */ +struct socket_t { + + /** + * @brief Receive a packet. + * + * Reads a packet from the socket and sets source/dest + * appropriately. + * + * @param this socket_t object to work on + * @param packet pinter gets address from allocated packet_t + * @return + * - SUCCESS when packet successfully received + * - FAILED when unable to receive + */ + status_t (*receive) (socket_t *this, packet_t **packet); + + /** + * @brief Send a packet. + * + * Sends a packet to the net using destination from the packet. + * Packet is sent using default routing mechanisms, thus the + * source address in packet is ignored. + * + * @param this socket_t object to work on + * @param packet[out] packet_t to send + * @return + * - SUCCESS when packet successfully sent + * - FAILED when unable to send + */ + status_t (*send) (socket_t *this, packet_t *packet); + + /** + * @brief Destroy sockets. + * + * close sockets and destroy socket_t object + * + * @param this socket_t to destroy + */ + void (*destroy) (socket_t *this); +}; + +/** + * @brief Create a socket_t, wich binds multiple sockets. + * + * @param port port to bind socket to + * @param natt_port port to float to in NAT-T + * @return socket_t object + * + * @ingroup network + */ +socket_t *socket_create(u_int16_t port, u_int16_t natt_port); + + +#endif /*SOCKET_H_*/ |