curl/lib
Daniel Stenberg c8fba59731 Merge branch 'imap' of https://github.com/bnoordhuis/curl into bnoordhuis-imap 2011-03-13 00:36:38 +01:00
..
.gitignore gitignore: ignore Makefile.vc10.dist made by maketgz 2010-10-13 00:26:19 +02:00
CMakeLists.txt removed trailing whitespace 2010-02-14 19:40:18 +00:00
Makefile.Watcom Updated OpenSSL version, added links to docu. 2011-02-13 12:13:21 +01:00
Makefile.am unittesting: build a separate static lib 2011-01-03 22:16:16 +01:00
Makefile.b32 build: BCC - makefile.b32 tweak 2011-01-13 15:54:14 +01:00
Makefile.inc SSL: (part 2) Added CyaSSL to SSL abstraction layer 2011-03-08 13:54:58 +01:00
Makefile.m32 Updated OpenSSL version, added links to docu. 2011-02-13 12:13:21 +01:00
Makefile.netware Set -fpcc-struct-return only for gcc compiler. 2011-02-17 11:46:41 +01:00
Makefile.vc6 VC: add missing file 2011-03-13 00:23:04 +01:00
Makefile.vxworks remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
README.ares README.ares: we know require c-ares 1.6.0 2010-09-30 23:14:58 +02:00
README.curl_off_t spell! (most of it fixed by Tor Arntsen) 2008-08-27 06:10:47 +00:00
README.curlx remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
README.encoding replaced tabs with spaces 2010-02-16 13:32:45 +00:00
README.hostip Added README.hostip 2005-01-14 13:43:29 +00:00
README.httpauth HTTP "auth done right". See lib/README.httpauth 2004-11-24 16:11:35 +00:00
README.memoryleak remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
README.multi_socket update the section on timeouts 2010-04-12 11:09:55 +02:00
README.pingpong introducing IMAP, POP3 and SMTP support (still lots of polish left to do) 2009-12-12 21:54:01 +00:00
README.pipelining updated to reflect reality 2006-10-29 09:11:44 +00:00
amigaos.c remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
amigaos.h remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
arpa_telnet.h remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
axtls.c Fixed include: memory.h -> curl_memory.h. 2010-12-22 03:34:13 +01:00
axtls.h Initial axTLS integration. Connections can be made and some tests pass. 2010-12-15 16:05:17 +01:00
base64.c remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
config-amigaos.h build: provide SIZEOF_SIZE_T definition for non-configure builds 2010-12-02 21:41:23 +01:00
config-dos.h sources: update source headers 2011-03-10 12:04:33 +01:00
config-mac.h sources: update source headers 2011-03-10 12:04:33 +01:00
config-os400.h sources: update source headers 2011-03-10 12:04:33 +01:00
config-riscos.h sources: update source headers 2011-03-10 12:04:33 +01:00
config-symbian.h sources: update source headers 2011-03-10 12:04:33 +01:00
config-tpf.h sources: update source headers 2011-03-10 12:04:33 +01:00
config-vms.h sources: update source headers 2011-03-10 12:04:33 +01:00
config-vxworks.h sources: update source headers 2011-03-10 12:04:33 +01:00
config-win32.h sources: update source headers 2011-03-10 12:04:33 +01:00
config-win32ce.h sources: update source headers 2011-03-10 12:04:33 +01:00
connect.c SOCKOPTFUNCTION: callback can say already-connected 2011-02-17 22:32:01 +01:00
connect.h Curl_timeleft: s/conn/data in first argument 2011-01-04 23:13:10 +01:00
content_encoding.c inflate_stream: remove redundant check that is always true 2010-09-12 16:34:16 +02:00
content_encoding.h remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
cookie.c cookies: tricked dotcounter fixed 2010-12-23 22:52:32 +01:00
cookie.h remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
curl_addrinfo.c Curl_getaddrinfo_ex: sanitize function results follow-up. 2010-11-24 04:36:57 +01:00
curl_addrinfo.h CURLOPT_RESOLVE: added 2010-11-08 08:56:21 +01:00
curl_base64.h remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
curl_config.h.cmake Enable OpenLDAP support for cygwin builds. 2010-06-04 15:14:31 +02:00
curl_fnmatch.c replace isprint() with ISPRINT() 2010-06-10 02:33:45 +02:00
curl_fnmatch.h ftp wildcard: a new option CURLOPT_FNMATCH_DATA 2010-05-16 02:52:33 +02:00
curl_gethostname.c build: allow NTLM tests to run on more build configurations 2010-08-07 15:03:54 +02:00
curl_gethostname.h build: allow NTLM tests to run on more build configurations 2010-08-07 15:03:54 +02:00
curl_hmac.h include libcurl standard internal headers 2010-06-02 14:13:02 +02:00
curl_ldap.h Fixed libcurl to honour the --disable-ldaps configure option 2011-03-07 17:45:33 -08:00
curl_md4.h http_ntlm: add support for NSS 2010-06-30 13:12:25 +02:00
curl_md5.h Fix compilation problem: declare Curl_HMAC_MD5 as extern in include file. 2010-04-19 12:44:17 +02:00
curl_memory.h remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
curl_memrchr.c remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
curl_memrchr.h remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
curl_rand.c remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
curl_rand.h remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
curl_rtmp.c disconnect: pass on the dead_connection argument 2010-12-06 15:33:38 +01:00
curl_rtmp.h include libcurl standard internal headers 2010-06-02 14:13:02 +02:00
curl_sspi.c Use own typedef as workaround for broken sspi.h header (f.e. Watcom). 2010-09-02 00:38:16 +02:00
curl_sspi.h remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
curl_threads.c remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
curl_threads.h remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
curlx.h Typo fixes. 2010-12-21 22:39:56 +01:00
cyassl.c cyassl: fix compiler warnings 2011-03-08 14:09:20 +01:00
cyassl.h cyassl: fix compiler warnings 2011-03-08 14:09:20 +01:00
dict.c Curl_setup_transfer: no longer returns anything 2010-04-16 23:43:04 +02:00
dict.h remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
easy.c easy: fix compiler warning: end-of-loop code not reached 2010-12-07 03:27:59 +01:00
easyif.h remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
escape.c curl_easy_escape: don't escape "unreserved" characters 2010-09-28 23:49:32 +02:00
escape.h remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
file.c transfer: avoid insane conversion of time_t 2011-03-04 21:17:08 +01:00
file.h remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
fileinfo.c include libcurl standard internal headers 2010-06-02 14:13:02 +02:00
fileinfo.h include libcurl standard internal headers 2010-06-02 14:13:02 +02:00
firefox-db2pem.sh remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
formdata.c fix compiler warning 2010-11-08 04:03:11 +01:00
formdata.h formdata: provide error message 2010-10-20 14:57:43 +02:00
ftp.c Curl_gmtime: added a portable gmtime 2011-02-07 15:00:48 +01:00
ftp.h FTP: WILDCARDMATCH/CHUNKING/FNMATCH added 2010-05-12 23:17:51 +02:00
ftplistparser.c ftp_parselist: fix compiler warning 2010-12-19 00:15:12 +01:00
ftplistparser.h add Curl_ prefix to conform with cURL naming standards 2010-06-09 15:45:46 +02:00
getenv.c remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
getinfo.c fix getinfo CURLINFO_LOCAL* for reused connections (take 2) 2010-11-30 22:14:37 +01:00
getinfo.h remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
gopher.c fix compiler warning: rounding, sign extension, or loss of accuracy may result 2010-12-02 18:46:13 +01:00
gopher.h Gopher protocol support (initial release) 2010-08-25 14:19:58 +02:00
gtls.c CURLE_TLSAUTH_FAILED: removed 2011-02-09 23:34:30 +01:00
gtls.h sendrecv: split the I/O handling into private handler 2010-05-07 15:05:34 +02:00
hash.c remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
hash.h remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
hmac.c fix compiler warning 2010-11-08 04:03:11 +01:00
hostares.c ares_query_completed_cb: don't touch invalid data 2011-01-27 14:41:07 +01:00
hostasyn.c ares: memory leak fix 2011-01-27 14:41:07 +01:00
hostip.c fix compiler warning: conversion may lose significant bits 2010-12-01 23:33:43 +01:00
hostip.h c-ares: fix cancelled resolves 2010-12-27 10:01:44 +01:00
hostip4.c ip_version: moved to connection struct 2010-11-11 15:16:21 +01:00
hostip6.c ip_version: moved to connection struct 2010-11-11 15:16:21 +01:00
hostsyn.c remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
hostthre.c ip_version: moved to connection struct 2010-11-11 15:16:21 +01:00
http.c GSS: handle reuse fix 2011-03-13 00:21:07 +01:00
http.h add_buffer_send: fix compiler warning 2010-07-24 22:52:35 +02:00
http_chunks.c http_chunks: remove debug output 2010-10-17 18:50:38 +02:00
http_chunks.h remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
http_digest.c fix compiler warning 2010-11-08 04:03:11 +01:00
http_digest.h remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
http_negotiate.c negotiation: Wrong proxy authorization 2010-08-16 22:26:52 +02:00
http_negotiate.h HTTP: HTTP Negotiate authentication using SSPI 2011-01-07 23:48:40 +01:00
http_negotiate_sspi.c Added casts to silent gcc warnings. 2011-01-14 12:39:54 +01:00
http_ntlm.c NTLM tests: boost coverage by forcing the hostname 2010-07-30 00:51:24 +02:00
http_ntlm.h remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
idn_win32.c IDN: use win32 API if told to 2010-12-28 20:01:03 +01:00
if2ip.c remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
if2ip.h remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
imap.c IMAP in multi mode: use Curl_ssl_connect_nonblocking() when upgrading the connection to TLS/SSL. 2011-02-20 21:11:12 +01:00
imap.h IMAP in multi mode: use Curl_ssl_connect_nonblocking() when upgrading the connection to TLS/SSL. 2011-02-20 21:11:12 +01:00
inet_ntop.c Remove usage of inet_ntoa and inet_ntoa_r 2008-09-23 19:17:19 +00:00
inet_ntop.h remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
inet_pton.c inet_pton: fix compiler warning 2010-11-25 02:20:14 +01:00
inet_pton.h remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
krb4.c urldata: Capitalize enum protect_level values. 2010-11-13 14:42:34 -08:00
krb4.h security: tighten enum protection_level usage. 2010-11-13 14:12:43 -08:00
krb5.c urldata: Capitalize enum protect_level values. 2010-11-13 14:42:34 -08:00
ldap.c atoi: remove atoi usage 2010-11-28 23:11:14 +01:00
libcurl.def Yang Tse: msvc7+ has deprecated the 'DESCRIPTION' section in 2005-11-14 07:48:05 +00:00
libcurl.imp added missing curl_easy_pause to export list. 2009-08-16 15:03:58 +00:00
libcurl.plist Matt Veenstra updated to 7.12.3. Starting now, we'll update the version number 2004-12-08 23:09:23 +00:00
libcurl.rc remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
llist.c Curl_llist_insert_next: allow insertion first in the list 2010-08-15 13:16:39 +02:00
llist.h llist: hide Curl_llist_init 2010-08-10 11:07:38 +02:00
makefile.amiga Include Makefile.inc to get the list of source files for Amiga 2010-06-07 14:00:16 -07:00
makefile.dj build: lib/config.dos renamed to lib/config-dos.h 2010-12-03 04:13:33 +01:00
md4.c build: remove unneeded cast to (void *) 2010-08-04 19:05:09 +02:00
md5.c build: remove unneeded cast to (void *) 2010-08-04 19:05:09 +02:00
memdebug.c remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
memdebug.h remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
mk-ca-bundle.pl mk-ca-bundle.pl: use new cacert url 2011-02-02 22:22:15 +01:00
mk-ca-bundle.vbs mk-ca-bundle.vbs: use new cacert url 2011-02-03 09:59:00 +01:00
mprintf.c dprintf_formatf: Value stored to 'left' is never read 2010-04-16 23:50:39 +02:00
msvcproj.foot Store now this file in CVS with unix line endings. 2010-01-15 20:23:35 +00:00
msvcproj.head - I renamed everything in the windows builds files that used the name 'curllib' 2009-02-23 09:36:54 +00:00
multi.c multi: close connection on timeout 2011-02-18 23:19:14 +01:00
multiif.h multi: support timeouts 2010-08-15 13:16:39 +02:00
netrc.c netrc: Removed _NETRC_DEBUG code. 2011-02-20 21:11:53 -08:00
netrc.h test1304: Added some unit tests for Curl_parsenetrc. 2011-02-10 07:38:48 -08:00
nonblock.c remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
nonblock.h remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
nss.c nss: do not ignore failure of SSL handshake 2011-02-22 13:19:57 +01:00
nssg.h http_ntlm: add support for NSS 2010-06-30 13:12:25 +02:00
nwlib.c remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
nwos.c remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
openldap.c url: provide dead_connection flag in Curl_handler::disconnect 2010-12-06 14:35:42 +01:00
parsedate.c gmtime: remove define 2011-02-14 13:42:01 +01:00
parsedate.h Curl_gmtime: added a portable gmtime 2011-02-07 15:00:48 +01:00
pingpong.c Trival comment fix. 2010-12-18 17:08:23 +01:00
pingpong.h pingpong: response_time is milliseconds 2010-07-18 00:49:29 +02:00
polarssl.c PolarSSL: Return 0 on receiving TLS CLOSE_NOTIFY alert 2011-02-18 09:17:32 +01:00
polarssl.h include libcurl standard internal headers 2010-06-02 14:13:02 +02:00
pop3.c url: provide dead_connection flag in Curl_handler::disconnect 2010-12-06 14:35:42 +01:00
pop3.h fixed compiler warnings 2010-04-02 21:02:35 +02:00
progress.c remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
progress.h remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
qssl.c Curl_timeleft: s/conn/data in first argument 2011-01-04 23:13:10 +01:00
qssl.h sendrecv: split the I/O handling into private handler 2010-05-07 15:05:34 +02:00
rawstr.c remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
rawstr.h cpp: correct #endif placement 2011-03-06 23:00:28 +01:00
rtsp.c url: provide dead_connection flag in Curl_handler::disconnect 2010-12-06 14:35:42 +01:00
rtsp.h url: provide dead_connection flag in Curl_handler::disconnect 2010-12-06 14:35:42 +01:00
security.c urldata: Capitalize enum protect_level values. 2010-11-13 14:42:34 -08:00
select.c remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
select.h remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
sendf.c Curl_send/recv_plain: return errno on failure 2010-12-05 23:04:11 +01:00
sendf.h sendrecv: split the I/O handling into private handler 2010-05-07 15:05:34 +02:00
setup-os400.h remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
setup.h SSL: (part 2) Added CyaSSL to SSL abstraction layer 2011-03-08 13:54:58 +01:00
setup_once.h gmtime: remove define 2011-02-14 13:42:01 +01:00
share.c remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
share.h remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
slist.c remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
slist.h remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
smtp.c SMTP: add brackets for MAIL FROM 2010-12-22 14:41:53 +01:00
smtp.h Implement SMTP authentication 2010-04-19 11:16:30 +02:00
sockaddr.h remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
socks.c Curl_timeleft: s/conn/data in first argument 2011-01-04 23:13:10 +01:00
socks.h remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
socks_gssapi.c Curl_timeleft: s/conn/data in first argument 2011-01-04 23:13:10 +01:00
socks_sspi.c Curl_timeleft: s/conn/data in first argument 2011-01-04 23:13:10 +01:00
speedcheck.c remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
speedcheck.h remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
splay.c OOM fixes in http_negociate.c and lib/splay.c 2010-05-26 00:40:26 +02:00
splay.h remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
ssh.c SFTP: gracefully handle shutdown early 2011-03-13 00:15:59 +01:00
ssh.h build: fix libssh2_scp_send64() availability 2010-08-05 16:27:39 +02:00
sslgen.c SSL: (part 2) Added CyaSSL to SSL abstraction layer 2011-03-08 13:54:58 +01:00
sslgen.h sendrecv: split the I/O handling into private handler 2010-05-07 15:05:34 +02:00
ssluse.c Call ERR_peek_error instead of ERR_peek_last_error 2011-02-10 12:29:34 -08:00
ssluse.h sendrecv: split the I/O handling into private handler 2010-05-07 15:05:34 +02:00
strdup.c remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
strdup.h remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
strequal.c remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
strequal.h remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
strerror.c CURLE_TLSAUTH_FAILED: removed 2011-02-09 23:34:30 +01:00
strerror.h remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
strtok.c remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
strtok.h remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
strtoofft.c strtoofft: rename CURL_LLONG_MIN -> CURL_OFF_T_MIN 2010-05-29 21:28:16 +02:00
strtoofft.h Typo fixes. 2010-12-21 22:39:56 +01:00
telnet.c moved vars into conditional since seems that winsock implementation doesnt use them. 2010-05-08 05:38:42 +02:00
telnet.h remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
tftp.c Curl_timeleft: s/conn/data in first argument 2011-01-04 23:13:10 +01:00
tftp.h remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
timeval.c remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
timeval.h remove the CVSish $Id$ lines 2010-03-24 11:02:54 +01:00
transfer.c readwrite_upload: stop upload at file size 2011-03-12 23:05:11 +01:00
transfer.h transfer: avoid insane conversion of time_t 2011-03-04 21:17:08 +01:00
url.c Fixed libcurl to honour the --disable-ldaps configure option 2011-03-07 17:45:33 -08:00
url.h url: provide dead_connection flag in Curl_handler::disconnect 2010-12-06 14:35:42 +01:00
urldata.h PROT_CLOSEACTION: added SFTP and SCP 2011-03-12 23:08:10 +01:00
vc6libcurl.dsw Fix CR 2009-05-08 19:09:36 +00:00
vc8proj.foot Use DOS line-endings. 2007-01-29 19:08:04 +00:00
vc8proj.head - I renamed everything in the windows builds files that used the name 'curllib' 2009-02-23 09:36:54 +00:00
version.c Fixed libcurl to honour the --disable-ldaps configure option 2011-03-07 17:45:33 -08:00
warnless.c fix compiler warning: conversion may lose significant bits 2010-12-04 05:53:07 +01:00
warnless.h fix compiler warning: conversion may lose significant bits 2010-12-04 05:53:07 +01:00
wildcard.c ensure that Curl_wildcard_dtor() leaves WildcardData struct zero initialized 2010-06-10 02:30:23 +02:00
wildcard.h include libcurl standard internal headers 2010-06-02 14:13:02 +02:00

