ad_returnfile_background (public)

 ad_returnfile_background [ -client_data client_data ] status_code \
    mime_type filename

Defined in packages/xotcl-core/tcl/bgdelivery-procs.tcl

Deliver the given file to the requester in the background. When using NaviServer with its writer threads, ns_returnfile is perfectly fine since it delivers its contents already in the background. The main reason for using the bgdelivery thread is currently (2019) the support of h264 streaming (when the module is in use). So we check, whether h264 is available and requested, otherwise pass everything to ns_returnfile.

Switches:

-client_data (optional)

Parameters:

status_code (required)

mime_type (required)

filename (required)

Partial Call Graph (max 5 caller/called nodes):

Testcases:

nested_self_references

Source code:

  #ns_log notice "ad_returnfile_background xo::use_h264 -> [xo::use_h264 $mime_type]"

  security::csp::add_static_resource_header -mime_type $mime_type
  if {[xo::use_h264 $mime_type]} {
    bgdelivery returnfile -client_data $client_data $status_code $mime_type $filename
  } else {
    ns_returnfile $status_code $mime_type $filename
  }

XQL Not present:

Generic, PostgreSQL, Oracle