wj_eventmachine 1.3.0.dev.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (180) hide show
  1. checksums.yaml +7 -0
  2. data/CHANGELOG.md +179 -0
  3. data/GNU +281 -0
  4. data/LICENSE +60 -0
  5. data/README.md +110 -0
  6. data/docs/DocumentationGuidesIndex.md +27 -0
  7. data/docs/GettingStarted.md +520 -0
  8. data/docs/old/ChangeLog +211 -0
  9. data/docs/old/DEFERRABLES +246 -0
  10. data/docs/old/EPOLL +141 -0
  11. data/docs/old/INSTALL +13 -0
  12. data/docs/old/KEYBOARD +42 -0
  13. data/docs/old/LEGAL +25 -0
  14. data/docs/old/LIGHTWEIGHT_CONCURRENCY +130 -0
  15. data/docs/old/PURE_RUBY +75 -0
  16. data/docs/old/RELEASE_NOTES +94 -0
  17. data/docs/old/SMTP +4 -0
  18. data/docs/old/SPAWNED_PROCESSES +148 -0
  19. data/docs/old/TODO +8 -0
  20. data/examples/guides/getting_started/01_eventmachine_echo_server.rb +18 -0
  21. data/examples/guides/getting_started/02_eventmachine_echo_server_that_recognizes_exit_command.rb +22 -0
  22. data/examples/guides/getting_started/03_simple_chat_server.rb +149 -0
  23. data/examples/guides/getting_started/04_simple_chat_server_step_one.rb +27 -0
  24. data/examples/guides/getting_started/05_simple_chat_server_step_two.rb +43 -0
  25. data/examples/guides/getting_started/06_simple_chat_server_step_three.rb +98 -0
  26. data/examples/guides/getting_started/07_simple_chat_server_step_four.rb +121 -0
  27. data/examples/guides/getting_started/08_simple_chat_server_step_five.rb +141 -0
  28. data/examples/old/ex_channel.rb +43 -0
  29. data/examples/old/ex_queue.rb +2 -0
  30. data/examples/old/ex_tick_loop_array.rb +15 -0
  31. data/examples/old/ex_tick_loop_counter.rb +32 -0
  32. data/examples/old/helper.rb +2 -0
  33. data/ext/binder.cpp +124 -0
  34. data/ext/binder.h +52 -0
  35. data/ext/cmain.cpp +1046 -0
  36. data/ext/ed.cpp +2238 -0
  37. data/ext/ed.h +460 -0
  38. data/ext/em.cpp +2378 -0
  39. data/ext/em.h +266 -0
  40. data/ext/eventmachine.h +152 -0
  41. data/ext/extconf.rb +285 -0
  42. data/ext/fastfilereader/extconf.rb +120 -0
  43. data/ext/fastfilereader/mapper.cpp +214 -0
  44. data/ext/fastfilereader/mapper.h +59 -0
  45. data/ext/fastfilereader/rubymain.cpp +126 -0
  46. data/ext/kb.cpp +79 -0
  47. data/ext/page.cpp +107 -0
  48. data/ext/page.h +51 -0
  49. data/ext/pipe.cpp +354 -0
  50. data/ext/project.h +174 -0
  51. data/ext/rubymain.cpp +1610 -0
  52. data/ext/ssl.cpp +627 -0
  53. data/ext/ssl.h +103 -0
  54. data/ext/wait_for_single_fd.h +36 -0
  55. data/java/.classpath +8 -0
  56. data/java/.project +17 -0
  57. data/java/src/com/rubyeventmachine/EmReactor.java +625 -0
  58. data/java/src/com/rubyeventmachine/EmReactorException.java +40 -0
  59. data/java/src/com/rubyeventmachine/EmReactorInterface.java +70 -0
  60. data/java/src/com/rubyeventmachine/EventableChannel.java +72 -0
  61. data/java/src/com/rubyeventmachine/EventableDatagramChannel.java +201 -0
  62. data/java/src/com/rubyeventmachine/EventableSocketChannel.java +415 -0
  63. data/java/src/com/rubyeventmachine/NullEmReactor.java +157 -0
  64. data/java/src/com/rubyeventmachine/NullEventableChannel.java +81 -0
  65. data/lib/em/buftok.rb +59 -0
  66. data/lib/em/callback.rb +58 -0
  67. data/lib/em/channel.rb +69 -0
  68. data/lib/em/completion.rb +307 -0
  69. data/lib/em/connection.rb +776 -0
  70. data/lib/em/deferrable.rb +210 -0
  71. data/lib/em/deferrable/pool.rb +2 -0
  72. data/lib/em/file_watch.rb +73 -0
  73. data/lib/em/future.rb +61 -0
  74. data/lib/em/io_streamer.rb +68 -0
  75. data/lib/em/iterator.rb +252 -0
  76. data/lib/em/messages.rb +66 -0
  77. data/lib/em/pool.rb +151 -0
  78. data/lib/em/process_watch.rb +45 -0
  79. data/lib/em/processes.rb +123 -0
  80. data/lib/em/protocols.rb +37 -0
  81. data/lib/em/protocols/header_and_content.rb +138 -0
  82. data/lib/em/protocols/httpclient.rb +303 -0
  83. data/lib/em/protocols/httpclient2.rb +602 -0
  84. data/lib/em/protocols/line_and_text.rb +125 -0
  85. data/lib/em/protocols/line_protocol.rb +33 -0
  86. data/lib/em/protocols/linetext2.rb +179 -0
  87. data/lib/em/protocols/memcache.rb +331 -0
  88. data/lib/em/protocols/object_protocol.rb +46 -0
  89. data/lib/em/protocols/postgres3.rb +246 -0
  90. data/lib/em/protocols/saslauth.rb +175 -0
  91. data/lib/em/protocols/smtpclient.rb +394 -0
  92. data/lib/em/protocols/smtpserver.rb +666 -0
  93. data/lib/em/protocols/socks4.rb +66 -0
  94. data/lib/em/protocols/stomp.rb +205 -0
  95. data/lib/em/protocols/tcptest.rb +54 -0
  96. data/lib/em/pure_ruby.rb +1299 -0
  97. data/lib/em/queue.rb +80 -0
  98. data/lib/em/resolver.rb +232 -0
  99. data/lib/em/spawnable.rb +84 -0
  100. data/lib/em/streamer.rb +118 -0
  101. data/lib/em/threaded_resource.rb +90 -0
  102. data/lib/em/tick_loop.rb +85 -0
  103. data/lib/em/timers.rb +61 -0
  104. data/lib/em/version.rb +3 -0
  105. data/lib/eventmachine.rb +1602 -0
  106. data/lib/jeventmachine.rb +318 -0
  107. data/rakelib/package.rake +120 -0
  108. data/rakelib/test.rake +6 -0
  109. data/rakelib/test_pure.rake +11 -0
  110. data/tests/client.crt +31 -0
  111. data/tests/client.key +51 -0
  112. data/tests/dhparam.pem +13 -0
  113. data/tests/em_ssl_handlers.rb +153 -0
  114. data/tests/em_test_helper.rb +198 -0
  115. data/tests/jruby/test_jeventmachine.rb +38 -0
  116. data/tests/test_attach.rb +199 -0
  117. data/tests/test_basic.rb +321 -0
  118. data/tests/test_channel.rb +75 -0
  119. data/tests/test_completion.rb +178 -0
  120. data/tests/test_connection_count.rb +83 -0
  121. data/tests/test_connection_write.rb +35 -0
  122. data/tests/test_defer.rb +35 -0
  123. data/tests/test_deferrable.rb +35 -0
  124. data/tests/test_epoll.rb +141 -0
  125. data/tests/test_error_handler.rb +38 -0
  126. data/tests/test_exc.rb +37 -0
  127. data/tests/test_file_watch.rb +86 -0
  128. data/tests/test_fork.rb +75 -0
  129. data/tests/test_futures.rb +170 -0
  130. data/tests/test_handler_check.rb +35 -0
  131. data/tests/test_hc.rb +155 -0
  132. data/tests/test_httpclient.rb +238 -0
  133. data/tests/test_httpclient2.rb +132 -0
  134. data/tests/test_idle_connection.rb +31 -0
  135. data/tests/test_inactivity_timeout.rb +102 -0
  136. data/tests/test_io_streamer.rb +47 -0
  137. data/tests/test_ipv4.rb +96 -0
  138. data/tests/test_ipv6.rb +107 -0
  139. data/tests/test_iterator.rb +122 -0
  140. data/tests/test_kb.rb +28 -0
  141. data/tests/test_keepalive.rb +113 -0
  142. data/tests/test_line_protocol.rb +33 -0
  143. data/tests/test_ltp.rb +155 -0
  144. data/tests/test_ltp2.rb +332 -0
  145. data/tests/test_many_fds.rb +21 -0
  146. data/tests/test_next_tick.rb +104 -0
  147. data/tests/test_object_protocol.rb +36 -0
  148. data/tests/test_pause.rb +109 -0
  149. data/tests/test_pending_connect_timeout.rb +52 -0
  150. data/tests/test_pool.rb +196 -0
  151. data/tests/test_process_watch.rb +50 -0
  152. data/tests/test_processes.rb +128 -0
  153. data/tests/test_proxy_connection.rb +180 -0
  154. data/tests/test_pure.rb +156 -0
  155. data/tests/test_queue.rb +64 -0
  156. data/tests/test_resolver.rb +129 -0
  157. data/tests/test_running.rb +14 -0
  158. data/tests/test_sasl.rb +46 -0
  159. data/tests/test_send_file.rb +217 -0
  160. data/tests/test_servers.rb +32 -0
  161. data/tests/test_shutdown_hooks.rb +23 -0
  162. data/tests/test_smtpclient.rb +75 -0
  163. data/tests/test_smtpserver.rb +90 -0
  164. data/tests/test_sock_opt.rb +53 -0
  165. data/tests/test_spawn.rb +290 -0
  166. data/tests/test_ssl_args.rb +41 -0
  167. data/tests/test_ssl_dhparam.rb +57 -0
  168. data/tests/test_ssl_ecdh_curve.rb +57 -0
  169. data/tests/test_ssl_extensions.rb +24 -0
  170. data/tests/test_ssl_methods.rb +31 -0
  171. data/tests/test_ssl_protocols.rb +190 -0
  172. data/tests/test_ssl_verify.rb +52 -0
  173. data/tests/test_stomp.rb +38 -0
  174. data/tests/test_system.rb +46 -0
  175. data/tests/test_threaded_resource.rb +68 -0
  176. data/tests/test_tick_loop.rb +58 -0
  177. data/tests/test_timers.rb +150 -0
  178. data/tests/test_ud.rb +8 -0
  179. data/tests/test_unbind_reason.rb +40 -0
  180. metadata +384 -0
