Skip to content
This repository has been archived by the owner on Jun 12, 2019. It is now read-only.
/ liblogfaf Public archive

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

License

Notifications You must be signed in to change notification settings

facebookarchive/liblogfaf

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

21 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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

About

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

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published