Skip to content

HTTP input

Register name used to load filter: httpin
This filter may be automatically loaded during graph resolution.

This filter dispatch raw blocks from a remote HTTP resource into a filter chain.
Block size can be adjusted using block_size, and disk caching policies can be adjusted.
Content format can be forced through mime and file extension can be changed through ext.

The filter supports both http and https schemes, and will attempt reconnecting as TLS if TCP connection fails.

Note: Unless disabled at session level (see -no-probe ), file extensions are usually ignored and format probing is done on the first data block.

Options

src (cstr): URL of source content

block_size (uint, default: 100000): block size used to read file

cache (enum, default: none): set cache mode

  • auto: cache to disk if content length is known, no cache otherwise
  • disk: cache to disk, discard once session is no longer used
  • keep: cache to disk and keep
  • mem: stores to memory, discard once session is no longer used
  • mem_keep: stores to memory, keep after session is reassigned but move to mem after first download
  • none: no cache
  • none_keep: stores to memory, keep after session is reassigned but move to none after first download

range (lfrac, default: 0-0): set byte range, as fraction

ext (cstr): override file extension

mime (cstr): set file mime type

blockio (bool, default: false): use blocking IO

idelay (uint, default: 0): delay first request by the given number of ms

Was this page helpful?