Closing context handles

Depending on mm-renderer's configuration, client applications may be allowed to obtain additional handles to existing contexts. This configuration setting determines mm-renderer's behavior when closing context handles.

Handles obtained by opening existing contexts are called secondary context handles, whereas the handle obtained by creating a context is called the primary context handle. In addition, mm-renderer's configuration may allow a context to exist after its primary handle has been closed. This is called an orphan context. When orphan contexts are allowed, secondary handles are also allowed. Secondary handles may be allowed when orphan contexts aren't. See the descriptions of the -c and -o command-line options for further clarification.

The behavior of mm-renderer in closing context handles depends on your orphan context policy:

In all circumstances, it's important to properly close unneeded context handles to ensure memory leaks don't occur.