#ifndef AWS_COMMON_SHARED_LIBRARY_H
#define AWS_COMMON_SHARED_LIBRARY_H

/*
 * Copyright 2010-2019 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.
 */

#include <aws/io/io.h>

struct aws_byte_cursor;

/*
 * A simple platform wrapper for dynamically loading and examining shared libraries
 */
struct aws_shared_library {
    void *library_handle;
};

typedef void (*aws_generic_function)(void);

AWS_EXTERN_C_BEGIN

/*
 * Initializes a dynamically-loaded shared library from its file path location
 */
AWS_IO_API
int aws_shared_library_init(struct aws_shared_library *library, const char *library_path);

/*
 * Closes a dynamically-loaded shared library
 */
AWS_IO_API
void aws_shared_library_clean_up(struct aws_shared_library *library);

/*
 * Finds a function symbol within a shared library.  function_address may be
 * safely cast into any other function type as appropriate.
 */
AWS_IO_API
int aws_shared_library_find_function(
    struct aws_shared_library *library,
    const char *symbol_name,
    aws_generic_function *function_address);

AWS_EXTERN_C_END

#endif /* AWS_COMMON_SHARED_LIBRARY_H */