Informational/Trace

The following urlcp settings control various informational and trace behaviors. Note that increasing these settings may cause sensitive information to be printed and/or sent to vortex.log, e.g. authentication or password data.

• badhdrmsgs or badheadermsgs (boolean) Whether to issue a putmsg for malformed response headers. Added (and defaults to on) in version 5.01.1102538511 20041208. Returns previous setting.

• charsetmsgs (boolean) Whether to issue a putmsg for charset conversion problems. The default is on. Added in version 5.00.1089408135 20040709. Returns previous value.

• cookiemsgs (boolean) If true, additional messages are printed when invalid cookies are received and discarded, via the putmsg mechanism (here). If false (default), invalid cookies are silently discarded. Returns previous setting. Added in version 4.01.1022000000 20020521. See also the Cookies section (here).

• fetchmeter (boolean or string)   Whether to print a progress meter during fetches. If true, a hash-mark progress meter is printed for uploads and downloads, where possible. The setting can also be a meter type: one of "simple", "percent" or "none". A true value enables a meter of type "simple". Returns previous value. Added in version 6.

• putmsg pass|save|all|clear [on|off [on|off ...]] (boolean)   Controls the disposition of putmsgs from fetches. The first argument is a boolean action, which is set to the corresponding boolean value from the second (or later) value argument:

  • pass: Whether to pass fetch-related messages through to the normal putmsg mechanisms, i.e. printing, logging and/or <putmsg> function (if enabled). Since messages can also be saved for later return via <urlinfo>, this is often turned off to prevent the need for duplicate handlers. Non-fetch messages (<sql>, etc) are unaffected by this. On by default.

  • save: Whether to save messages in a buffer for later retrieval with <urlinfo putmsgs>. Calling <urlinfo putmsgs> inside a <fetch parallel> loop will return only the messages for the just-completed fetch, making disambiguation of messages easier than with the normal script <putmsg> function callback mechanism. On by default.

  • all: Set pass and save (in that order) according to the next value argument values.

  • clear: Clear the current fetch putmsg buffer. No arguments.

  Returns the previous setting(s) (two values if all used). The putmsg setting was added in version 6.

• redirmsgs (boolean) If true, info messages about redirects will be printed (via the putmsg mechanism). If false (default), such messages are suppressed.

• scriptmsgs (boolean) If true, JavaScript errors are printed/logged via the putmsg mechanism (here). If false (default), such errors are suppressed. Many JavaScript pages generate errors due to script bugs, or varying execution environments, so this setting is off by default. Turning it on can help isolate JavaScript-related issues on a page. Note that this applies to syntax-type errors from the engine; certain external fatal errors are still reported regardless, such as exceeding resource limits (time/memory/page size). Returns previous setting. Added in version 4.01.1023500000 20020607.

• traceauth (integer) Set trace message level for client/server authorization calls. Value is a bitwise OR of any of the following flag values; the default is 0 (i.e. no tracing):

  • 0x0001: Protection spaces made (added, expanded, deleted etc.)

  • 0x0002: Protection spaces used (stop, start, handle, connection closed, headers etc.)

  • 0x0004: Authentication protocol-specific messages

  • 0x0008: Keep-Alive (persistent connections) messages

  • 0x0010: WWW-Authenticate parsing

  • 0x0020: Connection open/close

  • 0x0040: Socket/descriptor/handle open/close
  Note: Setting a non-zero value may also print sensitive data such as authentication or password strings. Flag values may be added to or change in future releases. Added in version 5.1.

• tracecalls (integer) Set trace message level for fetch-related function calls. This is a bitwise OR of integer values indicating which calls to issue messages for; the default is 0 (i.e. no tracing):

  • 0x0001: <urlcp> calls

  • 0x0100: Print full arguments (do not truncate)
  Note that these values may change in future releases, as this is a debug setting. Added in version 5.01.1200000000 20080110.

