pckg_expires_index_blocking

The `pckg_expires_index_blocking` directive configures the behavior of index file expiration in the Kaltura Media Framework.

Syntaxpckg_expires_index_blocking on | off;
Defaultoff
Contexthttp, server, location
Arguments1

Description

The pckg_expires_index_blocking directive is used within the Kaltura Media Framework to control whether the expiration of index files should be blocking. When set to a specific value, it dictates how index files are served when dealing with time-based expiration. This directive is particularly useful for scenarios where live streaming is involved, as it can affect the accessibility of media content depending on the defined expiration behavior. By blocking or allowing delays in serving index files when they expire, this directive can help to ensure a smoother streaming experience for users or manage system load more effectively.

The directive accepts a single argument which specifies its behavior. Enabling this directive may introduce latency in accessing index files, especially in a live-streaming context, as it may lead to waiting on the index file to refresh upon reaching the expiration threshold. Conversely, if set to a non-blocking option, it allows for quicker access to potentially expired index files, although this may expose users to stale data until the index file is refreshed. Therefore, this directive must be configured thoughtfully based on the specific streaming use case and expected behavior of the media delivery setup.

Config Example

http {
    server {
        location /media {
            pckg_expires_index_blocking on;
        }
    }
}

Ensure that the directive is applied in the correct context (http, server, location).

Misconfiguration might lead to unexpected delays in media serving.

Not using this directive correctly can result in serving stale content during live streams.

← Back to all directives