strongswan/Source/charon/payloads/payload.h

/**
 * @file payload.h
 * 
 * @brief Generic payload interface
 * 
 * 
 */

/*
 * Copyright (C) 2005 Jan Hutter, Martin Willi
 * 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 PAYLOAD_H_
#define PAYLOAD_H_

#include "encodings.h"
#include "../types.h"
#include "../definitions.h"


/**
 * Payload-Types of a IKEv2-Message
 * 
 * 
 * Header and substructures are also defined as 
 * payload types with values from PRIVATE USE space.
 */
typedef enum payload_type_e payload_type_t;

enum payload_type_e{

	/**
	 * NO_PAYLOAD
	 */
	NO_PAYLOAD = 0,
	
	/**
	 * SA
	 */
	SECURITY_ASSOCIATION = 33,
	/**
	 * KE
	 */
	KEY_EXCHANGE = 34,
	/**
	 * IDi
	 */
	ID_INITIATOR = 35,
	/**
	 * IDr
	 */
	ID_RESPONDER = 36,
	/**
	 * CERT
	 */
	CERTIFICATE = 37,
	/**
	 * CERTREQ
	 */
	CERTIFICATE_REQUEST = 38,
	/**
	 * AUTH
	 */
	AUTHENTICATION = 39,
	/**
	 * Ni, Nr
	 */
	NONCE = 40,
	/**
	 * N
	 */
	NOTIFY = 41,
	/**
	 * D
	 */
	DELETE = 42,
	/**
	 * V
	 */
	VENDOR_ID = 43,
	/**
	 * TSi
	 */
	TRAFFIC_SELECTOR_INITIATOR = 44,
	/**
	 * TSr
	 */
	TRAFFIC_SELECTOR_RESPONDER = 45,
	/**
	 * E
	 */
	ENCRYPTED = 46,
	/**
	 * CP
	 */
	CONFIGURATION = 47,
	/**
	 * EAP
	 */
	EXTENSIBLE_AUTHENTICATION = 48,
	
	/**
	 * Header has value 140 of PRIVATE USE space
	 * 
	 * This payload type is not send over wire and just 
	 * used internally to handle IKEv2-Header like a payload.
	 */
	HEADER = 140
};


/*
 * build string mapping array for payload_type_t
 */
extern mapping_t payload_type_t_mappings[];


/**
 * @brief Generic interface for all payload types (inclusive 
 * header and substructures)
 * 
 * 
 */
typedef struct payload_s payload_t;

struct payload_s {
	/**
	 * @brief Destroys a payload and all included substructures.
	 *
	 * @param this 	payload to destroy
	 * @return 		
	 * 				SUCCESS in any case
	 */
	status_t (*destroy) (payload_t *this);
	
	/**
	 * @brief Get encoding rules for this payload
	 *
	 * @param this 				calling object
	 * @param[out] rules		location to store pointer of first rule
	 * @param[out] rule_count	location to store number of rules
	 * @return 		
	 * 							SUCCESS in any case
	 */
	status_t (*get_encoding_rules) (payload_t *this, encoding_rule_t **rules, size_t *rule_count);

	/**
	 * @brief get type of payload
	 *
	 * @param this 				calling object
	 * @return 					type of this payload
	 */
	payload_type_t (*get_type) (payload_t *this);

	/**
	 * @brief get type of next payload or zero if this is the last one
	 *
	 * @param this 				calling object
	 * @return 					type of next payload
	 */
	payload_type_t (*get_next_type) (payload_t *this);

	/**
	 * @brief get length of payload 
	 *
	 * @param this 				calling object
	 * @return 					length of this payload
	 */
	size_t (*get_length) (payload_t *this);
};

/**
 * @brief Create an empty payload.
 * 
 * Useful for the parser, who wants a generic constructor for all payloads.
 * It supports all payload_t methods.
 * 
 * @param type		type of the payload to create
 * @return			
 * 					- created payload, or
 * 					- NULL if failed
 */
 
payload_t *create_payload(payload_type_t type);

#endif /*PAYLOAD_H_*/