darshan-core.h 2.28 KB
Newer Older
1
/*
Shane Snyder's avatar
Shane Snyder committed
2 3 4
 * Copyright (C) 2015 University of Chicago.
 * See COPYRIGHT notice in top-level directory.
 *
5 6 7 8 9 10 11 12 13
 */

#ifndef __DARSHAN_CORE_H
#define __DARSHAN_CORE_H

#include <unistd.h>
#include <sys/types.h>
#include <stdint.h>

Shane Snyder's avatar
Shane Snyder committed
14 15
#include "uthash.h"
#include "darshan-log-format.h"
16

17 18
/* Environment variable to override __DARSHAN_JOBID */
#define DARSHAN_JOBID_OVERRIDE "DARSHAN_JOBID"
19

20 21
/* Environment variable to override __DARSHAN_LOG_PATH */
#define DARSHAN_LOG_PATH_OVERRIDE "DARSHAN_LOGPATH"
22

23 24
/* Environment variable to override __DARSHAN_LOG_HINTS */
#define DARSHAN_LOG_HINTS_OVERRIDE "DARSHAN_LOGHINTS"
25

26 27
/* Environment variable to override __DARSHAN_MEM_ALIGNMENT */
#define DARSHAN_MEM_ALIGNMENT_OVERRIDE "DARSHAN_MEMALIGN"
28

29 30
/* Environment variable to override memory per module */
#define DARSHAN_MOD_MEM_OVERRIDE "DARSHAN_MODMEM"
31

32 33 34
/* Maximum amount of memory per instrumentation module in MiB */
#ifdef __DARSHAN_MOD_MEM_MAX
#define DARSHAN_MOD_MEM_MAX (__DARSHAN_MOD_MEM_MAX * 1024 * 1024)
35
#else
36
#define DARSHAN_MOD_MEM_MAX (2 * 1024 * 1024) /* 2 MiB default */
37
#endif
38

39 40
#define DARSHAN_RECORD_BUF_SIZE (1024 * 100) /* store 1024 records, each of at most 100 bytes */

41 42
/* Default runtime compression buffer size */
#define DARSHAN_COMP_BUF_SIZE DARSHAN_MOD_MEM_MAX
43

44
/* in memory structure to keep up with job level data */
45
struct darshan_core_runtime
46
{
47 48 49
    struct darshan_header *log_hdr_p;
    struct darshan_job *log_job_p;
    char *log_exemnt_p;
50 51
    void *log_rec_p;
    void *log_mod_p;
52

53
    struct darshan_core_record_ref *rec_hash;
54 55
    int rec_hash_sz;
    int rec_hash_cnt;
56
    struct darshan_core_module* mod_array[DARSHAN_MAX_MODS];
57
    char comp_buf[DARSHAN_COMP_BUF_SIZE]; /* TODO: why is this allocated statically? only used in shutdown */
58
    double wtime_offset;
59 60
};

Shane Snyder's avatar
Shane Snyder committed
61 62 63 64 65 66
struct darshan_core_module
{
    darshan_module_id id;
    struct darshan_module_funcs mod_funcs;
};

67 68
struct darshan_core_record_ref
{
69
    struct darshan_record rec;
70 71
    uint64_t mod_flags;
    uint64_t global_mod_flags;
72
    UT_hash_handle hlink;
73
};
74

Shane Snyder's avatar
Shane Snyder committed
75 76 77
void darshan_core_initialize(int argc, char **argv);
void darshan_core_shutdown(void);

78 79 80
uint32_t darshan_hashlittle(const void *key, size_t length, uint32_t initval);
uint64_t darshan_hash(const register unsigned char *k, register uint64_t length, register uint64_t level);

81
#endif /* __DARSHAN_CORE_H */