class SSHChannel(log.Logger): (source)
Known subclasses: twisted.conch.client.agent.SSHAgentForwardingChannel
, twisted.conch.scripts.cftp.SSHSession
, twisted.conch.scripts.conch.SSHSession
, twisted.conch.scripts.tkconch.SSHSession
, twisted.conch.ssh.forwarding.SSHConnectForwardingChannel
, twisted.conch.ssh.forwarding.SSHListenForwardingChannel
, twisted.conch.ssh.session.SSHSession
, twisted.conch.endpoints._CommandChannel
Constructor: SSHChannel(localWindow, localMaxPacket, remoteWindow, remoteMaxPacket, ...)
Implements interfaces: twisted.internet.interfaces.ITransport
A class that represents a multiplexed channel over an SSH connection. The channel has a local window which is the maximum amount of data it will receive, and a remote which is the maximum amount of data the remote side will accept. There is also a maximum packet size for any individual data packet going each way.
Method | __bytes__ |
Return a byte string representation of the channel |
Method | __init__ |
Undocumented |
Method | __str__ |
Undocumented |
Method | add |
Called when bytes are added to the remote window. By default it clears the data buffers. |
Method | channel |
Called when the channel is opened. specificData is any data that the other side sent us when opening the channel. |
Method | closed |
Called when the channel is closed. This means that both our side and the remote side have closed the channel. |
Method | close |
Called when the other side has closed the channel. |
Method | data |
Called when we receive data. |
Method | eof |
Called when the other side will send no more data. |
Method | ext |
Called when we receive extended data (usually standard error). |
Method | get |
See: ITransport.getHost |
Method | get |
See: ITransport.getPeer |
Method | log |
Override this method to insert custom logging behavior. Its return value will be inserted in front of every line. It may be called more times than the number of output lines. |
Method | lose |
Close the channel if there is no buferred data. Otherwise, note the request and return. |
Method | open |
Called when the open failed for some reason. reason.desc is a string descrption, reason.code the SSH error code. |
Method | request |
Called when a request is sent to this channel. By default it delegates to self.request_<requestType>. If this function returns true, the request succeeded, otherwise it failed. |
Method | start |
Called when the remote buffer has more room, as a hint to continue writing. |
Method | stop |
Called when the remote buffer is full, as a hint to stop writing. This can be ignored, but it can be helpful. |
Method | write |
Write some data to the channel. If there is not enough remote window available, buffer until it is. Otherwise, split the data into packets of length remoteMaxPacket and send them. |
Method | write |
Send extended data to this channel. If there is not enough remote window available, buffer until there is. Otherwise, split the data into packets of length remoteMaxPacket and send them. |
Method | write |
Part of the Transport interface. Write a list of strings to the channel. |
Instance Variable | are |
Undocumented |
Instance Variable | avatar |
an avatar for the logged-in user (if a server channel) |
Instance Variable | buf |
Undocumented |
Instance Variable | closing |
Undocumented |
Instance Variable | conn |
the connection this channel is multiplexed through. |
Instance Variable | data |
any data to send to the other side when the channel is requested. |
Instance Variable | ext |
Undocumented |
Instance Variable | id |
Undocumented |
Instance Variable | local |
True if we aren't accepting more data. |
Instance Variable | local |
the maximum size of packet we will accept in bytes. |
Instance Variable | local |
how many bytes are left in the local window. |
Instance Variable | local |
the maximum size of the local window in bytes. |
Instance Variable | name |
the name of the channel. |
Instance Variable | remote |
True if the other side isn't accepting more data. |
Instance Variable | remote |
the maximum size of a packet the remote side will accept in bytes. |
Instance Variable | remote |
how many bytes are left in the remote window. |
Instance Variable | specific |
Undocumented |
Class Variable | _log |
Undocumented |
Called when bytes are added to the remote window. By default it clears the data buffers.
Parameters | |
data:bytes | Undocumented |
twisted.conch.client.agent.SSHAgentForwardingChannel
, twisted.conch.scripts.cftp.SSHSession
, twisted.conch.scripts.conch.SSHSession
, twisted.conch.scripts.tkconch.SSHSession
, twisted.conch.ssh.forwarding.SSHConnectForwardingChannel
, twisted.conch.ssh.forwarding.SSHListenForwardingChannel
, twisted.conch.endpoints._CommandChannel
Called when the channel is opened. specificData is any data that the other side sent us when opening the channel.
Parameters | |
specificbytes | Undocumented |
twisted.conch.client.agent.SSHAgentForwardingChannel
, twisted.conch.scripts.cftp.SSHSession
, twisted.conch.scripts.conch.SSHSession
, twisted.conch.scripts.tkconch.SSHSession
, twisted.conch.ssh.forwarding.SSHConnectForwardingChannel
, twisted.conch.ssh.forwarding.SSHListenForwardingChannel
, twisted.conch.ssh.session.SSHSession
, twisted.conch.endpoints._CommandChannel
Called when the channel is closed. This means that both our side and the remote side have closed the channel.
twisted.conch.client.agent.SSHAgentForwardingChannel
, twisted.conch.scripts.conch.SSHSession
, twisted.conch.scripts.tkconch.SSHSession
, twisted.conch.ssh.forwarding.SSHConnectForwardingChannel
, twisted.conch.ssh.forwarding.SSHListenForwardingChannel
, twisted.conch.ssh.session.SSHSession
, twisted.conch.endpoints._CommandChannel
Called when we receive data.
Parameters | |
data:bytes | Undocumented |
twisted.conch.scripts.cftp.SSHSession
, twisted.conch.scripts.conch.SSHSession
, twisted.conch.scripts.tkconch.SSHSession
, twisted.conch.ssh.forwarding.SSHListenForwardingChannel
, twisted.conch.ssh.session.SSHSession
Called when the other side will send no more data.
See: ITransport.getHost
Returns | |
SSHTransportAddress . | An address describing this side of the connection. |
twisted.python.log.Logger.logPrefix
Override this method to insert custom logging behavior. Its return value will be inserted in front of every line. It may be called more times than the number of output lines.
twisted.conch.ssh.session.SSHSession
Close the channel if there is no buferred data. Otherwise, note the request and return.
twisted.conch.ssh.forwarding.SSHListenForwardingChannel
, twisted.conch.endpoints._CommandChannel
Called when the open failed for some reason. reason.desc is a string descrption, reason.code the SSH error code.
Parameters | |
reason:error.ConchError | Undocumented |
Called when the remote buffer is full, as a hint to stop writing. This can be ignored, but it can be helpful.
Write some data to the channel. If there is not enough remote window available, buffer until it is. Otherwise, split the data into packets of length remoteMaxPacket and send them.
Parameters | |
data:bytes | Undocumented |
Part of the Transport interface. Write a list of strings to the channel.
Parameters | |
data:list of str | Undocumented |
twisted.conch.client.agent.SSHAgentForwardingChannel
, twisted.conch.ssh.session.SSHSession
Undocumented
twisted.conch.scripts.cftp.SSHSession
, twisted.conch.scripts.conch.SSHSession
, twisted.conch.scripts.tkconch.SSHSession
, twisted.conch.ssh.forwarding.SSHListenClientForwardingChannel
, twisted.conch.ssh.forwarding.SSHListenServerForwardingChannel
, twisted.conch.ssh.session.SSHSession
, twisted.conch.endpoints._CommandChannel
the name of the channel.