README.pipelining

HTTP Pipelining with libcurl
============================

Background

Since pipelining implies that one or more requests are sent to a server before
the previous response(s) have been received, we only support it for multi
interface use.

Considerations

When using the multi interface, you create one easy handle for each transfer.
Bascially any number of handles can be created, added and used with the multi
interface - simultaneously. It is an interface designed to allow many
simultaneous transfers while still using a single thread. Pipelining does not
change any of these details.

API

We've added a new option to curl_multi_setopt() called CURLMOPT_PIPELINING
that enables "attempted pipelining" and then all easy handles used on that
handle will attempt to use an existing pipeline.

Details

- A pipeline is only created if a previous connection exists to the same IP
  address that the new request is being made to use.

- Pipelines are only supported for HTTP(S) as no other currently supported
  protocol has features resemembling this, but we still name this feature
  plain 'pipelining' to possibly one day support it for other protocols as
  well.

- HTTP Pipelining is for GET and HEAD requests only.

- When a pipeline is in use, we must take precautions so that when used easy
  handles (i.e those who still wait for a response) are removed from the multi
  handle, we must deal with the outstanding response nicely.

- Explicitly asking for pipelining handle X and handle Y won't be supported.
  It isn't easy for an app to do this association. The lib should probably
  still resolve the second one properly to make sure that they actually _can_
  be considered for pipelining. Also, asking for explicit pipelining on handle
  X may be tricky when handle X get a closed connection.

- We need options to control max pipeline length, and probably how to behave
  if we reach that limit. As was discussed on the list, it can probably be
  made very complicated, so perhaps we can think of a way to pass all
  variables involved to a callback and let the application decide how to act
  in specific situations. Either way, these fancy options are only interesting
  to work on when everything is working and we have working apps to test with.