Module jcifs

Package org.codelibs.jcifs.smb.dcerpc

Class DcerpcPipeHandle

java.lang.Object

org.codelibs.jcifs.smb.dcerpc.DcerpcHandle

org.codelibs.jcifs.smb.dcerpc.DcerpcPipeHandle

All Implemented Interfaces:

AutoCloseable, DcerpcConstants

public class DcerpcPipeHandle
extends DcerpcHandle

DCE/RPC handle implementation for named pipe communications. This class provides DCE/RPC communication over SMB named pipes.

Field Summary

Fields inherited from interface org.codelibs.jcifs.smb.dcerpc.DcerpcConstants

DCERPC_CONC_MPX, DCERPC_DID_NOT_EXECUTE, DCERPC_FIRST_FRAG, DCERPC_LAST_FRAG, DCERPC_MAYBE, DCERPC_OBJECT_UUID, DCERPC_PENDING_CANCEL, DCERPC_RESERVED_1, DCERPC_UUID_SYNTAX_NDR, RPC_C_PF_BROADCAST, RPC_C_PF_BROADCAST_MAYBE, RPC_C_PF_IDEMPOTENT, RPC_C_PF_MAYBE, RPC_C_PF_NO_AUTO_LISTEN, RPC_C_PF_NO_AUTO_RETRY, RPC_C_PF_NO_FRAGMENT, RPC_C_PF_NOT_IDEMPOTENT, RPC_PT_ACK, RPC_PT_ALTER_CONTEXT, RPC_PT_ALTER_CONTEXT_RESPONSE, RPC_PT_BIND, RPC_PT_BIND_ACK, RPC_PT_BIND_NAK, RPC_PT_CANCEL, RPC_PT_CO_CANCEL, RPC_PT_FAULT, RPC_PT_ORPHANED, RPC_PT_PING, RPC_PT_REJECT, RPC_PT_REQUEST, RPC_PT_RESPONSE, RPC_PT_SHUTDOWN

Constructor Summary

Constructors

Constructor	Description
DcerpcPipeHandle(String url, CIFSContext tc, boolean unshared)	Creates a DCERPC pipe handle for named pipe communication

Method Summary

Modifier and Type	Method	Description
void	close()
protected int	doReceiveFragment(byte[] buf)	Receives a DCERPC fragment from the remote endpoint
protected void	doSendFragment(byte[] buf, int off, int length)	Sends a DCERPC fragment to the remote endpoint
protected int	doSendReceiveFragment(byte[] buf, int off, int length, byte[] inB)	Sends a DCERPC fragment and receives the response in a single operation
String	getServer()	Gets the server hostname or address currently connected to
String	getServerWithDfs()	Gets the server hostname resolved through DFS (Distributed File System)
byte[]	getSessionKey()	Gets the session key from the underlying SMB session for encryption
CIFSContext	getTransportContext()	Gets the CIFS context used for transport operations

Methods inherited from class org.codelibs.jcifs.smb.dcerpc.DcerpcHandle

bind, encodeMessage, getBinding, getHandle, getHandle, parseBinding, sendrecv, setDcerpcSecurityProvider, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Details

DcerpcPipeHandle

public DcerpcPipeHandle(String url,
 CIFSContext tc,
 boolean unshared)
                 throws DcerpcException,
MalformedURLException

Creates a DCERPC pipe handle for named pipe communication

Parameters:

url - the DCERPC URL specifying the endpoint

tc - the CIFS context for connection configuration

unshared - whether to use an exclusive connection

Throws:

DcerpcException - if DCERPC initialization fails

MalformedURLException - if the URL is malformed

Method Details

getTransportContext

public CIFSContext getTransportContext()

Description copied from class: DcerpcHandle

Gets the CIFS context used for transport operations

Specified by:

getTransportContext in class DcerpcHandle

Returns:

the transport context used

getServer

public String getServer()

Description copied from class: DcerpcHandle

Gets the server hostname or address currently connected to

Specified by:

getServer in class DcerpcHandle

Returns:

the server connected to

getServerWithDfs

public String getServerWithDfs()

Description copied from class: DcerpcHandle

Gets the server hostname resolved through DFS (Distributed File System)

Specified by:

getServerWithDfs in class DcerpcHandle

Returns:

the server resolved by DFS

getSessionKey

public byte[] getSessionKey()
                     throws CIFSException

Description copied from class: DcerpcHandle

Gets the session key from the underlying SMB session for encryption

Specified by:

getSessionKey in class DcerpcHandle

Returns:

session key of the underlying smb session

Throws:

CIFSException - if unable to retrieve the session key

doSendReceiveFragment

protected int doSendReceiveFragment(byte[] buf,
 int off,
 int length,
 byte[] inB)
                             throws IOException

Sends a DCERPC fragment and receives the response in a single operation

Specified by:

doSendReceiveFragment in class DcerpcHandle

Parameters:

buf - the outgoing buffer containing the request

off - the offset into the outgoing buffer

length - the length of data to send

inB - the buffer to receive the response

Returns:

the number of bytes received

Throws:

IOException - if an I/O error occurs during the operation

See Also:

• DcerpcHandle.doSendReceiveFragment(byte[], int, int, byte[])

doSendFragment

protected void doSendFragment(byte[] buf,
 int off,
 int length)
                       throws IOException

Description copied from class: DcerpcHandle

Sends a DCERPC fragment to the remote endpoint

Specified by:

doSendFragment in class DcerpcHandle

Parameters:

buf - the buffer containing the fragment data

off - the offset into the buffer

length - the length of data to send

Throws:

IOException - if an I/O error occurs during transmission

doReceiveFragment

protected int doReceiveFragment(byte[] buf)
                         throws IOException

Description copied from class: DcerpcHandle

Receives a DCERPC fragment from the remote endpoint

Specified by:

doReceiveFragment in class DcerpcHandle

Parameters:

buf - the buffer to receive the fragment data

Returns:

the number of bytes received

Throws:

IOException - if an I/O error occurs during reception

close

public void close()
           throws IOException

Specified by:

close in interface AutoCloseable

Overrides:

close in class DcerpcHandle

Throws:

IOException