您最多能選擇 25 個主題 主題必須以字母或數字為開頭,可包含連接號「-」且最長為 35 個字元。
smb4k/smb4k/core/smb4kpasswordhandler.h

307 行
9.6 KiB

/***************************************************************************
smb4kpasswordhandler - This class handles the passwords for Smb4K.
-------------------
begin : So Jan 16 2005
copyright : (C) 2005-2007 by Alexander Reinholdt
email : dustpuppy@users.berlios.de
***************************************************************************/
/***************************************************************************
* This program is free software; you can redistribute it and/or modify *
* it under the terms of the GNU General Public License as published by *
* the Free Software Foundation; either version 2 of the License, or *
* (at your option) any later version. *
* *
* This program is distributed in the hope that it will be useful, but *
* WITHOUT ANY WARRANTY; without even the implied warranty of *
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU *
* General Public License for more details. *
* *
* You should have received a copy of the GNU General Public License *
* along with this program; if not, write to the *
* Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, *
* MA 02110-1301 USA *
***************************************************************************/
#ifndef SMB4KPASSWORDHANDLER_H
#define SMB4KPASSWORDHANDLER_H
#ifdef HAVE_CONFIG_H
#include <config.h>
#endif
// TQt includes
#include <tqobject.h>
#include <tqcheckbox.h>
// KDE includes
#include <tdewallet.h>
#include <kdialogbase.h>
#include <kprocess.h>
// forward declarations
#ifndef __FreeBSD__
class Smb4KAuthInfo;
#endif
// application specific includes
#include "smb4khomesshareshandler.h"
#ifdef __FreeBSD__
#include "smb4ksambaoptionshandler.h"
#include "smb4kauthinfo.h"
#endif
/**
* This class handles the passwords used by Smb4K to authenticate to
* the network shares.
*
* @author Alexander Reinholdt <dustpuppy@users.berlios.de>
*/
class Smb4KPasswordHandler : public TQObject
{
Q_OBJECT
public:
#ifndef __FreeBSD__
/**
* The constructor.
*
* @param config The TDEConfig object that should be used
*
* @param handler The Smb4KHomesSharesHandler object that is needed to retrieve
* infos in case we need to look up authentication information for
* 'homes' shares.
*
* @param parent The parent object.
*
* @param name The name this class should carry.
*/
Smb4KPasswordHandler( Smb4KHomesSharesHandler *handler,
TQObject *parent = 0,
const char *name = 0 );
#else
/**
* The constructor (FreeBSD).
*
* @param s_handler The Smb4KHomesSharesHandler object that is needed to retrieve
* infos in case we need to look up authentication information for
* 'homes' shares.
*
* @param o_handler The Smb4KSambaOptionsHandler object. It is needed to write the
* ~/.nsmbrc file correctly.
*
* @param parent The parent object.
*
* @param name The name this class should carry.
*/
Smb4KPasswordHandler( Smb4KHomesSharesHandler *s_handler,
Smb4KSambaOptionsHandler *o_handler,
TQObject *parent = 0,
const char *name = 0 );
#endif
/**
* The destructor.
*/
~Smb4KPasswordHandler();
/**
* Opens the askpass dialog.
*
* @param workgroup The workgroup where the share is located in (may be empty).
*
* @param host The host the share belongs to.
*
* @param name The name of the share.
*
* @param desc Determines which descriptive label the askpass dialog should carry.
* Values are taken from the Smb4KPasswordHandler::AskPass::Description
* enumeration.
*
* @param parent The parent of this dialog.
*
* @param name The name of this dialog.
*
* @returns TRUE if a new password has been supplied and FALSE otherwise.
*/
bool askpass( const TQString &workgroup, const TQString &host, const TQString &share, int desc, TQWidget *parent = 0, const char *name = 0 );
/**
* Returns the authentication data that was found for the defined share. You need to
* provide the workgroup, host name, and share name with @p authInfo.
*
* @param authInfo The authentication information object.
*
* @returns a pointer to @p authInfo. This may be NULL if @p authInfo was
* also NULL.
*/
Smb4KAuthInfo *readAuth( Smb4KAuthInfo *authInfo );
/**
* Write the provided authentication data to the wallet.
*
* @param authInfo The Smb4KAuthInfo object that holds the authentication information.
*/
void writeAuth( Smb4KAuthInfo *authInfo );
/**
* Read the default authentication from the wallet.
*
* @param authInfo The authentication information object.
*
* @returns pointer to the authentication data object if a wallet is used or NULL otherwise
*/
Smb4KAuthInfo *readDefaultAuth( Smb4KAuthInfo *authInfo );
/**
* Writes the default authentication data to the wallet. This function seems only to
* be useful for the configuration dialog.
*
* @param authInfo The authentication data for the default login if a wallet is
* used or NULL otherwise.
*/
void writeDefaultAuth( Smb4KAuthInfo *authInfo );
/**
* This enumeration destermines which destriptive label the askpass
* dialog should carry.
*/
enum Description{ NewData, AccessDenied, BadPassword, PermDenied, AuthError, LogonFailure, None };
/**
* This function returns TRUE if the wallet it open at the moment and FALSE
* if it is closed or not used.
*
* @returns TRUE if the wallet is open.
*/
bool walletIsOpen() { return (m_wallet && m_wallet->isOpen()); }
/**
* This function returns TRUE if the digital wallet support has been
* disabled. This happens when the wallet could not be opened.
*
* @returns TRUE if the digital wallet support has been disabled.
*/
bool walletSupportIsDisabled() { return m_wallet_support_disabled; }
protected slots:
/**
* Get the password for a specific share and user name.
*/
void slotGetPassword( const TQString &username );
/**
* This slot is used to enable the OK button of the askpass
* dialog when text has been entered in the text boxes and/or the
* combo box.
*
* @param text The text that has been entered.
*/
void slotEnableOKButton( const TQString &text );
/**
* FreeBSD specific: This slot receives output from the process that encrypts
* the passwords.
*
* @param proc The process that sends the output
*
* @param buffer The buffer that contains the output
*
* @param buflen The length of the buffer
*/
void slotReceivePassword( TDEProcess *proc, char *buffer, int buflen );
/**
* FreeBSD specific: This slot is invoked if the process exited.
*
* @param proc The process that exited
*/
void slotWritePassword( TDEProcess *proc );
private:
/**
* This function opens the wallet in which the passwords should be
* stored.
*/
void open_close_wallet();
/**
* This function is used to convert old wallet entries to the new
* map based ones.
*/
void convert_old_entries();
/**
* The TDEWallet object.
*/
TDEWallet::Wallet *m_wallet;
/**
* The Smb4KAuthInfo object. For use with the askpass dialog.
*/
Smb4KAuthInfo *m_auth;
/**
* The askpass dialog.
*/
KDialogBase *m_dlg;
/**
* This list holds the authentication data the user supplied if he/she
* does not want to use TDEWallet.
*/
TQValueList<Smb4KAuthInfo *> m_auth_list;
/**
* If the user neither wants to store the passwords in a wallet nor in a
* temporary list, the authentication data received from the askpass dialog
* will the stored in this object.
*/
Smb4KAuthInfo *m_temp_auth;
/**
* The Smb4KHomesSharesHandler object
*/
Smb4KHomesSharesHandler *m_handler;
/**
* Is the wallet support disabled?
*/
bool m_wallet_support_disabled;
#ifdef __FreeBSD__
/**
* FreeBSD specific: This function writes authentication information
* to the ~/.nsmbrc file, which is used by mount_smbfs.
*
* @param authInfo The authentication information that should be written
* to ~/.nsmbrc file.
*/
void writeToSMBConfFile( Smb4KAuthInfo *authInfo );
/**
* FreeBSD specific: Holds the authentication information that should
* be written to ~/.nsmbrc.
*/
Smb4KAuthInfo m_nsmbrc_auth;
/**
* The buffer for the process that encrypts the password.
*/
TQString m_buffer;
/**
* The Smb4KSambaOptionsHandler object.
*/
Smb4KSambaOptionsHandler *m_options_handler;
#endif
};
#endif