diff options
Diffstat (limited to 'Source/charon/network/socket.h')
-rw-r--r-- | Source/charon/network/socket.h | 22 |
1 files changed, 15 insertions, 7 deletions
diff --git a/Source/charon/network/socket.h b/Source/charon/network/socket.h index 752e5d62b..8a00e88b0 100644 --- a/Source/charon/network/socket.h +++ b/Source/charon/network/socket.h @@ -31,7 +31,7 @@ /** * @brief Maximum size of a packet. * - * 3000 Bytes should be sufficient, see IKEv2 draft + * 3000 Bytes should be sufficient, see IKEv2 draft. * * @ingroup network */ @@ -45,6 +45,13 @@ typedef struct socket_t socket_t; * * Receiver reads from here, sender writes to here. * + * @b Constructors: + * - socket_create() + * + * @todo add IPv6 support + * + * @todo allow listening/sending to multiple sockets, depending on address + * * @ingroup network */ struct socket_t { @@ -57,8 +64,9 @@ struct socket_t { * * @param sock socket_t object to work on * @param packet pinter gets address from allocated packet_t - * @return FAILED when unable to receive - * SUCCESS when packet successfully received + * @return + * - SUCCESS when packet successfully received + * - FAILED when unable to receive */ status_t (*receive) (socket_t *sock, packet_t **packet); @@ -70,8 +78,9 @@ struct socket_t { * * @param sock socket_t object to work on * @param packet[out] packet_t to send - * @return FAILED when unable to send - * SUCCESS when packet successfully sent + * @return + * - SUCCESS when packet successfully sent + * - FAILED when unable to send */ status_t (*send) (socket_t *sock, packet_t *packet); @@ -81,7 +90,6 @@ struct socket_t { * close sockets and destroy socket_t object * * @param sock socket_t to destroy - * @return SUCCESS */ void (*destroy) (socket_t *sock); }; @@ -93,7 +101,7 @@ struct socket_t { * on port. * * @param port port to bind socket to - * @return the created socket, or NULL on error + * @return socket_t object * * @ingroup network */ |