kc3-lang/libevent

Diff

  • Show log

    Commit

  • Hash : 33bbbed9
    Author : Nick Mathewson
    Date : 2010-05-13T10:57:30 

    Mark the event_err() functions as __attribute__((noreturn))

This attribute tells gcc (and anything else that understands gcc
attributes) that the functions will never return control, and helps
the optimizer a little.  With luck, it will also tell
less-than-full-program dataflow analysis tools that they don't need to
worry about any code path that involves calling one of these functions
and then returning.

This patch also forces event_exit() to always exit, no matter what the
user-supplied fatal_callback does.  This means that the old unit tests
for the event_err* functions don't work any more, since they assume it
is safe to call event_err* if you've given it a bogus fatal_callback
that doesn't exit.  Instead, we have to make the unit tests fork
before calling event_err(), and have the main unit test process wait
for the event_err() test to exit with a sane exit code.  On unix,
that's trivial.  On windows, let's not bother and just assume that
event_err* works.

  • README

  • 0. BUILDING AND INSTALLATION (Briefly)

$ ./configure
$ make
$ make verify   # (optional)
$ sudo make install

1. BUILDING AND INSTALLATION (In Depth)

To build libevent, type

$ ./configure && make

     (If you got libevent from the git repository, you will
      first need to run the included "autogen.sh" script in order to
      generate the configure script.)

Install as root via

# make install

You can run the regression tests by running

$ make verify

Before, reporting any problems, please run the regression tests.

To enable the low-level tracing build the library as:

   CFLAGS=-DUSE_DEBUG ./configure [...]

Standard configure flags should work.  In particular, see:

   --disable-shared          Only build static libraries
   --prefix                  Install all files relative to this directory.


The configure script also supports the following flags:

   --enable-gcc-warnings     Enable extra compiler checking with GCC.
   --disable-malloc-replacement
                             Don't let applications replace our memory
                             management functions
   --disable-openssl         Disable support for OpenSSL encryption.
   --disable-thread-support  Don't support multithreaded environments.

2. USEFUL LINKS:

For the latest released version of Libevent, see the official website at
http://monkey.org/~provos/libevent/ .

There's a pretty good work-in-progress manual up at
   http://www.wangafu.net/~nickm/libevent-book/ .

For the latest development versions of Libevent, access our Git repository
via
   "git clone git://levent.git.sourceforge.net/gitroot/levent/libevent"

You can browse the git repository online at
http://levent.git.sourceforge.net/git/gitweb-index.cgi .

To report bugs, request features, or submit patches to Libevent,
use the Sourceforge trackers at
https://sourceforge.net/tracker/?group_id=50884 .

There's also a libevent-users mailing list for talking about Libevent
use and development: http://archives.seul.org/libevent/users/

3. ACKNOWLEDGMENTS

The following people have helped with suggestions, ideas, code or
fixing bugs:

  Alejo
  Weston Andros Adamson
  William Ahern
  Stas Bekman
  Ka-Hing Cheung
  Andrew Danforth
  Christopher Davis
  Mike Davis
  Shie Erlich
  Alexander von Gernler
  Artur Grabowski
  Aaron Hopkins
  Tani Hosokawa
  Claudio Jeker
  Valery Kyholodov
  Marko Kreen
  Scott Lamb
  Adam Langley
  Christopher Layne
  Philip Lewis
  David Libenzi
  Moshe Litvin
  Hagne Mahre
  Lubomir Marinov
  Nick Mathewson
  James Mansion
  Andrey Matveev
  Caitlin Mercer
  Trond Norbye
  Richard Nyberg
  Jon Oberheide
  Phil Oleson
  Dave Pacheco
  Tassilo von Parseval
  Pierre Phaneuf
  Ryan Phillips
  Jon Poland
  Bert JW Regeer
  Hanna Schroeter
  Kevin Springborn
  Ferenc Szalai
  Dug Song
  Zack Weinberg
  Taral
  propanbutan
  mmadia

If we have forgotten your name, please contact us.

kmx.io     mail     discord kmxgit v0.4.0