Disk ARchive 2.8.0
Full featured and portable backup and archiving tool
Loading...
Searching...
No Matches
libdar::entrepot_libssh Class Reference

#include <entrepot_libssh.hpp>

Inherits libdar::entrepot, and libdar::mem_ui.

Public Member Functions

 entrepot_libssh (const std::shared_ptr< user_interaction > &dialog, const std::string &login, const secu_string &password, const std::string &host, const std::string &port, bool auth_from_file, const std::string &sftp_pub_keyfile, const std::string &sftp_prv_keyfile, const std::string &sftp_known_hosts, U_I waiting_time, bool verbose=false)
 constructor
 
 entrepot_libssh (const entrepot_libssh &ref)
 
 entrepot_libssh (entrepot_libssh &&ref) noexcept=delete
 
entrepot_libsshoperator= (const entrepot_libssh &ref)=delete
 
entrepot_libsshoperator= (entrepot_libssh &&ref) noexcept=delete
 
virtual std::string get_url () const override
 full path of current directory + anything necessary to provide URL formated information
 
virtual void read_dir_reset () const override
 routines to read existing files in the current directory (see set_location() / set_root() methods)
 
virtual bool read_dir_next (std::string &filename) const override
 read the next filename of the current directory
 
virtual void read_dir_reset_dirinfo () const override
 routines to read existing files with dir information
 
virtual bool read_dir_next_dirinfo (std::string &filename, inode_type &tp) const override
 alternative to the method read_dir_next, should be implemented also
 
virtual void create_dir (const std::string &dirname, U_I permission) override
 create a new directory in the current directory
 
virtual entrepotclone () const override
 done this way for homogeneity with open/inherited_open
 
- Public Member Functions inherited from libdar::entrepot
 entrepot ()
 constructor
 
 entrepot (const entrepot &ref)=default
 copy constructor
 
 entrepot (entrepot &&ref) noexcept=default
 move constructor
 
entrepotoperator= (const entrepot &ref)=default
 assignment operator
 
entrepotoperator= (entrepot &&ref) noexcept=default
 move operator
 
virtual ~entrepot ()=default
 destructor
 
bool operator== (const entrepot &ref) const
 says whether two entrepot objects points to the same location
 
virtual void set_location (const path &chemin)
 defines the directory where to proceed to future open() – this is a "chdir" semantics
 
virtual void set_root (const path &p_root)
 defines the root to use if set_location is given a relative path
 
virtual path get_full_path () const
 returns the full path of location
 
void set_user_ownership (const std::string &x_user)
 set default ownership for files to be created thanks to the open() or create_dir() methods
 
void set_group_ownership (const std::string &x_group)
 
virtual const pathget_location () const
 
virtual const pathget_root () const
 retreives relative to root path the current location points to
 
const std::string & get_user_ownership () const
 retrieves the given root location
 
const std::string & get_group_ownership () const
 
fichier_globalopen (const std::shared_ptr< user_interaction > &dialog, const std::string &filename, gf_mode mode, bool force_permission, U_I permission, bool fail_if_exists, bool erase, hash_algo algo, bool provide_a_plain_file=true) const
 defines the way to open a file and return a "class fichier_global" object as last argument upon success
 
virtual void change_user_interaction (const std::shared_ptr< user_interaction > &new_dialog)
 change user_interaction if the implementation recorded it (at construction time for example)
 
virtual std::shared_ptr< user_interactionget_current_user_interaction () const
 get the current user_interaction if the implementation reocrded it at construction time (may be nullptr if not)
 
void unlink (const std::string &filename) const
 remove the target file from the entrepot
 
- Public Member Functions inherited from libdar::mem_ui
 mem_ui (const std::shared_ptr< user_interaction > &dialog)
 constructor
 
 mem_ui (const mem_ui &ref)=default
 the copy constructor
 
 mem_ui (mem_ui &&ref) noexcept=default
 the move constructor
 
mem_uioperator= (const mem_ui &ref)=default
 assignement operator
 
mem_uioperator= (mem_ui &&ref) noexcept=default
 move operator
 
virtual ~mem_ui () noexcept(false)
 destructor
 

Protected Member Functions

virtual fichier_globalinherited_open (const std::shared_ptr< user_interaction > &dialog, const std::string &filename, gf_mode mode, bool force_permission, U_I permission, bool fail_if_exists, bool erase) const override
 
virtual void inherited_unlink (const std::string &filename) const override
 
virtual void read_dir_flush () const override
 ends the read_dir_next, (no more entry available)
 
- Protected Member Functions inherited from libdar::entrepot
- Protected Member Functions inherited from libdar::mem_ui
user_interactionget_ui () const
 get access to the user_interaction object
 
std::shared_ptr< user_interactionget_pointer () const
 get access to the shared_ptr pointing to the user_interaction
 
void change_ui (const std::shared_ptr< user_interaction > &new_dialog)
 change the user_interaction object
 

Detailed Description

implementation for SFTP entrepot unsing libssh backend

entrepot_libssh generates objects of class "fichier_libssh" inherited class of fichier_global

Definition at line 57 of file entrepot_libssh.hpp.

Constructor & Destructor Documentation

◆ entrepot_libssh()

libdar::entrepot_libssh::entrepot_libssh ( const std::shared_ptr< user_interaction > & dialog,
const std::string & login,
const secu_string & password,
const std::string & host,
const std::string & port,
bool auth_from_file,
const std::string & sftp_pub_keyfile,
const std::string & sftp_prv_keyfile,
const std::string & sftp_known_hosts,
U_I waiting_time,
bool verbose = false )

constructor

Parameters
dialogfor user interaction
loginuser login on remote host
passworduser password on remote host (empty for file auth or user interaction)
hostthe remote server to connect to
portTCP/UDP port to connec to (empty string for default)
auth_from_fileif true, use private/public key authentication and password is then the key pass, else use password authentication
sftp_pub_keyfilewhere to fetch the public key (sftp only)
sftp_prv_keyfilewhere to fetch the private key (sftp only)
sftp_known_hostslocation of the known_hosts file (empty string to disable this security check)
waiting_timetime in second to wait before retrying in case of network error
verbosewhether to have verbose messages from libcurl

Referenced by clone().

◆ ~entrepot_libssh()

libdar::entrepot_libssh::~entrepot_libssh ( )
inlinenoexcept

Definition at line 80 of file entrepot_libssh.hpp.

Member Function Documentation

◆ clone()

virtual entrepot * libdar::entrepot_libssh::clone ( ) const
inlineoverridevirtual

done this way for homogeneity with open/inherited_open

generate a clone of "this"

Deprecated
this method will disapear in the future it is only kept there to allow the APIv5 adaptation layer to work over APIv6

Implements libdar::entrepot.

Definition at line 91 of file entrepot_libssh.hpp.

References entrepot_libssh().

◆ create_dir()

virtual void libdar::entrepot_libssh::create_dir ( const std::string & dirname,
U_I permission )
overridevirtual

create a new directory in the current directory

Parameters
[in]dirnameis the name of the subdirectory to create (not its path!) It is created in as sub-directory of the directory given to set_location()
[in]permissionis the usual POSIX user/group/other permission bits to set to the directory to create
Note
the operation fails if an entry of that name already exists
the implementation should set the user and group ownership according to the argument provided to set_user_ownership() and set_group_ownership(), if this feature is supported in the underlying implementation

Implements libdar::entrepot.

◆ get_url()

virtual std::string libdar::entrepot_libssh::get_url ( ) const
overridevirtual

full path of current directory + anything necessary to provide URL formated information

Implements libdar::entrepot.

◆ inherited_open()

virtual fichier_global * libdar::entrepot_libssh::inherited_open ( const std::shared_ptr< user_interaction > & dialog,
const std::string & filename,
gf_mode mode,
bool force_permission,
U_I permission,
bool fail_if_exists,
bool erase ) const
overrideprotectedvirtual

Implements libdar::entrepot.

◆ inherited_unlink()

virtual void libdar::entrepot_libssh::inherited_unlink ( const std::string & filename) const
overrideprotectedvirtual

Implements libdar::entrepot.

◆ read_dir_flush()

virtual void libdar::entrepot_libssh::read_dir_flush ( ) const
overrideprotectedvirtual

ends the read_dir_next, (no more entry available)

Implements libdar::entrepot.

◆ read_dir_next()

virtual bool libdar::entrepot_libssh::read_dir_next ( std::string & filename) const
overridevirtual

read the next filename of the current directory

Parameters
[out]filenamename of the next entry in the directory, (valid only if this method returned true)
Returns
false if no more filename could be fould
Note
either use read_dir_reset() followed by read_dir_next() calls, or call read_dir_reset_dirinfo() followed by read_dir_next_dirinfo() calls

Implements libdar::entrepot.

◆ read_dir_next_dirinfo()

virtual bool libdar::entrepot_libssh::read_dir_next_dirinfo ( std::string & filename,
inode_type & tp ) const
overridevirtual

alternative to the method read_dir_next, should be implemented also

Parameters
[out]filenamename of the next entry in the directory, (valid only if this method returned true)
[out]tpgives the nature of the entry
Note
a call to read_dir_reset_dirinfo() should be done before the first call to this method
either use read_dir_reset() followed by read_dir_next() calls, or call read_dir_reset_dirinfo() followed by read_dir_next_dirinfo() calls

Implements libdar::entrepot.

◆ read_dir_reset()

virtual void libdar::entrepot_libssh::read_dir_reset ( ) const
overridevirtual

routines to read existing files in the current directory (see set_location() / set_root() methods)

Parameters
[in]dir_details,ifset to true, use read_dir_next() with the isdir argument, else use the read_dir_next() with a single argument. By default and for backward compatibility dir_details is set to false.

Implements libdar::entrepot.

◆ read_dir_reset_dirinfo()

virtual void libdar::entrepot_libssh::read_dir_reset_dirinfo ( ) const
overridevirtual

routines to read existing files with dir information

to be used before calling read_dir_next_dirinfo().

Note
after calling read_dir_reset_dirinfo() calling read_dir_next() gives undefined result, you first need to call read_dir_reset() or continue using read_dir_next_dirinfo()

Implements libdar::entrepot.


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