rama 0.4.0

modular service framework
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143

#include "shim.h"

#include <os/log.h>
#include <os/signpost.h>

void *rama_apple_oslog_create(const char *subsystem, const char *category) {
    return (void *)os_log_create(subsystem, category);
}

void rama_apple_oslog_release(void *log) {
    os_release((os_log_t)log);
}

uint8_t rama_apple_oslog_enabled(void *log, uint8_t type) {
    return os_log_type_enabled((os_log_t)log, (os_log_type_t)type);
}

void rama_apple_oslog_emit(void *log, uint8_t type, const char *message, uint8_t is_public) {
    if (is_public) {
        os_log_with_type((os_log_t)log, (os_log_type_t)type, "%{public}s", message);
    } else {
        os_log_with_type((os_log_t)log, (os_log_type_t)type, "%{private}s", message);
    }
}

void rama_apple_oslog_emit_split(
    void *log,
    uint8_t type,
    const char *public_message,
    const char *private_fields
) {
    os_log_with_type(
        (os_log_t)log,
        (os_log_type_t)type,
        "%{public}s %{private}s",
        public_message,
        private_fields
    );
}

uint8_t rama_apple_oslog_signpost_enabled(void *log) {
    if (__builtin_available(macOS 10.14, iOS 12.0, tvOS 12.0, watchOS 5.0, *)) {
        return os_signpost_enabled((os_log_t)log);
    }
    return 0;
}

uint64_t rama_apple_oslog_signpost_id_generate(void *log) {
    if (__builtin_available(macOS 10.14, iOS 12.0, tvOS 12.0, watchOS 5.0, *)) {
        return os_signpost_id_generate((os_log_t)log);
    }
    return OS_SIGNPOST_ID_NULL;
}

void rama_apple_oslog_signpost_begin(
    void *log,
    uint64_t signpost_id,
    const char *message,
    uint8_t is_public
) {
    if (__builtin_available(macOS 10.14, iOS 12.0, tvOS 12.0, watchOS 5.0, *)) {
        if (is_public) {
            os_signpost_interval_begin(
                (os_log_t)log,
                (os_signpost_id_t)signpost_id,
                "tracing-span",
                "%{public}s",
                message
            );
        } else {
            os_signpost_interval_begin(
                (os_log_t)log,
                (os_signpost_id_t)signpost_id,
                "tracing-span",
                "%{private}s",
                message
            );
        }
    }
}

void rama_apple_oslog_signpost_end(
    void *log,
    uint64_t signpost_id,
    const char *message,
    uint8_t is_public
) {
    if (__builtin_available(macOS 10.14, iOS 12.0, tvOS 12.0, watchOS 5.0, *)) {
        if (is_public) {
            os_signpost_interval_end(
                (os_log_t)log,
                (os_signpost_id_t)signpost_id,
                "tracing-span",
                "%{public}s",
                message
            );
        } else {
            os_signpost_interval_end(
                (os_log_t)log,
                (os_signpost_id_t)signpost_id,
                "tracing-span",
                "%{private}s",
                message
            );
        }
    }
}

void rama_apple_oslog_signpost_begin_split(
    void *log,
    uint64_t signpost_id,
    const char *public_message,
    const char *private_fields
) {
    if (__builtin_available(macOS 10.14, iOS 12.0, tvOS 12.0, watchOS 5.0, *)) {
        os_signpost_interval_begin(
            (os_log_t)log,
            (os_signpost_id_t)signpost_id,
            "tracing-span",
            "%{public}s %{private}s",
            public_message,
            private_fields
        );
    }
}

void rama_apple_oslog_signpost_end_split(
    void *log,
    uint64_t signpost_id,
    const char *public_message,
    const char *private_fields
) {
    if (__builtin_available(macOS 10.14, iOS 12.0, tvOS 12.0, watchOS 5.0, *)) {
        os_signpost_interval_end(
            (os_log_t)log,
            (os_signpost_id_t)signpost_id,
            "tracing-span",
            "%{public}s %{private}s",
            public_message,
            private_fields
        );
    }
}