• tracedns (integer) Set trace message level for DNS (hostname lookup) calls. Value is an incrementing integer, i.e. each level provides messages at its level and all preceding levels; the default is 0 (i.e. no tracing):

  • 0 No tracing

  • 1 gethostbyname(), gethostbyaddr() calls; miscellaneous warnings

  • 2 Service calls (hosts/BIND/NIS); nsswitch.conf and host.conf parse

  • 3 Packets sent/received

  • 4 Individual config entries, /etc/hosts entities, reply RR entries

  • 5 All socket calls
  Values may change or be added to in future releases. Added in version 3.0.948765000 20000124.

• traceencoding (integer) Sets trace message level for content and transfer encoding calls. Value is a bitwise OR of any of the following flags; the default is 0 (i.e. no tracing):

  • 0x0001: Open/close objects

  • 0x0002: ...TranslateEncoding filter calls

  • 0x0004: Decoder object state changes etc.

  • 0x0040: Data read

  • 0x0080: Data written
  Values may change or be added to in future releases. Added in version 5.01.1249039000 20090731.

• tracefetch (integer) Set trace message level for fetch library calls. Value is a bitwise OR of any of the following flags; the default is 0 (i.e. no tracing):

  • 0x0001: User-initiated network fetch

  • 0x0002: Library-initiated fetch

  • 0x0004: Library fetch from cache

  • 0x0008: Static (HTML) links

  • 0x0010: Script links added

  • 0x0020: Static images/frames/etc.

  • 0x0040: Script images/frames/etc.

  • 0x0080: User-initiated format fetch (added in version 6.00.1308202412 20110616)
  Added in version 5.01.1147127000 20060508. Values may change or be added to in future releases.

• tracescript (integer) Set trace message level for JavaScript calls. Value is a bitwise OR of any of the following flags; the default is 0 (i.e. no tracing):

  • 0x0001: Inline scripts run

  • 0x0002: Remote scripts run

  • 0x0004: javascript:-protocol links run

  • 0x0008: Timers run

  • 0x0010: Objects checked for events

  • 0x0020: Modify-and-call-event-handler objects run

  • 0x0040: Event handlers run (normal or modify)

  • 0x0080: Check-string-for-URL called

  • 0x0100: Check-string-for-URL link added

  • 0x0200: Script output inserted (into raw HTML parse buffer)

  • 0x0400: Event handlers added

  • 0x0800: Memory allocated

  • 0x1000: Memory freed
  Added in version 4.04.1082500000 20040420. Values may change or be added to in future releases.

• traceskt (integer) Set trace message level for socket (i.e. over-the-wire network traffic) calls. Value is a bitwise OR of any of the following flag values; the default is 0 (i.e. no tracing):

  • 0x0000001: After open(), close(), accept() etc.

  • 0x0000002: After select()

  • 0x0000004: After reads

  • 0x0000008: After writes

  • 0x0000010: After ioctl(), getsockopt()

  • 0x0000020: Currently unused

  • 0x0000040: The data read

  • 0x0000080: The data written, or sent with ioctl()

  • 0x0000100: Details of SSL verification of peer certificate

  • 0x0010000: Before open(), close(), accept() etc.

  • 0x0020000: Before select()

  • 0x0040000: Before reads

  • 0x0080000: Before writes

  • 0x0100000: Before ioctl(), getsockopt()

  • 0x0200000: Currently unused

  • 0x0400000: The data buffer before reads

  • 0x0800000: The data buffer before writes or ioctl()

  • 0x1000000: Request SSL peer certificate (if not already requested)
  Note: Setting a non-zero value may also print sensitive data such as authentication or password strings. Added in version 5.01.1103682324 20041221. Values may be added to or change in future releases.

• verbose (integer) Sets the verbosity level; used for debugging. This is a bitwise OR of integer values indicating what network protocol information to print:

  • 1: Responses read

  • 2: Requests sent

  • 4: Headers read

  • 8: Headers sent
  Note: Setting a non-zero verbosity level may also print sensitive data such as authentication or password strings. Previous to version 5.01.1093600000 20040826 the verbose setting was an incrementing integer, 0 to 2.