pdi.h

/*******************************************************************************
* Copyright (C) 2015-2021 Commissariat a l'energie atomique et aux energies alternatives (CEA)
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions are met:
* * Redistributions of source code must retain the above copyright
*   notice, this list of conditions and the following disclaimer.
* * Redistributions in binary form must reproduce the above copyright
*   notice, this list of conditions and the following disclaimer in the
*   documentation and/or other materials provided with the distribution.
* * Neither the name of CEA nor the names of its contributors may be used to
*   endorse or promote products derived from this software without specific
*   prior written permission.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
* THE SOFTWARE.
******************************************************************************/
 
#ifndef PDI_H_
#define PDI_H_
 
#include <paraconf.h>
 
#include <pdi/export.h>
#include <pdi/version.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
typedef enum PDI_status_e {
    PDI_OK = 0,
    PDI_UNAVAILABLE,
    PDI_ERR_CONFIG,
    PDI_ERR_VALUE,
    PDI_ERR_PLUGIN,
    PDI_ERR_IMPL,
    PDI_ERR_SYSTEM,
    PDI_ERR_STATE,
    PDI_ERR_RIGHT,
    PDI_ERR_TYPE
 
} PDI_status_t;
 
typedef void (*PDI_errfunc_f)(PDI_status_t status, const char* message, void* context);
 
typedef struct PDI_errhandler_s {
    PDI_errfunc_f func;
 
    void* context;
 
} PDI_errhandler_t;
 
extern const PDI_errhandler_t PDI_EXPORT PDI_ASSERT_HANDLER;
 
extern const PDI_errhandler_t PDI_EXPORT PDI_WARN_HANDLER;
 
extern const PDI_errhandler_t PDI_EXPORT PDI_NULL_HANDLER;
 
 
const char PDI_EXPORT* PDI_errmsg(void);
 
PDI_errhandler_t PDI_EXPORT PDI_errhandler(PDI_errhandler_t handler);
 
 
PDI_status_t PDI_EXPORT PDI_init(PC_tree_t conf);
 
PDI_status_t PDI_EXPORT PDI_finalize(void);
 
PDI_status_t PDI_EXPORT PDI_version(unsigned long* provided, unsigned long expected);
 
 
typedef enum PDI_inout_e {
    PDI_NONE = 0,
    PDI_IN = 1,
    PDI_OUT = 2,
    PDI_INOUT = 3
 
} PDI_inout_t;
 
PDI_status_t PDI_EXPORT PDI_share(const char* name, void* data, PDI_inout_t access);
 
PDI_status_t PDI_EXPORT PDI_access(const char* name, void** buffer, PDI_inout_t inout);
 
PDI_status_t PDI_EXPORT PDI_release(const char* name);
 
PDI_status_t PDI_EXPORT PDI_reclaim(const char* name);
 
PDI_status_t PDI_EXPORT PDI_event(const char* event);
 
PDI_status_t PDI_EXPORT PDI_expose(const char* name, void* data, PDI_inout_t access);
 
PDI_status_t PDI_EXPORT PDI_multi_expose(const char* event_name, const char* name, void* data, PDI_inout_t access, ...);
 
#ifdef PDI_WITH_DEPRECATED
 
PDI_status_t PDI_DEPRECATED_EXPORT PDI_transaction_begin(const char* name);
 
PDI_status_t PDI_DEPRECATED_EXPORT PDI_transaction_end(void);
 
#endif // PDI_WITH_DEPRECATED
 
 
#ifdef __cplusplus
} // extern C
#endif
 
 
#endif // PDI_H_