Documentation Language: Swift

Documentation

SSHAgent

Core Types

C SSHAgent
- Instance Methods
- Type Properties
  - P static let shared: SSHAgent
- Default Implementations
  - Actor Implementations
    - Instance Methods
S SSHAgentKey
- Initializers
  - M init(keyBlob: Data, comment: String, debug: Bool) throws
- Instance Properties
E SSHAgentError
- Enumeration Cases
- Default Implementations
  - Error Implementations
    - Instance Properties
      - P var localizedDescription: String
E SSHAgentMessageType
- Enumeration Cases
  - E case failure
  - E case identitiesAnswer
  - E case requestIdentities
  - E case signRequest
  - E case signResponse
  - E case success
- Initializers
  - M init?(rawValue: UInt8)
- Default Implementations
  - Equatable Implementations
    - Operators
      - static func != (Self, Self) -> Bool
  - RawRepresentable Implementations
    - Instance Properties
      - P var hashValue: Int
    - Instance Methods
      - M func hash(into: inout Hasher)
S SSHAgentSignFlags
- Initializers
  - M init(rawValue: UInt32)
- Instance Properties
  - P let rawValue: UInt32
- Type Properties
  - P static let rsaSha2_256: SSHAgentSignFlags
  - P static let rsaSha2_512: SSHAgentSignFlags
- Default Implementations
  - Equatable Implementations
    - Operators
      - static func != (Self, Self) -> Bool
  - OptionSet Implementations
    - Initializers
      - M init()
    - Instance Methods
  - SetAlgebra Implementations
    - Initializers
      - M init<S>(S)
      - M init(arrayLiteral: Self.Element...)
    - Instance Properties
      - P var isEmpty: Bool
    - Instance Methods
T SendableData

Signing Support

M func createNIOSSHPrivateKey(for: SSHAgentKey) async throws -> NIOSSHPrivateKey
M func requestSignature<DataBytes>(for: DataBytes, usingKey: SSHAgentKey, flags: SSHAgentSignFlags) async throws -> Data
C SSHAgentPrivateKey
- Initializers
  - M init(agentKey: SSHAgentKey, agent: SSHAgent)
- Instance Properties
  - P var publicKey: NIOSSHPublicKey
- Instance Methods
  - M func sign<DataBytes>(DataBytes) async throws -> Data

Protocol Handling

M func requestIdentities() async -> [SSHAgentKey]
Agent Protocol Notes
- Relevant Symbols
  - M func requestIdentities() async -> [SSHAgentKey]
  - M func requestSignature<DataBytes>(for: DataBytes, usingKey: SSHAgentKey, flags: SSHAgentSignFlags) async throws -> Data

SSHClient

Essentials

C SSHClient
S SSHClientConfiguration
- Initializers
  - M init(host: String, port: Int, username: String, password: String?, debug: Bool)
- Instance Properties
  - P let debug: Bool
  - P let host: String
  - P let password: String?
  - P let port: Int
  - P let username: String
- Type Methods
  - M static func parseDestination(String, defaultUsername: String?) -> (host: String, port: Int, username: String)
S CommandResult
- Initializers
  - M init(exitStatus: Int, output: Data, errorOutput: Data)
- Instance Properties
  - P let errorOutput: Data
  - P let exitStatus: Int
  - P let output: Data
E SSHClientError
- Enumeration Cases
- Default Implementations
  - Equatable Implementations
    - Operators
      - static func != (Self, Self) -> Bool
  - Error Implementations
    - Instance Properties
      - P var localizedDescription: String

Interactive and Non-Interactive Sessions

M func connect() async throws
M func executeCommand(String) async throws -> CommandResult
M func startInteractiveShell(term: String, terminalCharacterWidth: Int, terminalRowHeight: Int, terminalPixelWidth: Int, terminalPixelHeight: Int, terminalModes: SSHTerminalModes) async throws -> Int
Running Sessions
- Session APIs
  - M func executeCommand(String) async throws -> CommandResult
  - M func startInteractiveShell(term: String, terminalCharacterWidth: Int, terminalRowHeight: Int, terminalPixelWidth: Int, terminalPixelHeight: Int, terminalModes: SSHTerminalModes) async throws -> Int

Port Forwarding

S PortForwardingConfiguration
- Initializers
  - M init(bindHost: String, bindPort: Int, targetHost: String, targetPort: Int)
- Instance Properties
  - P let bindHost: String
  - P let bindPort: Int
  - P let targetHost: String
  - P let targetPort: Int
- Type Methods
  - M static func parseListen(String) -> PortForwardingConfiguration?
C PortForwardingServer
- Initializers
  - M init(group: EventLoopGroup, bindHost: Substring, bindPort: Int, (Channel) -> EventLoopFuture<Void>)
