manpagez: man pages & more
man rpcsvchost(8)
Home | html | info | man
rpcsvchost(8)             BSD System Manager's Manual            rpcsvchost(8)


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, -nodebug
              rpcsvchost will log debug information and may perform extra
              diagnostic checks. This option is typically only useful for
              debugging.

     -endpoints BINDING [,BINDING]
              This argument specifies additional endpoints that rpcsvchost
              should 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, rpcsvchost attempts to bind all the well-known end-
              points specified by the service plugins.  If there are no well-
              known endpoints, it will bind new endpoints on all supported
              protocol sequences. The -launchd option disables this behavior
              and causes rpcsvchost to check in with launchd(8) to obtain a
              set of sockets to bind as protocol endpoints.

              Launchd sockets vended to rpcsvchost must be named with the
              appropriate DCE/RPC protocol sequence (eg. "ncacn_np").

     -sandbox, -nosandbox
              When this option is specified, the modules loaded by rpcsvchost
              will be run in a sandbox.  rpcsvchost will 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, rpcsvchost attempts to register
              the loaded services with the DCE/RPC endpoint mapper.

     -stdout  Causes rpcsvchost to print log messages to standard output
              instead of the system log.

     -wait-for-debugger
              Causes rpcsvchost to wait for a debugger to attach after it has
              loaded and initialized its plugins. This is useful for debugging
              instances of rpcsvchost that are launched by launchd(8).


DIAGNOSTICS

     The rpcsvchost utility exits 0 on success, and >0 if an error occurs.


SEE ALSO

     launchd.plist(5), launchd(8), sandbox(7)


HISTORY

     The rpcsvchost utility first appeared in Mac OS 10.7.

Darwin                         September 7, 2011                        Darwin

Mac OS X 10.7 - Generated Wed Sep 7 18:15:50 CDT 2011
© manpagez.com 2000-2024
Individual documents may contain additional copyright information.