Qore ssh2 Module  ..
Ssh2Connections::SftpConnection Class Reference

class for SFTP connections; returns an object of class Qore::SSH2::SFTPClient for acquiring files from or posting files to SFTP servers More...

Inheritance diagram for Ssh2Connections::SftpConnection:
Ssh2Connections::AbstractSsh2Connection

Public Member Methods

 constructor (string name, string description, string url, hash< auto > attributes={}, hash< auto > options={})
 creates the SftpConnection object More...
 
string getType ()
 returns "sftp"
 
*hash< auto > getRuntimeOptions ()
 returns runtime options More...
 
- Public Member Methods inherited from Ssh2Connections::AbstractSsh2Connection
 constructor (string name, string description, string url, hash< auto > attributes={}, hash< auto > options={})
 creates the AbstractSsh2Connection object More...
 

Public Attributes

const ConnectionScheme = ...
 Connection entry info.
 

Private Member Methods

Qore::SSH2::SFTPClient getImpl (bool connect=True, *hash< auto > rtopts)
 returns a Qore::SSH2::SFTPClient object More...
 
hash< ConnectionSchemeInfo > getConnectionSchemeInfoImpl ()
 Returns the ConnectionSchemeInfo hash for this object.
 

Detailed Description

class for SFTP connections; returns an object of class Qore::SSH2::SFTPClient for acquiring files from or posting files to SFTP servers

supports the following option:

  • "keyfile": a path to a private key file in PEM format to use for key-based authentication (environment variables can be prefixed with "$" in the path (or optionally enclosed in curly brackets as in "${var}") and will be substituted with the value of the environment variable)

additionally, the following runtime options are supported in getImpl():

  • "path": overrides the path component in the URL at runtime
  • "path_add": appends the given string to the path component of the URL at runtime

Member Function Documentation

◆ constructor()

Ssh2Connections::SftpConnection::constructor ( string  name,
string  description,
string  url,
hash< auto >  attributes = {},
hash< auto >  options = {} 
)

creates the SftpConnection object

Parameters
namethe name of the connection
descriptionconnection description
urlconnection URL (potentially with password info)
attributesvarious attributes. See below
optionsconnection options

See AbstractConnection::constructor() for attributes and options reference.

◆ getImpl()

Qore::SSH2::SFTPClient Ssh2Connections::SftpConnection::getImpl ( bool  connect = True,
*hash< auto >  rtopts 
)
private

returns a Qore::SSH2::SFTPClient object

Parameters
connectif True, then Qore::SSH2::SFTPClient::connect() is called and also if there is any path in the URL then Qore::SSH2::SFTPClient::chdir() is called on that path
rtoptsthis object takes the following runtime options:
  • "path": overrides the path component in the URL at runtime
  • "path_add": appends the given string to the path component of the URL at runtime
Returns
a Qore::SSH2::SFTPClient object

◆ getRuntimeOptions()

*hash<auto> Ssh2Connections::SftpConnection::getRuntimeOptions ( )

returns runtime options

return a hash with the following keys reflecting support for the corresponding runtime options in getImpl():

  • "path": overrides the path component in the URL at runtime
  • "path_add": appends the given string to the path component of the URL at runtime

The documentation for this class was generated from the following file: