NAME
rpcsvchost —
hosting environment for DCE/RPC
services
SYNOPSIS
rpcsvchost |
[options] service
[service ...] |
DESCRIPTION
rpcsvchost is a very simple environment
for hosting DCE/RPC services. It loads DCE/RPC services from the list of
plugins given as arguments, binds to an appropriate set of endpoints and
listens for protocol requests.
If service is not a relative file name, it is assumed to be the name of a dylib located in /usr/lib/rpcsvc.
OPTIONS
-debug,-nodebugrpcsvchostwill log debug information and may perform extra diagnostic checks. This option is typically only useful for debugging.-endpointsBINDING [,BINDING]- This argument specifies additional endpoints that
rpcsvchostshould attempt to bind. BINDING must be a comma-separated list of DCE/RPC binding strings that include both the protocol sequence and endpoint fields. -help- Prints a usage message and exits.
-launchd,-nolaunchd- Normally,
rpcsvchostattempts to bind all the well-known endpoints specified by the service plugins. If there are no well-known endpoints, it will bind new endpoints on all supported protocol sequences. The-launchdoption disables this behavior and causesrpcsvchostto check in with launchd(8) to obtain a set of sockets to bind as protocol endpoints.Launchd sockets vended to
rpcsvchostmust be named with the appropriate DCE/RPC protocol sequence (eg. "ncacn_np"). -sandbox,-nosandbox- When this option is specified, the modules loaded by
rpcsvchostwill be run in a sandbox.rpcsvchostwill attempt to intialize the sandbox using the sandbox profile with the name com.apple.<module-name>.sb. See sandbox(7) for an overview of the sandbox facility. -register,-noregister- When this option is specified,
rpcsvchostattempts to register the loaded services with the DCE/RPC endpoint mapper. -stdout- Causes
rpcsvchostto print log messages to standard output instead of the system log. -wait-for-debugger- Causes
rpcsvchostto wait for a debugger to attach after it has loaded and initialized its plugins. This is useful for debugging instances ofrpcsvchostthat are launched by launchd(8).
DIAGNOSTICS
The rpcsvchost utility exits 0 on
success, and >0 if an error occurs.
SEE ALSO
HISTORY
The rpcsvchost utility first appeared in
Mac OS 10.7.