strongswan/src/libtls/tls_peer.h

59 lines
1.6 KiB
C

/*
* Copyright (C) 2010 Martin Willi
* Copyright (C) 2010 revosec AG
*
* 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 tls_peer tls_peer
* @{ @ingroup libtls
*/
#ifndef TLS_PEER_H_
#define TLS_PEER_H_
typedef struct tls_peer_t tls_peer_t;
#include "tls_handshake.h"
#include "tls_crypto.h"
#include <library.h>
/**
* TLS handshake protocol handler as peer.
*/
struct tls_peer_t {
/**
* Implements the TLS handshake protocol handler.
*/
tls_handshake_t handshake;
};
/**
* Create a tls_peer instance.
*
* If a peer identity is given, but the client does not get requested or is
* otherwise unable to perform client authentication, NULL is returned in
* tls_handshake_t.get_peer_id() instead of the peer identity.
*
* @param tls TLS stack
* @param crypto TLS crypto helper
* @param alert TLS alert handler
* @param peer peer identity, NULL to skip client authentication
* @param server server identity
*/
tls_peer_t *tls_peer_create(tls_t *tls, tls_crypto_t *crypto, tls_alert_t *alert,
identification_t *peer, identification_t *server);
#endif /** TLS_PEER_H_ @}*/