https://github.com/facebookarchive/liblogfaf

A library that logs messages using non-blocking UDP datagrams.
https://github.com/facebookarchive/liblogfaf

Last synced: about 2 months ago
JSON representation

A library that logs messages using non-blocking UDP datagrams.

• Host: GitHub
• URL: https://github.com/facebookarchive/liblogfaf
• Owner: facebookarchive
• License: mit
• Archived: true
• Created: 2014-02-11T17:53:57.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2019-05-20T12:30:55.000Z (over 5 years ago)
• Last Synced: 2024-04-10T05:27:54.420Z (6 months ago)
• Language: C
• Homepage:
• Size: 17.6 KB
• Stars: 374
• Watchers: 37
• Forks: 62
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        
# liblogfaf

Making syslog() not block

liblogfaf (faf stands for fire-and-forget) is a dynamic library that is

designed to be LD_PRELOAD-ed while starting a process that uses openlog() &

syslog() functions to send syslog messages. It overrides logging functions to

make log messages sent as UDP datagrams instead of getting written to /dev/log

(which can block). This is useful for processes that call syslog() as part of

their main execution flow and can therefore be easily broken when /dev/log

buffer gets full, for example when the process that is expected to read from it

(usually system syslog daemon like rsyslog or syslog-ng) stops doing that.

Please note that liblogfaf should *not* be used in an environment where

reliable log message delivery is required.

## Requirements

liblogfaf is known to work on Linux, FreeBSD, and OS X.

## Building and installing liblogfaf

* Ensure you have libtool, autoconf, and automake installed;

* run `autoreconf -i` to generate autoconf and automake files;

* run `./configure`. You can pass the '--enable-debug' option to build

  liblogfaf in debug mode;

* `make` will build everything;

* `make install` will install the library along with the `logfaf` script.

## Using liblogfaf

The library comes with a `logfaf` script that can be used to start any binary

with liblogfaf enabled. For example, if you run:

    echo test | logfaf logger

You should see logger sending syslog UDP messages to 127.0.0.1:514

## License

MIT license