| 1 | Revision history for Perl extension AnyEvent. |
1 | Revision history for Perl extension AnyEvent. |
|
|
2 | |
|
|
3 | TODO: document TCP_*** constants |
|
|
4 | |
|
|
5 | TODO: AnyEvent::Log |
|
|
6 | TODO: ae::log examples |
|
|
7 | TODO: consolide slogging, e.g AnyEvent::Debug |
|
|
8 | TODO: /etc/hosts, for resolve_sockaddr? |
|
|
9 | 6.01 |
|
|
10 | - INCOMPATIBLE CHANGE: AnyEvent::DNS resource records now include |
|
|
11 | the TTL as fourth element - this affects ->resolve, ->request |
|
|
12 | and ->dns_unpack indirectly. Convenience functions such as |
|
|
13 | AnyEvent::DNS::{a,txt,mx,srv} are not affected, neither is |
|
|
14 | AnyEvent::Socket. |
|
|
15 | - INCOMPATIBLE CHANGE: backend authors now should not implement |
|
|
16 | one_event or loop, but instead the AnyEvent::CondVar::_wait and _poll |
|
|
17 | methods. |
|
|
18 | - INCOMPATIBLE CHANGE: verbosity levels have been redefined, see |
|
|
19 | AnyEvent (PERL_ANYEVENT_VERBOSE) and AnyEvent::Log for details. |
|
|
20 | - DEPRECIATION: please change |
|
|
21 | "use AnyEvent::Impl::Perl" to "use AnyEvent::Loop" and |
|
|
22 | "AnyEvent::Impl::Perl::loop" to "AnyEvent::Loop::run" |
|
|
23 | in your programs, for future compatibility. |
|
|
24 | - *blush* idle watcher emulation was borked. |
|
|
25 | - AnyEvent::Strict now checks the AE::xxx functions as well. |
|
|
26 | - querying too long domain names would barf deep inside AnyEvent::DNS - since |
|
|
27 | this is hard to avoid for applications, AnyEvent:.DNS::request now checks for |
|
|
28 | for too long domain names explicitly and passes an undef to the callback |
|
|
29 | instead (reported by James Bromberger). |
|
|
30 | - make AnyEvent::Util more robust against EINTR (analyzed by Andrew Suffield). |
|
|
31 | - new functions: AnyEvent::postpone, AnyEvent::log. |
|
|
32 | - new module: AnyEvent::Log, for simple logging needs. |
|
|
33 | - new env variable, PERL_ANYEVENT_DEBUG_SHELL, to automatically start |
|
|
34 | a debug shell. |
|
|
35 | - new env variable, PERL_ANYEVENT_DEBUG_WRAP, to automatically enable |
|
|
36 | watcher instrumentation/wrapping (see AnyEvent::Debug::wrap). |
|
|
37 | - an empty PERL_ANYEVENT_RESOLV_CONF now selects the default |
|
|
38 | configuration. |
|
|
39 | - env variables can now be specified using AE_xyz instead of |
|
|
40 | PERL_ANYEVENT_xyz, subject to some rules. |
|
|
41 | - lots of new AnyEvent::Debug functionality. |
|
|
42 | - AnyEvent::Strict now checks for modifications $_ by the callback |
|
|
43 | (by setting it to readonly while executing the callback, if possible). |
|
|
44 | - IO::Async sometimes cancels the wrong timer when you call cancel_timer. |
|
|
45 | Invest extra overhead to work around this peculiar behaviour. |
|
|
46 | - split the pure perl backend into a loop module and an impl |
|
|
47 | module (AnyEvent::Loop and AnyEvent::Impl::Perl). |
|
|
48 | - some read types (regex, netstring, json, storable) could |
|
|
49 | errornously keep an AE::Handle object alive on their own |
|
|
50 | (reported by Mohammad Toossi). |
|
|
51 | - add more workarounds around child watcher bugs in IO::Async |
|
|
52 | and (newly introduced) in POE. |
|
|
53 | - use glib child watchers and try to work around its limitations, |
|
|
54 | if possible (based on a patch by Kevin Ryde). |
|
|
55 | - add support for FLTK (fltk2), via AnyEvent::Impl::FLTK2. |
|
|
56 | - many read types in AnyEvent::Handle would malfunction during |
|
|
57 | transitions to TLS because of a "delete $self->{rbuf}". |
|
|
58 | (reported by Gerald Galster). |
|
|
59 | - improve condvar blocking wait performance (probably only noticable |
|
|
60 | with faster backends), also make it easier for event loops that |
|
|
61 | do not support blocking waits. |
|
|
62 | - PERL_ANYEVENT_MODEL now also allows full module names, although |
|
|
63 | the usefulness of this feature is not yet clear. |
|
|
64 | - add tests for all supported event loops, conditional on PERL_ANYEVENT_LOOP_TESTS. |
|
|
65 | - add t/80_ssltext.t. |
|
|
66 | - no longer use AUTOLOAD for the initial loading (for no very good reason). |
|
|
67 | - tcp_server now tries to unlink unix domain sockets when it gets destroyed. |
|
|
68 | - do not run event loop detection multiple times when programs call their cached |
|
|
69 | copies of AnyEvent::detect. |
|
|
70 | - parse_hostport now accepts absolute paths als unix domain sockets. |
|
|
71 | - add Task::Weaken as dependency (as recommends only at this time). |
|
|
72 | |
|
|
73 | 6.0 (not officially released, but was on CPAN for about 15 minutes :/) |
|
|
74 | |
|
|
75 | 5.34 Thu May 12 09:59:41 CEST 2011 |
|
|
76 | - AE::TLS didn't support both cert_file and key at the same time, |
|
|
77 | due to some copy&paste bug (reported and analyzed by vti). |
|
|
78 | - improve AE::Handle timeout documentation slightly. |
|
|
79 | |
|
|
80 | 5.33 Mon Feb 7 21:51:41 CET 2011 |
|
|
81 | - never appeared on CPAN, for unknown reasons. |
|
|
82 | - AnyEvent::Handle on_connect_error - do not try to destroy a handle |
|
|
83 | object when it's already gone (analyzed by Ryan Bullock). |
|
|
84 | - update idna algorithm(s) to UTS#46 version 6.0.0. |
|
|
85 | - preserve trailing dot in idn_to_ascii - testsuite says to preserve, |
|
|
86 | uts46 says it's an error, and testsuite makes more sense. |
|
|
87 | - remove leading dots in idn_to_ascii - testsuite says to remove, |
|
|
88 | uts46 says it's an error, and testsuite makes more sense. |
|
|
89 | - fixed a bug in idn ignored character processing. |
|
|
90 | - passes the uts46 6.0.0 testsuite except for three cases which |
|
|
91 | apparently are bugs in the testsuite itself. |
|
|
92 | - passes the uts46 6.0.1 testsuite except for eleven cases which |
|
|
93 | apparently are bugs in the testsuite itself. |
|
|
94 | |
|
|
95 | 5.31 Sun Jan 23 11:49:19 CET 2011 |
|
|
96 | - work around a POE bug where POE would first poll for new events and |
|
|
97 | invoke handlers BEFORE handling the message queue. |
|
|
98 | - fix parsing of "domain" statement in resolv.conf (Johannes Plunien). |
|
|
99 | - stop_read now does just that in TLS mode. see its |
|
|
100 | documentation for caveats. |
|
|
101 | - update to common::sense 3.4 warning set (some warnings in perl impose |
|
|
102 | an arbitrary 32kb limit on regex matches, which affects |
|
|
103 | AnyEvent::Handle). |
|
|
104 | - AE::Handle had a broken rbuf_max method and missing wbuf_max method. |
|
|
105 | - new experimental AE::Handle::resettls method. |
|
|
106 | |
|
|
107 | 5.3 Fri Dec 31 05:48:13 CET 2010 |
|
|
108 | - major IOAsync patch by Paul Evans - 0.33 is required, as the major |
|
|
109 | issues with IO::Async have been solved in that version, including |
|
|
110 | the availabilty of a default loop! |
|
|
111 | - implement new wbuf_max parameter for AnyEvent::Handle. |
|
|
112 | - added Cocoa::EventLoop backend by Daisuke Murase. |
|
|
113 | - the default testsuite now honors PERL_ANYEVENT_MODEL (Paul Evans). |
|
|
114 | - clarify handle on_prepare documentation. |
|
|
115 | - set CLOEXEC flag on parent-side fd's in AnyEvent::Util::run_cmd, |
|
|
116 | to avoid leaking them to any child processes. |
|
|
117 | - try to force files into the arch-dependend lib directory, for the |
|
|
118 | half-"turly obsessive compulsive person"(s) that depend on it. |
|
|
119 | |
|
|
120 | 5.29 Sun Dec 5 10:49:21 CET 2010 |
|
|
121 | - convert EV backend to EV 4.00 API (so better upgrade EV too). |
|
|
122 | - AE::Handle: implement dynamic read_size adjustment, add |
|
|
123 | max_read_size parameter, reduce default read_size to 2048. |
|
|
124 | - add some FAQ entries for servers and/or on_eof vs. on_error. |
|
|
125 | - work around OS bugs (cygwin again) when lingering in AE::Handle. |
|
|
126 | - reduce memory usage slightly when connect was used in AE::Handle. |
|
|
127 | - wrok around more segfaults in Tk. |
|
|
128 | - document tls_ctx => undef as valid. |
|
|
129 | - detect WNOHANG value at compiletime. |
|
|
130 | - include some probably linux-only support for building AnyEvent |
|
|
131 | as part of the perl core. |
|
|
132 | - improve compatibility of t/08_idna.t to perl 5.8. |
|
|
133 | - make AnyEvent::Strict truly optional (in case somebody builds a |
|
|
134 | minimal perl...). |
|
|
135 | |
|
|
136 | 5.28 Wed Oct 13 04:14:23 CEST 2010 |
|
|
137 | - due to a glitch, AnyEvent's internal getprotobyname wasn't |
|
|
138 | actually used in tcp_server. |
|
|
139 | - implement AnyEvent::CondVar->new method, which was documented but |
|
|
140 | missing. |
|
|
141 | - support autoloading of read types in unshift_read. |
|
|
142 | - AnyEvent::Strict: do the test for invalid fh arguments differently, |
|
|
143 | resulting in more informative error messages. |
|
|
144 | - new AnyEvent::FAQ manpage. |
|
|
145 | - clarify that you can actually call push_read etc. in on_read. |
|
|
146 | - put keys and certs in /tmp, not into the current directory, |
|
|
147 | and document this in the SECURITY CONSIDERATIONS sections |
|
|
148 | of AnyEvent::TLS. |
|
|
149 | - support ";" as resolv.conf comment character in AnyEvent::DNS, as |
|
|
150 | requested by Ron Isaacson. |
|
|
151 | - document $AnyEvent::DNS::RESOLVER variable. |
|
|
152 | - incorporated major typo patches by Abhijit Menon-Sen. |
|
|
153 | - AnyEvent::Handle now croaks when negative timeouts are passed. |
|
|
154 | - add a shitload of TCP_xxx sockopt name constants to AnyEvent::Util, |
|
|
155 | undocumented, but who knows when they might come in handy. |
|
|
156 | |
|
|
157 | 5.271 Tue Jun 8 12:05:46 CEST 2010 |
|
|
158 | - backport to perl 5.8.x. |
|
|
159 | |
|
|
160 | 5.27 Sun Jun 6 12:12:05 CEST 2010 |
|
|
161 | - postpone differently in AnyEvent::Socket now, as |
|
|
162 | when not, canceling the connection attempt might fail |
|
|
163 | (found by Felix Antonius Wilhelm Ostmann). |
|
|
164 | - explicitly check for non-stream sockets in AE::Handle, too many |
|
|
165 | clueless people fell into the trap of this somehow working. |
|
|
166 | - simplified and reworked the "OTHER MODULES" section. |
|
|
167 | - better/more condvar examples. |
|
|
168 | |
|
|
169 | 5.261 Wed Apr 28 16:13:36 CEST 2010 |
|
|
170 | - AF_INET6 was not properly used from Socket6 during configuration |
|
|
171 | time (found by Andy Grundman). |
|
|
172 | |
|
|
173 | 5.26 Mon Apr 12 04:49:35 CEST 2010 |
|
|
174 | - don't generate spurious readyness notifications when select |
|
|
175 | returns EINTR in the pure perl backend (analysed and testcase |
|
|
176 | by Bas Denissen). |
|
|
177 | - give same examples in SYNOPSIS sections of AnyEvent and AE. |
|
|
178 | - provider faster implementations for AE::time/now/now_update for |
|
|
179 | EV and Perl backends. |
|
|
180 | - provide faster AE::cv and AE::time implementations for all |
|
|
181 | backends. |
|
|
182 | - no longer support lower/mixed-case signal names (this was |
|
|
183 | never documented nor universally supported). |
|
|
184 | - some more memory ยต-optimisations, and somewhat less messy |
|
|
185 | code to cope with both AnyEvent and AE APIs. |
|
|
186 | |
|
|
187 | 5.251 Sat Mar 13 00:58:21 CET 2010 |
|
|
188 | - make test failed if it was run before make install on perl <= |
|
|
189 | 5.8.8, and older versions of perl make our live very difficult, |
|
|
190 | so write constants.pl during Makefile.PL time. |
|
|
191 | |
|
|
192 | 5.25 Sat Mar 13 00:23:14 CET 2010 |
|
|
193 | - fix a race condition in AnyEvent::Handle that would cause |
|
|
194 | a "bio_read: unsupported method" error (in _another_ |
|
|
195 | ssl connection) after user code threw an exception. |
|
|
196 | - added AnyEvent::Handle->destroyed method. |
|
|
197 | - speed up AnyEvent::Socket::format_address and ::format_ipv6. |
|
|
198 | - the AnyEvent::Util::fh_nonblocking function worked only |
|
|
199 | by lucky accident on win32. |
|
|
200 | - smaller and faster AnyEvent::Util::fh_nonblocking. |
|
|
201 | - when the (required!) Time::HiRes module is missing, AnyEvent |
|
|
202 | did not fall back to built-in time properly. |
|
|
203 | - do not load Fcntl at runtime, saving memory and loading time. |
|
|
204 | - precompile a number of constants and use them instead of runtime |
|
|
205 | detection and eval. |
|
|
206 | - free detection code after detection and similar memory optimisations. |
|
|
207 | - Perl backend timer interval best effort drift has been improved |
|
|
208 | (same algorithm as EV). |
|
|
209 | - update unicode idna mapping table. |
|
|
210 | |
|
|
211 | 5.24 Tue Jan 5 11:39:43 CET 2010 |
|
|
212 | - cygwin never reports errors from failed connects. 1.5 just gives |
|
|
213 | you continous readyness and EAGAIN, 1.7 is even more broken and |
|
|
214 | just hangs. work around both issues in a cygwin-specific hack. |
|
|
215 | - improve idle watcher documentation slightly. |
|
|
216 | |
|
|
217 | 5.23 Sun Dec 20 23:48:00 CET 2009 |
|
|
218 | - support IDNs in resolve_sockaddr, and therefore in tcp_connect. |
|
|
219 | - implement punycode_encode/decode, idn_nameprep, |
|
|
220 | idn_to_ascii and idn_to_unicode operations in AnyEvent::Util. |
|
|
221 | - provide $AE::VERSION. |
|
|
222 | - removed traces of "no strict 'refs'". |
|
|
223 | |
|
|
224 | 5.22 Sat Dec 5 03:51:13 CET 2009 |
|
|
225 | - downgrade-or-fail in AnyEvent::Handle::push_write, to |
|
|
226 | diagnose encoding failures earlier and more succinctly. |
|
|
227 | (this works around bugs in perl, throwing away encoding info |
|
|
228 | when passing scalar data to extensions). |
|
|
229 | - add more examples to AnyEvent::Socket manpage. |
|
|
230 | - upgrade internal warning set to the same as common::sense 2.03. |
|
|
231 | - use pack "n/a*" for pre-5.8.9 perl compatibility in AnyEvent::DNS |
|
|
232 | (John Beppu). |
|
|
233 | - AnyEvent::Socket::inet_aton now properly supports ipv6, as documented. |
|
|
234 | - add google public dns servers to fallback server set and make sure |
|
|
235 | we load-balance properly between the three sets. also add all |
|
|
236 | fallback dns servers, not just a random one, to each dns config. |
|
|
237 | |
|
|
238 | 5.21 Thu Nov 19 02:48:47 CET 2009 |
|
|
239 | - fix a problem where socket constants were called with parameters |
|
|
240 | (spotted by David Friedland). |
|
|
241 | - fork_call never use'd POSIX (reported by Daisuke Maki). |
|
|
242 | - improve perl 5.6 compatibility further (but it still won't work |
|
|
243 | unless you rip out everything but the core). |
|
|
244 | - prefer Net::DNS::Resolver over ipconfig, if installed, on win32. |
|
|
245 | uses 10MB of RAM, but doesn't open a console window. *sigh*. |
|
|
246 | |
|
|
247 | 5.202 Wed Oct 14 22:35:44 CEST 2009 |
|
|
248 | - AnyEvent::DNS would unexpectedly clobber $_ under windows |
|
|
249 | (analysed by Matthias Waldorf). |
|
|
250 | - AnyEvent::Handle::run_cmd can now pass the PID of the |
|
|
251 | newly-created process, which is much less useful than it might |
|
|
252 | sound (based on patch by Yann Kerherve). |
|
|
253 | |
|
|
254 | 5.201 Tue Sep 29 12:09:25 CEST 2009 |
|
|
255 | - AnyEvent:Handle::on_starttls/on_stoptls methods were broken |
|
|
256 | (reported by Torsten Foertsch). |
|
|
257 | - common::sense 2.0 could cause tcp_server to throw an exception |
|
|
258 | (analysed by elmex). |
|
|
259 | |
|
|
260 | 5.2 Mon Sep 14 07:04:49 CEST 2009 |
|
|
261 | - INCOMPATIBLE CHANGE: do no longer support register_read_type |
|
|
262 | and register_write_type in AnyEvent::Handle, instead support |
|
|
263 | package names (the facility was mostly abused). |
|
|
264 | - implement "packagename-as-read/write type" support in |
|
|
265 | AnyEvent::Handle. |
|
|
266 | - AnyEvent::Handle: new options "keepalive" and "oobinline". |
|
|
267 | - oobinline set by default to avoid security issues. |
|
|
268 | - the pure-perl event loop backend wrongly detected times() fallback |
|
|
269 | support (spotted by Pavel Boldin). |
|
|
270 | |
|
|
271 | 5.12 Tue Sep 1 20:26:50 CEST 2009 |
|
|
272 | - be more lenient when parsing resolv.conf files, as some people |
|
|
273 | use hashmarks as comment indicator inside directives (reported |
|
|
274 | by Michael S. Fischer). |
|
|
275 | - use same set of warnings as common::sense 2.0. |
|
|
276 | - fix a potential 32 bit overflow issue due to perl having problems |
|
|
277 | with large hex constants in the Perl backend. |
|
|
278 | - do not use the slower 5.6 version fo the enc_name code in AnyEvent::DNS |
|
|
279 | by default. |
|
|
280 | - fix some prototypes. |
|
|
281 | - (optionally) require Async::Interrupt 1.02. |
|
|
282 | - replace opendns fallbacks by verizon/level3 public dns servers. |
|
|
283 | |
|
|
284 | 5.112 Fri Aug 21 13:59:04 CEST 2009 |
|
|
285 | - AnyEvent::Handle could cause hard crashes in Net::SSLeay when |
|
|
286 | using starttls with an illegal/uncreatable tls context. |
|
|
287 | - port to broken win32 perls. |
|
|
288 | |
|
|
289 | 5.111 Sun Aug 16 18:44:36 CEST 2009 |
|
|
290 | - perl errornously requires sockaddr_un structures returned by the |
|
|
291 | kernel to have a specific length. work around this bug by padding |
|
|
292 | sockaddr_un structures (found to fail on OS X, as perl only uses |
|
|
293 | the correct code for GNU/Linux, but likely to fail on other |
|
|
294 | OSes as well). |
|
|
295 | |
|
|
296 | 5.11 Wed Aug 12 17:49:37 CEST 2009 |
|
|
297 | - fixed a bug in run_cmd with input from filename. |
|
|
298 | - create a json coder object when none is given in write direction |
|
|
299 | to reduce dependency on JSON. |
|
|
300 | |
|
|
301 | 5.1 Tue Aug 11 03:17:32 CEST 2009 |
|
|
302 | - tcp_connect now reports the correct error in $!, not an unrelated |
|
|
303 | one (was broken since 4.91). |
|
|
304 | - AE::Handle did not properly clear rtimeout/wtimeout watchers |
|
|
305 | when retrying a tcp_connect. |
|
|
306 | - new functions: AnyEvent::Util::run_cmd and close_all_fds_except. |
|
|
307 | - fixed wrong documentation in AE::Socket. |
|
|
308 | |
|
|
309 | 5.01 Mon Aug 10 03:16:32 CEST 2009 |
|
|
310 | - last release broke EV child watchers :/. |
| 2 | |
311 | |
| 3 | 5.0 Sun Aug 9 17:32:09 CEST 2009 |
312 | 5.0 Sun Aug 9 17:32:09 CEST 2009 |
| 4 | - officially introduce and document the AE API. |
313 | - officially introduce and document the AE API. |
| 5 | - lowering the timeout at runtime did not have immediate effect |
314 | - lowering the timeout at runtime did not have immediate effect |
| 6 | in AnyEvent::Handle. |
315 | in AnyEvent::Handle. |
| … | |
… | |
| 49 | - new function: AnyEvent::Socket::format_hostport. |
358 | - new function: AnyEvent::Socket::format_hostport. |
| 50 | |
359 | |
| 51 | 4.881 Tue Jul 28 12:51:53 CEST 2009 |
360 | 4.881 Tue Jul 28 12:51:53 CEST 2009 |
| 52 | - work around a bug in local in pre-5.10 perls, causing |
361 | - work around a bug in local in pre-5.10 perls, causing |
| 53 | AnyEvent::Handle to recurse when it should not |
362 | AnyEvent::Handle to recurse when it should not |
| 54 | (analyzed by elmex). |
363 | (analysed by elmex). |
| 55 | |
364 | |
| 56 | 4.88 Tue Jul 28 04:04:37 CEST 2009 |
365 | 4.88 Tue Jul 28 04:04:37 CEST 2009 |
| 57 | - re-bless the handle into a dummy package after calling |
366 | - re-bless the handle into a dummy package after calling |
| 58 | AnyEvent::Handle::destroy, so the user does not need to check |
367 | AnyEvent::Handle::destroy, so the user does not need to check |
| 59 | for errors after every push_write etc. |
368 | for errors after every push_write etc. |
| … | |
… | |
| 281 | 4.3 Fri Oct 3 09:18:43 CEST 2008 |
590 | 4.3 Fri Oct 3 09:18:43 CEST 2008 |
| 282 | - AnyEvent will now install a no-op signal handler for SIGPIPE, |
591 | - AnyEvent will now install a no-op signal handler for SIGPIPE, |
| 283 | unless one has been installed already. |
592 | unless one has been installed already. |
| 284 | - warn about not loaidng AnyEvent::Impl::POE early enough |
593 | - warn about not loaidng AnyEvent::Impl::POE early enough |
| 285 | (patch by Adam Rosenstein). |
594 | (patch by Adam Rosenstein). |
| 286 | - fixed a great number of bugs and corner cases in AnyEvent::Handle: |
595 | - fixed a great number of bugs and corner cases in AnyEvent::Handle. |
| 287 | - fix a bug in where in SSL connect mode, the |
596 | - fix a bug in where in SSL connect mode, the |
| 288 | client would first wait for some data by the server and |
597 | client would first wait for some data by the server and |
| 289 | otherwise hang. (reported and analyzed in an absolutely |
598 | otherwise hang. (reported and analysed in an absolutely |
| 290 | exemplary manner by Adam Rosenstein). |
599 | exemplary manner by Adam Rosenstein). |
| 291 | - fix a bug in where SSL EOF would not be treated |
600 | - fix a bug in where SSL EOF would not be treated |
| 292 | as stream EOF, putting the connection into a hung state. |
601 | as stream EOF, putting the connection into a hung state. |
| 293 | (reported and analyzed in an absolutely exemplary manner by Adam |
602 | (reported and analysed in an absolutely exemplary manner by Adam |
| 294 | Rosenstein). |
603 | Rosenstein). |
| 295 | - fix a potential segfault when the TLS context |
604 | - fix a potential segfault when the TLS context |
| 296 | would go missing in a read callback (e.g. due to stoptls) - |
605 | would go missing in a read callback (e.g. due to stoptls) - |
| 297 | Net::SSLeay of course makes no type checking whatsoever. |
606 | Net::SSLeay of course makes no type checking whatsoever. |
| 298 | - AnyEvent::Handle will not stop the read watcher in TLS mode. |
607 | - AnyEvent::Handle will not stop the read watcher in TLS mode. |