- Instance Methods
M func startPortForwarding(PortForwardingConfiguration) async throws -> PortForwardingServer
Forwarding Traffic
- Forwarding Types
  - S PortForwardingConfiguration
    - Initializers
      - M init(bindHost: String, bindPort: Int, targetHost: String, targetPort: Int)
    - Instance Properties
      - P let bindHost: String
      - P let bindPort: Int
      - P let targetHost: String
      - P let targetPort: Int
    - Type Methods
      - M static func parseListen(String) -> PortForwardingConfiguration?
  - C PortForwardingServer
    - Initializers
      - M init(group: EventLoopGroup, bindHost: Substring, bindPort: Int, (Channel) -> EventLoopFuture<Void>)
    - Instance Methods
  - C SSHWrapperHandler
    - Initializers
      - M init()
    - Instance Methods
      - M func channelRead(context: ChannelHandlerContext, data: NIOAny)
      - M func write(context: ChannelHandlerContext, data: NIOAny, promise: EventLoopPromise<Void>?)
    - Type Aliases
    - Default Implementations
      - ChannelHandler Implementations
        
        Instance Methods
        
        M func handlerAdded(context: ChannelHandlerContext)
        
        M func handlerRemoved(context: ChannelHandlerContext)
      - ChannelInboundHandler Implementations
        
        Instance Methods
        
        M func unwrapInboundIn(NIOAny) -> Self.InboundIn
        
        M func wrapInboundOut(Self.InboundOut) -> NIOAny
      - ChannelOutboundHandler Implementations
        
        Instance Methods
        
        M func unwrapOutboundIn(NIOAny) -> Self.OutboundIn
  - C GlueHandler
    - Instance Methods
    - Type Aliases
      - T GlueHandler.OutboundOut
    - Type Methods
      - M static func matchedPair() -> (GlueHandler, GlueHandler)
    - Default Implementations
      - ChannelHandler Implementations
        
        Instance Methods
        
        M func handlerAdded(context: ChannelHandlerContext)
        
        M func handlerRemoved(context: ChannelHandlerContext)
      - ChannelInboundHandler Implementations
        
        Instance Methods
        
        M func unwrapInboundIn(NIOAny) -> Self.InboundIn
        
        M func wrapInboundOut(Self.InboundOut) -> NIOAny
        
        Type Aliases
        
        T GlueHandler.InboundIn
      - ChannelOutboundHandler Implementations
        
        Instance Methods
        
        M func unwrapOutboundIn(NIOAny) -> Self.OutboundIn
        
        Type Aliases
        
        T GlueHandler.OutboundIn

Authentication and Internals

Authentication Flow
C SSHWrapperHandler
- Initializers
  - M init()
- Instance Methods
  - M func channelRead(context: ChannelHandlerContext, data: NIOAny)
  - M func write(context: ChannelHandlerContext, data: NIOAny, promise: EventLoopPromise<Void>?)
- Type Aliases
- Default Implementations
  - ChannelHandler Implementations
    - Instance Methods
      - M func handlerAdded(context: ChannelHandlerContext)
      - M func handlerRemoved(context: ChannelHandlerContext)
  - ChannelInboundHandler Implementations
    - Instance Methods
      - M func unwrapInboundIn(NIOAny) -> Self.InboundIn
      - M func wrapInboundOut(Self.InboundOut) -> NIOAny
  - ChannelOutboundHandler Implementations
    - Instance Methods
      - M func unwrapOutboundIn(NIOAny) -> Self.OutboundIn
C GlueHandler
- Instance Methods
- Type Aliases
  - T GlueHandler.OutboundOut
- Type Methods
  - M static func matchedPair() -> (GlueHandler, GlueHandler)
- Default Implementations
  - ChannelHandler Implementations
    - Instance Methods
      - M func handlerAdded(context: ChannelHandlerContext)
      - M func handlerRemoved(context: ChannelHandlerContext)
  - ChannelInboundHandler Implementations
    - Instance Methods
      - M func unwrapInboundIn(NIOAny) -> Self.InboundIn
      - M func wrapInboundOut(Self.InboundOut) -> NIOAny
    - Type Aliases
      - T GlueHandler.InboundIn
  - ChannelOutboundHandler Implementations
    - Instance Methods
      - M func unwrapOutboundIn(NIOAny) -> Self.OutboundIn
    - Type Aliases
      - T GlueHandler.OutboundIn

ssh-client

Command Interface

Using the Command-Line Tool

/

SSHClient / SSHClientConfiguration

Property

debug

Whether to emit debug logging during client setup and session handling.

let debug: Bool

swift-docc-static by René Hexel