NAME

Store::SMB - Class to define a SMB store that perform ftp-like operations between a local- and remote location.

SYNOPSIS

Used in the same way as the Store-class. See the Store-class for more information.

DESCRIPTION

Class to perform ftp-like operations on a SMB/CIFS-share between a local- and remote location.

The class is a wrapper around the smbclient-utility.

It is used in the same way as the Store-class. See the Store-class for more information.

CONSTRUCTOR

new()

Constructor is inherited from the Store-class. See the Store-class for more information.

It returns the instantiated class.

METHODS

open_define()

Defines the parameters used on the SMB-store. This methods is inherited from the Store-class. See the Store-class for more information.

open_create()

Creates the necessary StoreProcess-instances used by the SMB-store.

It basically creates StoreProcess::Shell-instances for both GET-, PUT- and DEL-operations and inputs the necessary Parameter::Group-class parameters.

This method has overridden a Store-class method. See the Store-class for more information.

remoteSize()

Calculates the size of the remote area designated by the parameter "remote".

It uses the smbclient-command "ls" recursively to list the folder and sub-folders and then add the size of the elements found.

Returns the size in Bytes. See the Store-class for more information on this method.

listRemote()

Lists a designated folder on the remote Store.

Input parameter is "path". If none given it lists the root of the remote area. Because the smbclient-utility command does not accept escaped meta-characters, it is not allowed to have doubleslash, slash, cr or nl in the path-name. This is a limitation due to security to avoid potential injection.

Uses the smbclient-command "ls" to list the folder in question.

Returns a HASH-reference structure upon success. Please the Store-class for more information on this method.