session.h

Go to the documentation of this file.

/*
 * Copyright 2018 Amazon.com, Inc. or its affiliates. All Rights Reserved.
 *
 * Licensed under the Apache License, Version 2.0 (the "License"). You may not use
 * this file except in compliance with the License. A copy of the License is
 * located at
 *
 *     http://aws.amazon.com/apache2.0/
 *
 * or in the "license" file accompanying this file. This file is distributed on an
 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
 * implied. See the License for the specific language governing permissions and
 * limitations under the License.
 */
 
#ifndef AWS_CRYPTOSDK_SESSION_H
#define AWS_CRYPTOSDK_SESSION_H
 
#include <aws/cryptosdk/materials.h>

 
#ifdef __cplusplus
extern "C" {
#endif
 
struct aws_cryptosdk_session;

enum aws_cryptosdk_mode {
    AWS_CRYPTOSDK_ENCRYPT          = 0x9000,
    AWS_CRYPTOSDK_DECRYPT          = 0x9001,
    AWS_CRYPTOSDK_DECRYPT_UNSIGNED = 0x9002
};

AWS_CRYPTOSDK_API
struct aws_cryptosdk_session *aws_cryptosdk_session_new_from_keyring_2(
    struct aws_allocator *allocator, enum aws_cryptosdk_mode mode, struct aws_cryptosdk_keyring *keyring);

AWS_CRYPTOSDK_API
struct aws_cryptosdk_session *aws_cryptosdk_session_new_from_cmm_2(
    struct aws_allocator *allocator, enum aws_cryptosdk_mode mode, struct aws_cryptosdk_cmm *cmm);

AWS_CRYPTOSDK_API
void aws_cryptosdk_session_destroy(struct aws_cryptosdk_session *session);

AWS_CRYPTOSDK_API
int aws_cryptosdk_session_reset(struct aws_cryptosdk_session *session, enum aws_cryptosdk_mode mode);

AWS_CRYPTOSDK_API
int aws_cryptosdk_session_set_frame_size(struct aws_cryptosdk_session *session, uint32_t frame_size);

AWS_CRYPTOSDK_API
int aws_cryptosdk_session_set_message_size(struct aws_cryptosdk_session *session, uint64_t message_size);

AWS_CRYPTOSDK_API
int aws_cryptosdk_session_set_message_bound(struct aws_cryptosdk_session *session, uint64_t max_message_size);

AWS_CRYPTOSDK_API
int aws_cryptosdk_session_set_commitment_policy(
    struct aws_cryptosdk_session *session, enum aws_cryptosdk_commitment_policy commitment_policy);

AWS_CRYPTOSDK_API
int aws_cryptosdk_session_set_max_encrypted_data_keys(
    struct aws_cryptosdk_session *session, size_t max_encrypted_data_keys);

AWS_CRYPTOSDK_API
int aws_cryptosdk_session_process(
    struct aws_cryptosdk_session *session,
    uint8_t *outp,
    size_t outlen,
    size_t *out_bytes_written,
    const uint8_t *inp,
    size_t inlen,
    size_t *in_bytes_read);

AWS_CRYPTOSDK_API
int aws_cryptosdk_session_process_full(
    struct aws_cryptosdk_session *session,
    uint8_t *outp,
    size_t outlen,
    size_t *out_bytes_written,
    const uint8_t *inp,
    size_t inlen);

AWS_CRYPTOSDK_API
bool aws_cryptosdk_session_is_done(const struct aws_cryptosdk_session *session);

AWS_CRYPTOSDK_API
int aws_cryptosdk_session_get_alg_id(const struct aws_cryptosdk_session *session, enum aws_cryptosdk_alg_id *alg_id);

AWS_CRYPTOSDK_API
void aws_cryptosdk_session_estimate_buf(
    const struct aws_cryptosdk_session *AWS_RESTRICT session,
    size_t *AWS_RESTRICT outbuf_needed,
    size_t *AWS_RESTRICT inbuf_needed);

AWS_CRYPTOSDK_API
const struct aws_hash_table *aws_cryptosdk_session_get_enc_ctx_ptr(const struct aws_cryptosdk_session *session);

AWS_CRYPTOSDK_API
struct aws_hash_table *aws_cryptosdk_session_get_enc_ctx_ptr_mut(struct aws_cryptosdk_session *session);

AWS_CRYPTOSDK_API
const struct aws_array_list *aws_cryptosdk_session_get_keyring_trace_ptr(const struct aws_cryptosdk_session *session);
 
#ifdef __cplusplus
}
#endif
  // doxygen group session
 
#endif