mm-renderer command line

Configure multimedia renderer context handle policies, PPS objects, and file permissions


mm-renderer [-cefoq] -r statepath -s serverpath 
        [-U] {username|uid[:gid[,gid]*]} [-u] [-v[v...]]


Destroy a context when the primary handle is closed.
Log to stderr instead of slog.
Stay in the foreground.
Disallow the opening of existing contexts (also implies -c).
Run in quiet mode.
-r statepath
The location of the PPS directory that stores the objects used by the mm-renderer process. We refer to this directory as the PPS state directory, and the default value is /pps/services/multimedia/renderer.

If you want to run multiple mm-renderer instances, you must use different PPS state directories for each instance by providing different paths with the -r option. Running multiple mm-renderer instances can improve security. For example, you could run a coporate mm-renderer that is accessible to only privileged system processes and a personal mm-renderer for use by your client applications. This way, no client could accidentally or intentionally overwrite system memory with buggy or harmful code.

-s serverpath
The full path of the control object in PPS (default: the control object in the /pps/services/multimedia/renderer directory). The value for the -s option may be an absolute path or a relative path; for the latter case, the given path will be appended to the PPS state directory path.

-U { username | uid [:gid [,gid]* ] }
Run mm-renderer with the given username or with the given user ID (uid) and possibly one or many group IDs (gids). When this option isn't specified, mm-renderer uses the client's user ID and group ID.
Don't reset the umask. Without this option, the umask is reset to 0 when mm-renderer starts.
Increase output verbosity. Messages are written to sloginfo.

The -v option is handy when you're trying to understand the operation of mm-renderer, but when lots of -v arguments are used, the logging becomes quite significant and can change timing noticeably. The verbosity setting is good for systems under development but should probably not be used in production systems or when performance testing.


The mm-renderer command line lets you adjust the context handle and logging policies, override the default PPS control object and the state directories, and assign specific file permissions to output files.

The mm-renderer service runs as a server process and responds to media playback commands, and delivers events to clients so they can monitor media operations.