Server : Apache/2.4.41 (Ubuntu) System : Linux absol.cf 5.4.0-198-generic #218-Ubuntu SMP Fri Sep 27 20:18:53 UTC 2024 x86_64 User : www-data ( 33) PHP Version : 7.4.33 Disable Function : pcntl_alarm,pcntl_fork,pcntl_waitpid,pcntl_wait,pcntl_wifexited,pcntl_wifstopped,pcntl_wifsignaled,pcntl_wifcontinued,pcntl_wexitstatus,pcntl_wtermsig,pcntl_wstopsig,pcntl_signal,pcntl_signal_get_handler,pcntl_signal_dispatch,pcntl_get_last_error,pcntl_strerror,pcntl_sigprocmask,pcntl_sigwaitinfo,pcntl_sigtimedwait,pcntl_exec,pcntl_getpriority,pcntl_setpriority,pcntl_async_signals,pcntl_unshare, Directory :  /var/lib/gems/2.5.0/gems/eventmachine-le-1.1.7/

Upload File : current_dir [ Writeable ] document_root [ Writeable ]

# EventMachine-LE #

EventMachine-LE (Live Edition) is a branch of [EventMachine](http://github.com/eventmachine/eventmachine) with fixes and more features.

[![Build Status](https://travis-ci.org/ibc/EventMachine-LE.png?branch=master)](https://travis-ci.org/ibc/EventMachine-LE)


## What do you mean by "branch"? ##

Well, outside the narrower git circles, "fork" has all these negative
connotations, as in bad feelings after an argument, marriages
divorcing, nation states splitting after a civil war, people hating
each other.  This is not at all the point here, so let's call this
fork a "branch".

## Purpose of this branch ##

This branch incorporates interesting pull requests that are not yet
included in the mainline EventMachine repository.  The maintainers of
that version prefer to minimize change in order to keep the stability
with already existing EventMachine deployments, which provides an
impressive multi-platform base for IPv4 TCP servers (e.g., Web
servers) that don't need good UDP or IPv6 support.

This dedication to stability is helpful for production use, but can
also lead to ossification.  The present "Live Edition" or "Leading
Edge" branch has its focus on supporting a somewhat wider use,
including new Web servers or protocols beyond the HTTP Web.

To provide even more focus, this branch is currently applying its
energy towards Linux and Unix/BSD/OSX environments.  Java reactor and
pure Ruby reactor are for now removed in this branch, and
Windows/Cygwin support is untested.  This may very well change later,
once interesting pull requests come in.

EventMachine-LE draws from a number of dormant pull requests on the
mainline version of EventMachine.  New proposals will also directly
come to EventMachine-LE and will be included once they are tested.

This is not a "development branch" — we do use EventMachine-LE in production,
just beyond the focus of mainline EventMachine.

The intention is that EventMachine-LE is always a drop-in replacement
for EventMachine, just with additional (and fixed) functionality.


## Features and changes ##

The list of additions and improvements will grow over time. Currently the following features/fixes have been applied in EventMachine-LE:


### Version 1.1.6

* Avoid CPU at 100% when calling `close_connection` after a connection has been `unbind`: [ept](https://github.com/ibc/EventMachine-LE/pull/18).


### Version 1.1.5

* Fix bug when the system time is changed to earlier time (which made EM to eat up the CPU cycle): [commit in EM](https://github.com/eventmachine/eventmachine/commit/1427a2c80c401d841194132a9af15baefd68b5ae).
* Fix crash on attach/detach in the same tick ([pietern](https://github.com/eventmachine/eventmachine/pull/427)).
* Fix `EM.system` when unicode characters used ([funny-falcon](https://github.com/eventmachine/eventmachine/pull/322)).
* Fix SMTP server behaviour to reset mail transaction state after sending message ([jonasschneider](https://github.com/eventmachine/eventmachine/pull/351)).


### Version 1.1.4 and below

* Full IPv6 support for TCP and UDP, in both server and client mode ([cabo]([https://github.com/eventmachine/eventmachine/pull/297)).
* Added robustness to datagram sockets, which now can optionally not to get destroyed on the first error by setting `EM::Connection#send_error_handling=mode` ([cabo]([https://github.com/eventmachine/eventmachine/pull/297)).
* `EM::attach_server` added ([ramonmaruko](https://github.com/eventmachine/eventmachine/pull/271)).
* `EM::RestartableTimer` added ([adzap](https://github.com/eventmachine/eventmachine/pull/114)).
* `EM::get_max_timers` and `EM::set_max_timers` are removed (they still exist but do nothing). This solves the annoying "RuntimeError: max timers exceeded" exception.
* Support for Enumerable in `EM::Iterator` ([fl00r](https://github.com/eventmachine/eventmachine/pull/300)).
* Improvements to `EM::Protocols::LineProtocol` and have it autoload ([gaffneyc](https://github.com/eventmachine/eventmachine/pull/151)).
* `EM::Protocols::SmtpServer`: support multiple messages per one connection and login auth type ([bogdan](https://github.com/eventmachine/eventmachine/pull/288)).
* Reimplement `EM::Queue` to avoid shift/push performance problem ([grddev](https://github.com/eventmachine/eventmachine/pull/311)).
* Many code cleanups.
* New `EM::Connection` option for `start_tls()` method: `:ssl_version` (valid values are `:SSLv23`, `:SSLv3` and `:TLSv1`, default value is `:SSLv23`).
* New `EM::Connection` option for `start_tls()` method: `:cipher_list` (valid values are any [OpenSSL cipher string](http://www.openssl.org/docs/apps/ciphers.html#CIPHER_LIST_FORMAT), default value is `"ALL:!ADH:!LOW:!EXP:!DES-CBC3-SHA:@STRENGTH"`).


## Installation ##

Install the current stable version of EventMachine-LE:
<pre>
gem install eventmachine-le
</pre>

If you want the last beta version (not fully tested) install it by using `--pre` option:
<pre>
gem install eventmachine-le --pre
</pre>


## Usage ##

Using EventMachine-LE within your project just requires loading it as follows:
<pre>
# First load EventMachine-LE.
require "eventmachine-le"

# NOTE: It does not hurt to call "require 'eventmachine'" later
# (it has no effect at all).

# Then load any other Ruby Gem depending on EventMachine so it
# will use EventMachine-LE.
require "em-udns"
</pre>

By doing this, you will avoid conflicts with the main EventMachine Gem (if it's also installed).


## Authors ##

This branch is mantained by [Carsten Bormann](https://github.com/cabo) and [Iñaki Baz Castillo](https://github.com/ibc).