urlcp settings control resources used by
the fetch functions, such as time, size, memory and files:
<SCRIPT SRC=...></SCRIPT>to also fetch for a document. The default is 5. Frames are only fetched if
<IFRAME>s only if
maxhdrsize(integer) The maximum size of headers allowed; when exceeded a "Max headers size exceeded (truncated)" message is generated. The default is 128K; -1 indicates no limit. It is rarely necessary to increase this limit, as headers are small and mostly fixed in size. Added in version 2.6.937800000 19990920; was part of
maxpgsizein prior versions. In version 4.01.1023500000 20020607 and later the previous setting is returned. Aka
maxconnidletime(double) Maximum idle time in seconds (unused time between requests) that a connection may be opened before it is closed and not reused for Keep-Alive. The default is 5. Added in version 5.00.1094074734 20040901. Returns previous setting.
maxconnlifetime(double) Maximum seconds of real time that a connection can be open and still be re-used with Keep-Alive for future requests. Idle connections that are older than this will be closed. Defaults to 600 (i.e. 10 minutes). Added in version 5.00.1096313795 20040927. Returns previous setting.
maxdownloadsize(integer) Sets the maximum download size (network transfer size) of a response document body. -1 indicates no limit, and is the default. Maximum download size is checked before content and transfer encodings are decoded, i.e. it is a limit on network transfer size, not final document size (which the
maxpgsizesetting controls). A network transfer that exceeds
maxdownloadsizewill generate a "Max download size exceeded (truncated)" error message, and the transfer will be aborted. Added in version 5.01.1249039000 20090731. Aka
Note that since encodings are decoded on-the-fly as the document
is downloaded, not only will exceeding
abort the transfer, but typically so will exceeding
maxpgsize - though possibly at an earlier point, if a
compression encoding was used. This is why
can usually be left at its -1 (unlimited) default, and just
maxpgsize set instead: the latter setting controls final
doc size, and indirectly sets an upper limit for network
transfer bandwidth. Thus both memory and network usage can be
maxidleconn(integer) Maximum number of idle connections to cache for future Keep-Alive requests. Added in version 5.1, where the default is 2. Returns previous setting.
Sets the maximum number of page requests to do on a single
Keep-Alive connection, before closing the connection and
re-opening a new one. -1 sets no limit. Added in version
4.04.1068090000 20031105, where the default was 0, and Keep-Alive
was only supported if
<urlcp netmode sys> was set. In
version 5.1, the default is 100, and Keep-Alive is supported for
<urlcp netmode int> fetches as well. Setting 1 (or
0) turns off Keep-Alive, i.e. all requests send a
Connection: close header and only one request per connection
is used. Note that a value of 3 or more is needed for NTLM
authentication (Integrated Windows Authentication) to function.
Returns previous setting.
pagecachesz(integer) Maximum page cache size in bytes. Only indirect pages are cached (e.g. frames, iframes, scripts), not directly
<fetch>ed pages. Default is 5MB. Suffixes
GBmay be given, e.g. "
5MB". Returns previous setting. Added in version 5.00.1096313795 20040927.
maxpgsize(integer) Sets the maximum page size that will be accepted for a document. Documents that are longer will be truncated and generate a "Max page size exceeded (truncated)" message. The default is 100MB; a setting of -1 indicates no limit. In versions prior to 8, the default was 512KB. In versions prior to 2.6.937800000 19990920, the default was 100KB, the size of any headers was included, and -1 was not permitted. In version 4.01.1023500000 20020607 and later the previous setting is returned. Aka
The maximum page size is checked after all content and/or
transfer encodings (if any) are decoded; i.e. it controls the size
of the final document returned by
<fetch>. Since encodings
are decoded on-the-fly as the document is downloaded, reaching
maxpgsize will also typically abort the network transfer as
well. See also the
maxdownloadsize setting for limiting
network document size directly (though setting
maxprotspacecachesize(integer) Maximum protection space cache size in bytes. The protection space cache is used to determine which URLs are protected with what user/pass credentials, so that later fetches to the same space do not need to negotiate credentials (and waste transactions). Defaults to 128KB. Suffixes
GBmay be given, e.g. "
5MB". Returns previous setting. Added in version 5.1.
Maximum idle time of a protection space in the cache, in seconds. After this amount of time in disuse, the protection space will be deleted, which means future fetches may have to re-negotiate credentials. Defaults to 3600 (i.e. 1 hour); -1 is unlimited. Returns previous setting. Added in version 7.06.1465935000 20160614.
Maximum lifetime of a protection space in the cache, in seconds. After this amount of time since its creation, the protection space will be deleted, which means future fetches may have to re-negotiate credentials. Defaults to -1 (unlimited). Returns previous setting. Added in version 5.1. Prior to version 7.06.1465935000 20160614, the default was 3600 (one hour).
Sets the maximum number of redirects that will be followed per URL
fetch. Exceeding this limit generates the error "Too many
redirections (N) while fetching ..." and the fetch fails. The
limit may be 0 to disallow redirects altogether. The default
maxredirs value is
20 (5 in Texis version 7 and earlier).
Sets the time in seconds before retrying a failed
pacurl fetch (here), if enabled.
Because all URLs fetched depend on the proxy auto-config script,
<fetch>es would keep attempting to re-fetch the same
PAC URL if it fails. Thus, to reduce the load on the PAC URL
server, the PAC script will not be re-fetched after error for
pacfetchretrydelay seconds. The default is 10; a negative
value means infinite (never retry automatically). Changing the
pacurl will clear the last-try timestamp and allow a
re-fetch to occur. Added in version 7.05.
Sets the time in seconds before retrying a proxy when other
proxies are available. When proxy auto-config is enabled
(here), it is possible that the
FindProxyForURL() PAC function may return more than one
proxy for a given URL: these proxies are normally tried in the
order returned, until one succeeds. However, a "bad"
(e.g. unresponsive) proxy is flagged in the proxy cache: every
will be altered to have such bad proxies moved to the end of the
list. This deprecation lasts
proxyretrydelay seconds (or
until the proxy succeeds).
This allows successive
<fetch>es to dynamically adapt to
unresponsive proxies, even when the
may be constant or unaware of the proxy's unresponsiveness. For
FindProxyForURL() always returns
"PROXY flaky.example.com; PROXY reliable.example.com",
flaky.example.com proxy detectably fails, future
fetches will try
reliable.example.com first, for up to
proxyretrydelay seconds, instead of waiting for
flaky.example.com to fail first.
FindProxyForURL() always returns just
PROXY flaky.example.com", that proxy will alway be
tried, even after failure: there is no other proxy offered to try.
proxyretrydelay setting was added in version 7.05, and
defaults to 300. Negative values mean infinite, i.e. never
automatically retry a bad proxy (when others are offered). The
internal cache of bad proxies may be cleared with the
clearproxycache option (here).
savedownloaddoc(boolean) Whether to save the network-transferred download doc, if it varies from the final (after content/transfer encodings decoded) document. The default is off to save memory, since the decoded document is usually more useful. Added in version 5.01.1249203000 20090802.
scripttimeoutand allows some timers to run, but doesn't wait indefinitely for an infinitely-recurring
setInterval(). A value of -1 means no limit (but
scripttimeoutstill applies). Returns previous value. Added in version 4.03.1050609000 20030417. See also
KBmay be appended to the integer value for clarity. The default value is
Sets the threshold of
engine should begin garbage collection. Can be a percentage
(e.g. the default of "75%"), or an absolute integer/size
(e.g. "15MB"). Added in version 7.06.1490209000 20170322.
<SCRIPT>block. This timeout also applies after the page has been fetched, so it need not be smaller than the page
timeout. The default is 5 seconds. -1 indicates no limit. Returns previous setting. Added in version 4.01.1023500000 20020607. Do not confuse this setting with the Vortex script timeout (here), nor the fetch
Sets the per-fetch timeout, in seconds. A document fetch that
takes longer than the timeout is aborted, the data read so far (if
any) is returned, and an error message is issued (may be captured
putmsg, here). The default is 30
seconds. This timeout applies to
nslookup, and to
each URL fetched by
submit, so a framed
document or one with
<SCRIPT SRC=...> links, redirects
etc. may take longer. Do not confuse this setting with the
Vortex script timeout (here), nor the
writebuffersize(integer) Sets the initial buffer size to use for some writes, e.g. for writing
<submit TOFILE>documents to disk, or decoding content/transfer encodings. The default is 32KB. Some write buffers may increase past this limit if needed. Added in version 5.01.1249039000 20090731. Returns previous buffer size.