https://github.com/kurotych/logc
A simple thread safe logging library implemented in C99
https://github.com/kurotych/logc
c c99 cplusplus log logger logging logging-library thread-safe
Last synced: 10 months ago
JSON representation
A simple thread safe logging library implemented in C99
- Host: GitHub
- URL: https://github.com/kurotych/logc
- Owner: kurotych
- License: mit
- Created: 2019-11-02T17:13:14.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2019-11-03T09:23:02.000Z (over 6 years ago)
- Last Synced: 2025-04-15T12:47:11.549Z (about 1 year ago)
- Topics: c, c99, cplusplus, log, logger, logging, logging-library, thread-safe
- Language: C
- Homepage:
- Size: 17.6 KB
- Stars: 4
- Watchers: 1
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# logc
A simple thread safe logging library implemented in C99
## Fork of [log.c](https://github.com/rxi/log.c)
### Main changes
- Fix concurrency vulnerabilities
- Thread safe by default (The code should be compiled with -pthread flag)
- Call abort() after fatal log
- Color print by default
## Usage
**[log.c](src/log.c?raw=1)** and **[log.h](src/log.h?raw=1)** should be dropped
into an existing project and compiled along with it. The library provides 6
function-like macros for logging:
```c
log_trace(const char *fmt, ...);
log_debug(const char *fmt, ...);
log_info(const char *fmt, ...);
log_warn(const char *fmt, ...);
log_error(const char *fmt, ...);
log_fatal(const char *fmt, ...);
```
Each function takes a printf format string followed by additional arguments:
```c
log_trace("Hello %s", "world")
```
Resulting in a line with the given format printed to stderr:
```
20:18:26 TRACE src/main.c:11: Hello world
```
## Test build
```
gcc -o test -Wall test.c ./src/log.c -pthread
```
#### log_quiet_set(int enable)
Quiet-mode can be enabled by passing `1` to the `log_set_quiet()` function.
While this mode is enabled the library will not output anything to stderr, but
will continue to write to the file if one is set.
#### log_level_set(int level)
The current logging level can be set by using the `log_set_level()` function.
All logs below the given level will be ignored. By default the level is
`LOG_TRACE`, such that nothing is ignored.
#### log_multithreading(bool enable);
Multithreaded mode is enabled by default.
Set false only if your program is single threaded.
#### log_file_open(const char* file_path)
The data written to the file output is of the following format:
```
2047-03-11 20:18:26 TRACE src/main.c:11: Hello world
```
#### log_file_close()
Close log file stream.
#### LOG_NO_USE_COLOR
If the library is compiled with `-DLOG_NO_USE_COLOR` ANSI color escape codes will
not be used when printing.
## License
This library is free software; you can redistribute it and/or modify it under
the terms of the MIT license. See [LICENSE](LICENSE) for details.