/* * Copyright 2014-2016 Markus Prasser * * This file is part of Labcontrol. * * Labcontrol 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 3 of the License, or * (at your option) any later version. * * Labcontrol 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 Labcontrol. If not, see . */ #ifndef CLIENT_H #define CLIENT_H #include #include #include #include #include #include #include #include "global.h" #include "clientpinger.h" namespace lc { //! Class which represents the clients in the lab /*! This class contains elements and functions needed to represent all functions of a client. */ class Client : public QObject { Q_OBJECT public slots: //! Sets the STATE of the client to 'ZLEAF_RUNNING' void SetStateToZLEAF_RUNNING( QString argClientIP ); public: const QString ip; const QString mac; const QString name; const unsigned short int xPosition = 1; const unsigned short int yPosition = 1; /*! * \brief Client's constructor * \param argIP The IP address the represented client has * \param argMAC The MAC address the represented client has * \param argName The hostname of the represented client * \param argXPosition The client's x coordinate in the lab's grid * \param argYPosition The client's y coordinate in the lab's grid */ Client( const QString &argIP, const QString &argMAC, const QString &argName, unsigned short int argXPosition, unsigned short int argYPosition, const QString &argPingCmd ); //! Client's destructor ~Client(); //! Beams the chosen file to the client's 'media4ztree' directory /*! @param argFileToBeam The file which shall be beamed to the client's 'media4ztree' directory @param argPublickeyPathUser The path to the publickey for user login on the clients @param argUserNameOnClients The name of the user on the clients */ void BeamFile( const QString &argFileToBeam, const QString * const argPublickeyPathUser, const QString * const argUserNameOnClients ); /*! * \brief Boots the client */ void Boot(); /*! * \brief DeactiveScreensaver deactivates potentially running screensavers on the client */ void DeactiveScreensaver(); //! Returns the current state of the client /*! @return The current state of the client */ state_t GetClientState() const { return state; } int GetSessionPort() const { return sessionPort; } /*! * \brief Kills all processes 'zleaf.exe' on the client */ void KillZLeaf(); //! Opens a file manager for the client's file system /*! @param argUserToBeUsed The name of the user on the clients */ void OpenFilesystem( const QString * const argUserToBeUsed ); /*! * \brief Opens a terminal for the client * \param argCommand A command which shall be executed in the terminal window (Pass an empty QString if not wanted) * \param argOpenAsRoot Run the terminal session as root (true) or as normal user (false) */ void OpenTerminal( const QString &argCommand, const bool &argOpenAsRoot ); void SetSessionPort( int argSP ) { sessionPort = argSP; } void SetzLeafVersion( const QString &argzLeafV ) { zLeafVersion = argzLeafV; } //! Shows the desktop of the given client void ShowDesktopViewOnly(); void ShowDesktopFullControl(); /*! * \brief Shuts down the client */ void Shutdown(); //! Starts a zLeaf instance on the client /*! @param argFakeName The name the zLeaf instance shall have (if not the default, which is the hostname of the client) */ void StartZLeaf(const QString *argFakeName = nullptr ); /*! * \brief Opens a browser window on the client * @param argURL URL to open in clients browser */ void StartClientBrowser( const QString *argURL = nullptr, const bool *argFullscreen = nullptr ); /*! * \brief Closes all browser instances */ void StopClientBrowser(); private: const QString &GetzLeafVersion() const { return zLeafVersion; } unsigned short int protectedCycles; ClientPinger *pinger = nullptr; QThread pingerThread; state_t state = state_t::UNINITIALIZED; QTimer *pingTimer = nullptr; //! QTimer used to trigger pings by pinger's ClientPinger instance int sessionPort = 0; QString zLeafVersion; private slots: void GotStatusChanged( state_t argState ); void RequestAPing(); signals: void PingWanted(); }; } #endif // CLIENT_H