File: log_channel.h

package info (click to toggle)
aws-crt-python 0.20.4%2Bdfsg-1~bpo12%2B1
  • links: PTS, VCS
  • area: main
  • in suites:
  • size: 72,656 kB
  • sloc: ansic: 381,805; python: 23,008; makefile: 6,251; sh: 4,536; cpp: 699; ruby: 208; java: 77; perl: 73; javascript: 46; xml: 11
file content (75 lines) | stat: -rw-r--r-- 1,926 bytes parent folder | download | duplicates (2)
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

#ifndef AWS_COMMON_LOG_CHANNEL_H
#define AWS_COMMON_LOG_CHANNEL_H

/**
 * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
 * SPDX-License-Identifier: Apache-2.0.
 */

#include <aws/common/common.h>

#include <aws/common/logging.h>

AWS_PUSH_SANE_WARNING_LEVEL

struct aws_string;
struct aws_log_writer;

/*
 * Log channel interface and default implementations
 *
 * A log channel is an abstraction for the transfer of formatted log data between a source (formatter)
 * and a sink (writer).
 */
struct aws_log_channel;

typedef int(aws_log_channel_send_fn)(struct aws_log_channel *channel, struct aws_string *output);
typedef void(aws_log_channel_clean_up_fn)(struct aws_log_channel *channel);

struct aws_log_channel_vtable {
    aws_log_channel_send_fn *send;
    aws_log_channel_clean_up_fn *clean_up;
};

struct aws_log_channel {
    struct aws_log_channel_vtable *vtable;
    struct aws_allocator *allocator;
    struct aws_log_writer *writer;
    void *impl;
};

AWS_EXTERN_C_BEGIN

/*
 * Simple channel that results in log lines being written in the same thread they were generated in.
 *
 * The passed in log writer is not an ownership transfer.  The log channel does not clean up the writer.
 */
AWS_COMMON_API
int aws_log_channel_init_foreground(
    struct aws_log_channel *channel,
    struct aws_allocator *allocator,
    struct aws_log_writer *writer);

/*
 * Simple channel that sends log lines to a background thread.
 *
 * The passed in log writer is not an ownership transfer.  The log channel does not clean up the writer.
 */
AWS_COMMON_API
int aws_log_channel_init_background(
    struct aws_log_channel *channel,
    struct aws_allocator *allocator,
    struct aws_log_writer *writer);

/*
 * Channel cleanup function
 */
AWS_COMMON_API
void aws_log_channel_clean_up(struct aws_log_channel *channel);

AWS_EXTERN_C_END
AWS_POP_SANE_WARNING_LEVEL

#endif /* AWS_COMMON_LOG_CHANNEL_H */