@@ -0,0 +1,7 @@
1
+ ---
2
+ SHA256:
3
+ metadata.gz: 743be1a7da80a467bf1a696d366f0eb04832e352c28244782f36ef5bf29979a8
4
+ data.tar.gz: 1f764940fefd819c1f9e948d23ab0e4ff559ef506716421464f7373e284bc110
5
+ SHA512:
6
+ metadata.gz: 708c98669e16faffc2d79e49e23681c9bb2766c5465adef1d1b3b080409b7b95ef35412205132eab368114f14de50dcca56aba9cedd1887f553e3853eba12c8a
7
+ data.tar.gz: 697ef89b382abfa3e4ea2490cd11c03f281786c895d63924df734cf3df103e963e686971abafe9c22231ae20c4580b54919c5d7b190e157453e791f0b11d3925
@@ -0,0 +1,179 @@
1
+ # Changelog
2
+
3
+ ## 1.2.7 (May 12, 2018)
4
+ * Fix segfault on large numbers of connections [#843]
5
+
6
+ ## 1.2.6 (April 30, 2018)
7
+ * *Fix segfault when an Exception is raised from unbind callback (for real this time!)*
8
+ * Fix race condition while initializing the machine [#756]
9
+ * Fix for newer compilers where bind() and std::bind() conflict [#830, #831]
10
+ * Be verbose about SSL connection errors [#807]
11
+ * Avoid explicitly calling class methods when in class scope
12
+ * Java: Add EM_PROTO_SSL/TLS definitions [#773, #791]
13
+ * Java: return zero when sending data to a closed connection [#475, #804]
14
+ * Pure Ruby: Connection::error? calls report_connection_error_status [#801]
15
+
16
+ ## 1.2.5 (July 27, 2017)
17
+ * Java: Use long for larger values in oneshot timer intervals [#784, #794]
18
+
19
+ ## 1.2.4 (July 27, 2017)
20
+ * Java: Add EM_PROTO_SSL/TLS definitions [#773, #791]
21
+ * Fix IPv6 UDP get_peername [#788]
22
+ * Allow for larger values in oneshot timer intervals [#784, #793]
23
+ * Update extconf.rb to allow MinGW builds with OpenSSL 1.1.0 [#785]
24
+
25
+ ## 1.2.3 (February 22, 2017)
26
+ * Pure Ruby: Add get_sockname [#308, #772]
27
+ * Fix segfault when an Exception is raised from unbind callback [#765, #766]
28
+ * Allow destructors to throw when compiling in >= C++11 [#767]
29
+
30
+ ## 1.2.2 (January 23, 2017)
31
+ * Java: Fix Fixnum deprecated warning in Ruby 2.4+ [#759]
32
+ * Fix uncaught C++ exception in file watcher and raise InvalidSignature [#512, #757]
33
+ * Fix connection count off-by-one for epoll and kqueue [#750]
34
+ * Fix uninitialized variable warning in EM::P::HttpClient [#749]
35
+ * Fix missing initial value for EventableDescriptor NextHeartbeat [#748]
36
+ * Fix hostname resolution on Solaris, Ilumos, SmartOS, et al [#745, #746]
37
+ * Improve reliability of tests, reduce public Internet accesses in tests [#656, #666, #749]
38
+
39
+ ## 1.2.1 (November 15, 2016)
40
+ * Throw strerror(errno) when getsockname or getpeername fail [#683]
41
+ * Use a single concrete implementation of getpeername/getsockname, the rest pure virtuals [#683]
42
+ * Use gai_strerror to get the failure string from getaddrinfo [#744]
43
+ * Fix deregistering descriptor when using KQUEUE [#728]
44
+ * Fix to enable to work an example code in EM::Pool [#731]
45
+ * LineText2: Add regular expression delimiter support [#706]
46
+ * Pure Ruby: EM rescue ECONNREFUSED on initial TCP connect [#741]
47
+ * Pure Ruby: EM SSL (working start_tls) [#712]
48
+ * Pure Ruby: EM fixes [#707]
49
+ * Java: Use Acceptors to get peer and sock names if not present in Connections [#743]
50
+
51
+ ## 1.2.0.1 (March 15, 2016)
52
+ * Fix crash when accepting IPv6 connections due to struct sockaddr_in [#698, #699]
53
+
54
+ ## 1.2.0 (March 15, 2016)
55
+ * Integrate work from the EventMachine-LE 1.1.x versions [#570]
56
+ * Add start_tls options :ecdh_curve, :dhparam, :fail_if_no_peer_cert [#195, #275, #399, #665]
57
+ * Add start_tls option :ssl_version for choosing SSL/TLS versions and ciphers [#359, #348, #603, #654]
58
+ * Add start_tls option :sni_hostname to be passed to TLS params [#593]
59
+ * Add method EM::Channel#num_subscribers to get the number of subscribers to a channel [#640]
60
+ * Add support for proc-sources in EM::Iterator [#639]
61
+ * Factor out method cleanup_machine to cleanup code from EM.run [#650]
62
+ * Replace Exception class with StandardError [#637]
63
+ * Close socket on close_connection even after close_connection_after_writing [#694]
64
+ * Allow reusing of datagram socket/setting bind device [#662]
65
+ * Handle deferred exceptions in reactor thread [#486]
66
+ * Reimplement Queue to avoid shift/push performance problem [#311]
67
+ * Windows: Switch from gethostbyname to getaddrinfo, support IPv6 addresses [#303, #630]
68
+ * Windows: Use rake-compiler-dock to cross-compile gems [#627]
69
+ * Windows: Add AppVeyor configuration for Windows CI testing [#578]
70
+ * Windows: Bump rake-compiler to version 0.9.x [#542]
71
+ * Fix compilation on AIX (w/ XLC) [#693]
72
+ * Fix build on OpenBSD [#690]
73
+ * Fix OpenSSL compile issue on AIX 7.1 [#678]
74
+ * Fix EventMachine.fork_reactor keeps the threadpool of the original process [#425]
75
+ * Fix to prevent event machine from stopping when a raise is done in an unbind [#327]
76
+
77
+ ## 1.0.9.1 (January 14, 2016)
78
+ * Fix EPROTO not defined on Windows [#676]
79
+ * Fix missing cast to struct sockaddr * [#671]
80
+ * Fix bug in OpenSSL path detection [#675]
81
+
82
+ ## 1.0.9 (January 13, 2016)
83
+ * Try more ways to detect OpenSSL [#602, #643, #661, #663, #668, #669]
84
+ * Use WSAGetLastError in pipe.cpp same as ed.cpp [#659]
85
+ * Test compiler flags with the C++ compiler and add them to CXXFLAGS [#634, #651]
86
+ * Restore silent-fail on unsupported EM.epoll and EM.kqueue [#638, #649]
87
+ * getDescriptorByFileno deprecated in JRuby 1.7.x, removed in JRuby 9000 [#642, #648]
88
+ * Add -Wno-address always-true because on Windows rb_fd_select [#578]
89
+ * Remove the WITHOUT_SSL constant [#578]
90
+ * Fix SSL error when the server replies a TLS Alert to our ClientHello [#544, #653]
91
+ * Use WSAStringToAddress in lieu of inet_pton for IPv6 address detection on Windows [#595, #632]
92
+ * Fix nasty TCP/IPv6 bug [#595, #632]
93
+ * Use select_large_fdset on Solaris [#611, #625]
94
+ * Detect the Solaris Studio compiler [#611, #625]
95
+ * Throw a message with strerror included [#136, #621]
96
+
97
+ ## 1.0.8 (August 6, 2015)
98
+ * fix kqueue assertion failed, postpone ArmKqueueWriter until all events are processed [#51, #176, #372, #401, #619]
99
+ * fix Rubinius GC, crank the machine from Ruby space when running Rubinius [#201, #202, #617]
100
+ * test to show that LineText2 preserves whitespace and newlines [#32, #622]
101
+ * bump up compiler warnings and resolve them [#616]
102
+ * fix Windows x64 use uintptr_t instead of unsigned long for binding pointers [#612, #615]
103
+ * fix linetext2 unroll tail recursion to avoid stack level too deep [#609]
104
+ * fix for compilation with SSL on windows [#601]
105
+ * open file descriptors and sockets with O_CLOEXEC where possible [#298, #488, #591]
106
+ * fix SmtpClient: send second EHLO after STARTTLS. [#589]
107
+ * fix nul-terminated strings in C, use StringValueCStr instead of StringValuePtr
108
+
109
+ ## 1.0.7 (February 10, 2015)
110
+ * fix delay in kqueue/epoll reactor shutdown when timers exist [#587]
111
+ * fix memory leak introduced in v1.0.5 [#586]
112
+ * expose EM.set_simultaneous_accept_count [#420]
113
+ * fix busy loop when EM.run and EM.next_tick are invoked from exception handler [#452]
114
+
115
+ ## 1.0.6 (February 3, 2015)
116
+ * add support for Rubinius Process::Status [#568]
117
+ * small bugfixes for SmtpServer [#449]
118
+ * update buftok.rb [#547]
119
+ * fix assertion on Write() [#525]
120
+ * work around mkmf.rb bug preventing gem installation [#574]
121
+ * add pause/resume support to jruby reactor [#556]
122
+ * fix pure ruby reactor to use 127.0.0.1 instead of localhost [#439]
123
+ * fix compilation under macruby [#243]
124
+ * add chunked encoding to http client [#111]
125
+ * fix errors on win32 when dealing with pipes [1ea45498] [#105]
126
+
127
+ ## 1.0.5 (February 2, 2015)
128
+ * use monotonic clocks on Linux, OS X, Solaris, and Windows [#563]
129
+ * use the rb_fd_* API to get autosized fd_sets [#502]
130
+ * add basic tests that the DNS resolver isn't leaking timers [#571]
131
+ * update to test-unit 2.x and improve various unit tests [#551]
132
+ * remove EventMachine_t::Popen code marked by ifdef OBSOLETE [#551]
133
+ * ruby 2.0 may fail at Queue.pop, so rescue and complain to $stderr [#551]
134
+ * set file handle to INVALID_HANDLE_VALUE after closing the file [#565]
135
+ * use `defined?` instead of rescuing NameError for flow control [#535]
136
+ * fix closing files and sockets on Windows [#564]
137
+ * fix file uploads in Windows [#562]
138
+ * catch failure to fork [#539]
139
+ * use chunks for SSL write [#545]
140
+
141
+ ## 1.0.4 (December 19, 2014)
142
+ * add starttls_options to smtp server [#552]
143
+ * fix closesocket on windows [#497]
144
+ * fix build on ruby 2.2 [#503]
145
+ * fix build error on ruby 1.9 [#508]
146
+ * fix timer leak during dns resolution [#489]
147
+ * add concurrency validation to EM::Iterator [#468]
148
+ * add get_file_descriptor to get fd for a signature [#467]
149
+ * add EM.attach_server and EM.attach_socket_server [#465, #466]
150
+ * calling pause from receive_data takes effect immediately [#464]
151
+ * reactor_running? returns false after fork [#455]
152
+ * fix infinite loop on double close [edc4d0e6, #441, #445]
153
+ * fix compilation issue on llvm [#433]
154
+ * fix socket error codes on win32 [ff811a81]
155
+ * fix EM.stop latency when timers exist [8b613d05, #426]
156
+ * fix infinite loop when system time changes [1427a2c80, #428]
157
+ * fix crash when callin attach/detach in the same tick [#427]
158
+ * fix compilation issue on solaris [#416]
159
+
160
+ ## 1.0.3 (March 8, 2013)
161
+ * EM.system was broken in 1.0.2 release [#413]
162
+
163
+ ## 1.0.2 (March 8, 2013)
164
+ * binary win32 gems now include fastfilereader shim [#222]
165
+ * fix long-standing connection timeout issues [27fdd5b, igrigorik/em-http-request#222]
166
+ * http and line protocol cleanups [#193, #151]
167
+ * reactor return value cleanup [#225]
168
+ * fix double require from gemspec [#284]
169
+ * fix smtp server reset behavior [#351]
170
+ * fix EM.system argument handling [#322]
171
+ * ruby 1.9 compat in smtp server and stomp protocols [#349, #315]
172
+ * fix pause from post_init [#380]
173
+
174
+ ## 1.0.1 (February 27, 2013)
175
+ * use rb_wait_for_single_fd() on ruby 2.0 to fix rb_thread_select() deprecation [#363]
176
+ * fix epoll/kqueue mode in ruby 2.0 by removing calls to rb_enable_interrupt() [#248, #389]
177
+ * fix memory leak when verifying ssl cerificates [#403]
178
+ * fix initial connection delay [#393, #374]
179
+ * fix build on windows [#371]
data/GNU ADDED
@@ -0,0 +1,281 @@
1
+ .
2
+
3
+ GNU GENERAL PUBLIC LICENSE
4
+ Version 2, June 1991
5
+
6
+ Copyright (C) 1989, 1991 Free Software Foundation, Inc.
7
+ 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
8
+ Everyone is permitted to copy and distribute verbatim copies
9
+ of this license document, but changing it is not allowed.
10
+
11
+ Preamble
12
+
13
+ The licenses for most software are designed to take away your
14
+ freedom to share and change it. By contrast, the GNU General Public
15
+ License is intended to guarantee your freedom to share and change free
16
+ software--to make sure the software is free for all its users. This
17
+ General Public License applies to most of the Free Software
18
+ Foundation's software and to any other program whose authors commit to
19
+ using it. (Some other Free Software Foundation software is covered by
20
+ the GNU Lesser General Public License instead.) You can apply it to
21
+ your programs, too.
22
+
23
+ When we speak of free software, we are referring to freedom, not
24
+ price. Our General Public Licenses are designed to make sure that you
25
+ have the freedom to distribute copies of free software (and charge for
26
+ this service if you wish), that you receive source code or can get it
27
+ if you want it, that you can change the software or use pieces of it
28
+ in new free programs; and that you know you can do these things.
29
+
30
+ To protect your rights, we need to make restrictions that forbid
31
+ anyone to deny you these rights or to ask you to surrender the rights.
32
+ These restrictions translate to certain responsibilities for you if you
33
+ distribute copies of the software, or if you modify it.
34
+
35
+ For example, if you distribute copies of such a program, whether
36
+ gratis or for a fee, you must give the recipients all the rights that
37
+ you have. You must make sure that they, too, receive or can get the
38
+ source code. And you must show them these terms so they know their
39
+ rights.
40
+
41
+ We protect your rights with two steps: (1) copyright the software, and
42
+ (2) offer you this license which gives you legal permission to copy,
43
+ distribute and/or modify the software.
44
+
45
+ Also, for each author's protection and ours, we want to make certain
46
+ that everyone understands that there is no warranty for this free
47
+ software. If the software is modified by someone else and passed on, we
48
+ want its recipients to know that what they have is not the original, so
49
+ that any problems introduced by others will not reflect on the original
50
+ authors' reputations.
51
+
52
+ Finally, any free program is threatened constantly by software
53
+ patents. We wish to avoid the danger that redistributors of a free
54
+ program will individually obtain patent licenses, in effect making the
55
+ program proprietary. To prevent this, we have made it clear that any
56
+ patent must be licensed for everyone's free use or not licensed at all.
57
+
58
+ The precise terms and conditions for copying, distribution and
59
+ modification follow.
60
+
61
+ GNU GENERAL PUBLIC LICENSE
62
+ TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
63
+
64
+ 0. This License applies to any program or other work which contains
65
+ a notice placed by the copyright holder saying it may be distributed
66
+ under the terms of this General Public License. The "Program", below,
67
+ refers to any such program or work, and a "work based on the Program"
68
+ means either the Program or any derivative work under copyright law:
69
+ that is to say, a work containing the Program or a portion of it,
70
+ either verbatim or with modifications and/or translated into another
71
+ language. (Hereinafter, translation is included without limitation in
72
+ the term "modification".) Each licensee is addressed as "you".
73
+
74
+ Activities other than copying, distribution and modification are not
75
+ covered by this License; they are outside its scope. The act of
76
+ running the Program is not restricted, and the output from the Program
77
+ is covered only if its contents constitute a work based on the
78
+ Program (independent of having been made by running the Program).
79
+ Whether that is true depends on what the Program does.
80
+
81
+ 1. You may copy and distribute verbatim copies of the Program's
82
+ source code as you receive it, in any medium, provided that you
83
+ conspicuously and appropriately publish on each copy an appropriate
84
+ copyright notice and disclaimer of warranty; keep intact all the
85
+ notices that refer to this License and to the absence of any warranty;
86
+ and give any other recipients of the Program a copy of this License
87
+ along with the Program.
88
+
89
+ You may charge a fee for the physical act of transferring a copy, and
90
+ you may at your option offer warranty protection in exchange for a fee.
91
+
92
+ 2. You may modify your copy or copies of the Program or any portion
93
+ of it, thus forming a work based on the Program, and copy and
94
+ distribute such modifications or work under the terms of Section 1
95
+ above, provided that you also meet all of these conditions:
96
+
97
+ a) You must cause the modified files to carry prominent notices
98
+ stating that you changed the files and the date of any change.
99
+
100
+ b) You must cause any work that you distribute or publish, that in
101
+ whole or in part contains or is derived from the Program or any
102
+ part thereof, to be licensed as a whole at no charge to all third
103
+ parties under the terms of this License.
104
+
105
+ c) If the modified program normally reads commands interactively
106
+ when run, you must cause it, when started running for such
107
+ interactive use in the most ordinary way, to print or display an
108
+ announcement including an appropriate copyright notice and a
109
+ notice that there is no warranty (or else, saying that you provide
110
+ a warranty) and that users may redistribute the program under
111
+ these conditions, and telling the user how to view a copy of this
112
+ License. (Exception: if the Program itself is interactive but
113
+ does not normally print such an announcement, your work based on
114
+ the Program is not required to print an announcement.)
115
+
116
+ These requirements apply to the modified work as a whole. If
117
+ identifiable sections of that work are not derived from the Program,
118
+ and can be reasonably considered independent and separate works in
119
+ themselves, then this License, and its terms, do not apply to those
120
+ sections when you distribute them as separate works. But when you
121
+ distribute the same sections as part of a whole which is a work based
122
+ on the Program, the distribution of the whole must be on the terms of
123
+ this License, whose permissions for other licensees extend to the
124
+ entire whole, and thus to each and every part regardless of who wrote it.
125
+
126
+ Thus, it is not the intent of this section to claim rights or contest
127
+ your rights to work written entirely by you; rather, the intent is to
128
+ exercise the right to control the distribution of derivative or
129
+ collective works based on the Program.
130
+
131
+ In addition, mere aggregation of another work not based on the Program
132
+ with the Program (or with a work based on the Program) on a volume of
133
+ a storage or distribution medium does not bring the other work under
134
+ the scope of this License.
135
+
136
+ 3. You may copy and distribute the Program (or a work based on it,
137
+ under Section 2) in object code or executable form under the terms of
138
+ Sections 1 and 2 above provided that you also do one of the following:
139
+
140
+ a) Accompany it with the complete corresponding machine-readable
141
+ source code, which must be distributed under the terms of Sections
142
+ 1 and 2 above on a medium customarily used for software interchange; or,
143
+
144
+ b) Accompany it with a written offer, valid for at least three
145
+ years, to give any third party, for a charge no more than your
146
+ cost of physically performing source distribution, a complete
147
+ machine-readable copy of the corresponding source code, to be
148
+ distributed under the terms of Sections 1 and 2 above on a medium
149
+ customarily used for software interchange; or,
150
+
151
+ c) Accompany it with the information you received as to the offer
152
+ to distribute corresponding source code. (This alternative is
153
+ allowed only for noncommercial distribution and only if you
154
+ received the program in object code or executable form with such
155
+ an offer, in accord with Subsection b above.)
156
+
157
+ The source code for a work means the preferred form of the work for
158
+ making modifications to it. For an executable work, complete source
159
+ code means all the source code for all modules it contains, plus any
160
+ associated interface definition files, plus the scripts used to
161
+ control compilation and installation of the executable. However, as a
162
+ special exception, the source code distributed need not include
163
+ anything that is normally distributed (in either source or binary
164
+ form) with the major components (compiler, kernel, and so on) of the
165
+ operating system on which the executable runs, unless that component
166
+ itself accompanies the executable.
167
+
168
+ If distribution of executable or object code is made by offering
169
+ access to copy from a designated place, then offering equivalent
170
+ access to copy the source code from the same place counts as
171
+ distribution of the source code, even though third parties are not
172
+ compelled to copy the source along with the object code.
173
+
174
+ 4. You may not copy, modify, sublicense, or distribute the Program
175
+ except as expressly provided under this License. Any attempt
176
+ otherwise to copy, modify, sublicense or distribute the Program is
177
+ void, and will automatically terminate your rights under this License.
178
+ However, parties who have received copies, or rights, from you under
179
+ this License will not have their licenses terminated so long as such
180
+ parties remain in full compliance.
181
+
182
+ 5. You are not required to accept this License, since you have not
183
+ signed it. However, nothing else grants you permission to modify or
184
+ distribute the Program or its derivative works. These actions are
185
+ prohibited by law if you do not accept this License. Therefore, by
186
+ modifying or distributing the Program (or any work based on the
187
+ Program), you indicate your acceptance of this License to do so, and
188
+ all its terms and conditions for copying, distributing or modifying
189
+ the Program or works based on it.
190
+
191
+ 6. Each time you redistribute the Program (or any work based on the
192
+ Program), the recipient automatically receives a license from the
193
+ original licensor to copy, distribute or modify the Program subject to
194
+ these terms and conditions. You may not impose any further
195
+ restrictions on the recipients' exercise of the rights granted herein.
196
+ You are not responsible for enforcing compliance by third parties to
197
+ this License.
198
+
199
+ 7. If, as a consequence of a court judgment or allegation of patent
200
+ infringement or for any other reason (not limited to patent issues),
201
+ conditions are imposed on you (whether by court order, agreement or
202
+ otherwise) that contradict the conditions of this License, they do not
203
+ excuse you from the conditions of this License. If you cannot
204
+ distribute so as to satisfy simultaneously your obligations under this
205
+ License and any other pertinent obligations, then as a consequence you
206
+ may not distribute the Program at all. For example, if a patent
207
+ license would not permit royalty-free redistribution of the Program by
208
+ all those who receive copies directly or indirectly through you, then
209
+ the only way you could satisfy both it and this License would be to
210
+ refrain entirely from distribution of the Program.
211
+
212
+ If any portion of this section is held invalid or unenforceable under
213
+ any particular circumstance, the balance of the section is intended to
214
+ apply and the section as a whole is intended to apply in other
215
+ circumstances.
216
+
217
+ It is not the purpose of this section to induce you to infringe any
218
+ patents or other property right claims or to contest validity of any
219
+ such claims; this section has the sole purpose of protecting the
220
+ integrity of the free software distribution system, which is
221
+ implemented by public license practices. Many people have made
222
+ generous contributions to the wide range of software distributed
223
+ through that system in reliance on consistent application of that
224
+ system; it is up to the author/donor to decide if he or she is willing
225
+ to distribute software through any other system and a licensee cannot
226
+ impose that choice.
227
+
228
+ This section is intended to make thoroughly clear what is believed to
229
+ be a consequence of the rest of this License.
230
+
231
+ 8. If the distribution and/or use of the Program is restricted in
232
+ certain countries either by patents or by copyrighted interfaces, the
233
+ original copyright holder who places the Program under this License
234
+ may add an explicit geographical distribution limitation excluding
235
+ those countries, so that distribution is permitted only in or among
236
+ countries not thus excluded. In such case, this License incorporates
237
+ the limitation as if written in the body of this License.
238
+
239
+ 9. The Free Software Foundation may publish revised and/or new versions
240
+ of the General Public License from time to time. Such new versions will
241
+ be similar in spirit to the present version, but may differ in detail to
242
+ address new problems or concerns.
243
+
244
+ Each version is given a distinguishing version number. If the Program
245
+ specifies a version number of this License which applies to it and "any
246
+ later version", you have the option of following the terms and conditions
247
+ either of that version or of any later version published by the Free
248
+ Software Foundation. If the Program does not specify a version number of
249
+ this License, you may choose any version ever published by the Free Software
250
+ Foundation.
251
+
252
+ 10. If you wish to incorporate parts of the Program into other free
253
+ programs whose distribution conditions are different, write to the author
254
+ to ask for permission. For software which is copyrighted by the Free
255
+ Software Foundation, write to the Free Software Foundation; we sometimes
256
+ make exceptions for this. Our decision will be guided by the two goals
257
+ of preserving the free status of all derivatives of our free software and
258
+ of promoting the sharing and reuse of software generally.
259
+
260
+ NO WARRANTY
261
+
262
+ 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
263
+ FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN
264
+ OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
265
+ PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
266
+ OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
267
+ MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS
268
+ TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE
269
+ PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
270
+ REPAIR OR CORRECTION.
271
+
272
+ 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
273
+ WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
274
+ REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
275
+ INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
276
+ OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
277
+ TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
278
+ YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
279
+ PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
280
+ POSSIBILITY OF SUCH DAMAGES.
281
+