DbgRpc Command-Line Options

The DbgRpc command line must always contain exactly one of the -l, -e, -t, -c, or -a switches. The options following these switches depend on the switch used. The -s, -p, and -r options can be used with any other options.


    dbgrpc [-s Server -p ProtSeq] [-r Radix] -l -P ProcessID -L CellID1.CellID2 

dbgrpc [-s Server -p ProtSeq] [-r Radix] -e [-E EndpointName] 

dbgrpc [-s Server -p ProtSeq] [-r Radix] -t -P ProcessID [-T ThreadID] 

dbgrpc [-s Server -p ProtSeq] [-r Radix] [-c|-a] [-C CallID] [-I IfStart] [-N ProcNum] [-P ProcessID] 

dbgrpc -? 

   

Parameters

-s Server

Allows DbgRpc to view information from a remote machine. The server name should not be preceded by slash marks. For more information about using DbgRpc remotely, see Using the DbgRpc Tool.

-p ProtSeq

Specifies the remote transport to be used. The possible values of ProtSeq are ncacn_ip_tcp (TCP protocol) and ncacn_np (named pipe protocol). TCP protocol is recommended. For more information about using DbgRpc remotely, see Using the DbgRpc Tool.

-r Radix

Specifies the radix to be used for the command parameters. The default is base 16. If the -r parameter is used, it should be placed first on the line, since it only affects parameters listed after itself. It does not affect the output of the DbgRpc tool.

-l

Displays RPC state information for the specified cell. For an example, see Get RPC Cell Information.

ProcessID

Specifies the process ID (PID) of a process. When the -l option is being used, this should be the process whose server contains the desired cell. When the -t option is being used, this should be the process containing the desired thread. When the -c or -a options are being used, this parameter is optional; it should be the server process that owns the calls you wish to display.

CellID1.CellID2

Specifies the number of the cell to be displayed.

-e

Searches the system's RPC state information for endpoint information. For an example, see Get RPC Endpoint Information.

EndpointName

Specifies the number of the endpoint to be displayed. If omitted, the endpoints for all processes on the system are displayed.

-t

Searches the system's RPC state information for thread information. For an example, see Get RPC Thread Information.

ThreadID

Specifies the thread ID of the thread to be displayed. If omitted, all threads in the specified process will be displayed.

-c

Searches the system's RPC state information for server-side call (SCALL) information. For an example, see Get RPC Call Information.

-a

Searches the system's RPC state information for client call (CCALL) information. For an example, see Get RPC Client Call Information. This option requires full RPC state information.

CallID

Specifies the call ID. This parameter is optional; include it only if you want to display calls matching a specific CallID value.

IfStart

Specifies the first DWORD of the interface's universally unique identifier (UUID) on which the call was made. This parameter is optional; include it only if you want to display calls matching a specific IfStart value.

ProcNum

Specifies the procedure number of this call. (The RPC Run-Time identifies individual routines from an interface by numbering them by position in the IDL file -- the first routine in the interface is 0, the second 1, and so on.) This parameter is optional; include it only if you want to display calls matching a specific ProcNum value.

Additional Information

For more information about debugging Microsoft Remote Procedure Call (RPC), see RPC Debugging.

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft