Return to child_create.h CVS log

Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / strongswan / src / libcharon / sa / ikev2 / tasks

Annotation of embedaddon/strongswan/src/libcharon/sa/ikev2/tasks/child_create.h, revision 1.1

1.1     ! misho       1: /*
        !             2:  * Copyright (C) 2018-2019 Tobias Brunner
        !             3:  * Copyright (C) 2007 Martin Willi
        !             4:  * HSR Hochschule fuer Technik Rapperswil
        !             5:  *
        !             6:  * This program is free software; you can redistribute it and/or modify it
        !             7:  * under the terms of the GNU General Public License as published by the
        !             8:  * Free Software Foundation; either version 2 of the License, or (at your
        !             9:  * option) any later version.  See <http://www.fsf.org/copyleft/gpl.txt>.
        !            10:  *
        !            11:  * This program is distributed in the hope that it will be useful, but
        !            12:  * WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
        !            13:  * or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
        !            14:  * for more details.
        !            15:  */
        !            16: 
        !            17: /**
        !            18:  * @defgroup child_create child_create
        !            19:  * @{ @ingroup tasks_v2
        !            20:  */
        !            21: 
        !            22: #ifndef CHILD_CREATE_H_
        !            23: #define CHILD_CREATE_H_
        !            24: 
        !            25: typedef struct child_create_t child_create_t;
        !            26: 
        !            27: #include <library.h>
        !            28: #include <sa/ike_sa.h>
        !            29: #include <sa/task.h>
        !            30: #include <config/child_cfg.h>
        !            31: 
        !            32: /**
        !            33:  * Task of type TASK_CHILD_CREATE, established a new CHILD_SA.
        !            34:  *
        !            35:  * This task may be included in the IKE_AUTH message or in a separate
        !            36:  * CREATE_CHILD_SA exchange.
        !            37:  */
        !            38: struct child_create_t {
        !            39: 
        !            40:        /**
        !            41:         * Implements the task_t interface
        !            42:         */
        !            43:        task_t task;
        !            44: 
        !            45:        /**
        !            46:         * Use a specific reqid for the CHILD_SA.
        !            47:         *
        !            48:         * When this task is used for rekeying, the same reqid is used
        !            49:         * for the new CHILD_SA.
        !            50:         *
        !            51:         * @param reqid         reqid to use
        !            52:         */
        !            53:        void (*use_reqid) (child_create_t *this, uint32_t reqid);
        !            54: 
        !            55:        /**
        !            56:         * Use specific mark values to override configuration.
        !            57:         *
        !            58:         * @param in            inbound mark value
        !            59:         * @param out           outbound mark value
        !            60:         */
        !            61:        void (*use_marks)(child_create_t *this, uint32_t in, uint32_t out);
        !            62: 
        !            63:        /**
        !            64:         * Use specific interface IDs, overriding configuration.
        !            65:         *
        !            66:         * @param in                    inbound interface ID
        !            67:         * @param out                   outbound interface ID
        !            68:         */
        !            69:        void (*use_if_ids)(child_create_t *this, uint32_t in, uint32_t out);
        !            70: 
        !            71:        /**
        !            72:         * Initially propose a specific DH group to override configuration.
        !            73:         *
        !            74:         * This is used during rekeying to prefer the previously negotiated group.
        !            75:         *
        !            76:         * @param dh_group      DH group to use
        !            77:         */
        !            78:        void (*use_dh_group)(child_create_t *this, diffie_hellman_group_t dh_group);
        !            79: 
        !            80:        /**
        !            81:         * Get the lower of the two nonces, used for rekey collisions.
        !            82:         *
        !            83:         * @return                      lower nonce
        !            84:         */
        !            85:        chunk_t (*get_lower_nonce) (child_create_t *this);
        !            86: 
        !            87:        /**
        !            88:         * Get the CHILD_SA established/establishing by this task.
        !            89:         *
        !            90:         * @return                      child_sa
        !            91:         */
        !            92:        child_sa_t* (*get_child) (child_create_t *this);
        !            93: 
        !            94:        /**
        !            95:         * Enforce a specific CHILD_SA config as responder.
        !            96:         *
        !            97:         * @param cfg           configuration to enforce, reference gets owned
        !            98:         */
        !            99:        void (*set_config)(child_create_t *this, child_cfg_t *cfg);
        !           100: };
        !           101: 
        !           102: /**
        !           103:  * Create a new child_create task.
        !           104:  *
        !           105:  * @param ike_sa               IKE_SA this task works for
        !           106:  * @param config               child_cfg if task initiator, NULL if responder
        !           107:  * @param rekey                        whether we do a rekey or not
        !           108:  * @param tsi                  source of triggering packet, or NULL
        !           109:  * @param tsr                  destination of triggering packet, or NULL
        !           110:  * @return                             child_create task to handle by the task_manager
        !           111:  */
        !           112: child_create_t *child_create_create(ike_sa_t *ike_sa,
        !           113:                                                        child_cfg_t *config, bool rekey,
        !           114:                                                        traffic_selector_t *tsi, traffic_selector_t *tsr);
        !           115: 
        !           116: #endif /** CHILD_CREATE_H_ @}*/