kmp_cc_out_max_free_buffers

Sets the maximum number of free output buffers for the Kaltura Media Framework in NGINX.

Syntaxkmp_cc_out_max_free_buffers number;
Defaultnone
Contextstream, stream server
Arguments1

Description

The kmp_cc_out_max_free_buffers directive specifies the maximum number of output buffers that should be kept free for the Kaltura Media Framework when handling streaming media. This directive is particularly pertinent in optimizing the performance of media streaming within NGINX by controlling the availability of these buffers, which directly affect the streaming latency and throughput. When the number of free buffers exceeds the limit set by this directive, older buffers may be deallocated or reused for new requests to ensure optimal memory management.

The parameter for this directive is a single numeric value that determines the upper limit for these free buffers. A well-tuned value can enhance performance by reducing memory usage while still maintaining sufficient buffers for handling streaming data. Set too low, it could lead to buffer shortages, impacting media delivery performance. Conversely, setting it too high can lead to excessive memory allocation without tangible performance gains. Therefore, it’s important to evaluate the specific requirements of your media streaming setup when configuring this value.

Config Example

stream {
    server {
        kmp_cc_out_max_free_buffers 1024;
    }
}

Ensure that the value is an appropriate balance; too high can waste memory, too low can cause streaming delays.

This directive only applies within the stream or stream server context; attempting to set it elsewhere will yield an error.

← Back to all directives