Configure multimedia renderer context handle policies, PPS objects, and file
permissions
Synopsis:
mm-renderer [-cefoq] -r statepath -s serverpath
[-U] {username|uid[:gid[,gid]*]} [-u] [-v[v...]]
Options:
- -c
- Destroy a context when the primary handle is closed.
- -e
- Log to stderr instead of slog.
- -f
- Stay in the foreground.
- -o
- Disallow the opening of existing contexts (also implies
-c).
- -q
- 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.
- -u
- Don't reset the umask. Without this option, the umask is reset to 0 when
mm-renderer starts.
- -v
- 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.
Description:
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.