91 lines
2.4 KiB
C
91 lines
2.4 KiB
C
/*
|
|
* Copyright (C) 2006-2010 Tobias Brunner
|
|
* Copyright (C) 2005-2010 Martin Willi
|
|
* Copyright (C) 2006 Daniel Roethlisberger
|
|
* 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.
|
|
*/
|
|
|
|
/**
|
|
* @defgroup socket socket
|
|
* @{ @ingroup network
|
|
*/
|
|
|
|
#ifndef SOCKET_H_
|
|
#define SOCKET_H_
|
|
|
|
typedef struct socket_t socket_t;
|
|
|
|
#include <library.h>
|
|
#include <network/packet.h>
|
|
#include <utils/enumerator.h>
|
|
#include <plugins/plugin.h>
|
|
|
|
/**
|
|
* Constructor prototype for sockets.
|
|
*/
|
|
typedef socket_t *(*socket_constructor_t)();
|
|
|
|
/**
|
|
* Socket interface definition.
|
|
*/
|
|
struct socket_t {
|
|
|
|
/**
|
|
* Receive a packet.
|
|
*
|
|
* Reads a packet from the socket and sets source/dest
|
|
* appropriately.
|
|
*
|
|
* @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);
|
|
|
|
/**
|
|
* Send a packet.
|
|
*
|
|
* Sends a packet to the net using source and destination addresses of
|
|
* the packet.
|
|
*
|
|
* @param packet packet_t to send
|
|
* @return
|
|
* - SUCCESS when packet successfully sent
|
|
* - FAILED when unable to send
|
|
*/
|
|
status_t (*send) (socket_t *this, packet_t *packet);
|
|
|
|
/**
|
|
* Destroy a socket implementation.
|
|
*/
|
|
void (*destroy) (socket_t *this);
|
|
};
|
|
|
|
/**
|
|
* Helper function to (un-)register socket interfaces from plugin features.
|
|
*
|
|
* This function is a plugin_feature_callback_t and can be used with the
|
|
* PLUGIN_CALLBACK macro to register an socket interface constructor.
|
|
*
|
|
* @param plugin plugin registering the socket interface
|
|
* @param feature associated plugin feature
|
|
* @param reg TRUE to register, FALSE to unregister
|
|
* @param data data passed to callback, a socket_constructor_t
|
|
*/
|
|
bool socket_register(plugin_t *plugin, plugin_feature_t *feature,
|
|
bool reg, void *data);
|
|
|
|
#endif /** SOCKET_H_ @}*/
|