/*
* Copyright (C) 2014, 2015 Canonical, Ltd.
*
* This program is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License version 3, as published by
* the Free Software Foundation.
*
* This program is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranties of MERCHANTABILITY,
* SATISFACTORY QUALITY, or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see .
*/
#ifndef DBUSUNITYSESSIONSERVICE_H
#define DBUSUNITYSESSIONSERVICE_H
#include
#include "unitydbusobject.h"
typedef QList QDbusList;
Q_DECLARE_METATYPE(QList)
/**
* DBusUnitySessionService provides com.canonical.Unity.Session dbus
* interface.
*
* com.canonical.Unity.Session interface provides public methods
* and signals to handle eg. Logout/Reboot/Shutdown.
*/
class DBusUnitySessionService : public UnityDBusObject
{
Q_OBJECT
Q_CLASSINFO("D-Bus Interface", "com.canonical.Unity.Session")
public:
DBusUnitySessionService();
~DBusUnitySessionService() = default;
// For use in QML. Javascript doesn't accept functions beginning with capital letters
Q_INVOKABLE void logout() { Logout(); }
Q_INVOKABLE void reboot() { Reboot(); }
Q_INVOKABLE void shutdown() { Shutdown(); }
Q_INVOKABLE void endSession() { EndSession(); }
// TODO: remove duplicate signals and split D-Bus and QML API's
// Apparently QML needs the signals in lowercase, while DBUS spec needs the uppercase version
Q_SIGNALS:
/**
* LogoutRequested signal
*
* This signal is emitted when some applications request the system to
* logout.
* @param have_inhibitors if there are any special running applications
* which inhibit the logout.
*/
Q_SCRIPTABLE void LogoutRequested(bool have_inhibitors);
void logoutRequested(bool have_inhibitors);
/**
* RebootRequested signal
*
* This signal is emitted when some applications request the system to
* reboot.
* @param have_inhibitors if there are any special running applications
* which inhibit the reboot.
*/
Q_SCRIPTABLE void RebootRequested(bool have_inhibitors);
void rebootRequested(bool have_inhibitors);
/**
* ShutdownRequested signal
*
* This signal is emitted when some applications request the system to
* shutdown.
* @param have_inhibitors if there are any special running applications
* which inhibit the shutdown.
*/
Q_SCRIPTABLE void ShutdownRequested(bool have_inhibitors);
void shutdownRequested(bool have_inhibitors);
/**
* LogoutReady signal
*
* This signal is emitted when all the apps are closed. And the system
* is safe to logout.
*/
Q_SCRIPTABLE void LogoutReady();
void logoutReady();
/**
* Emitted as a result of calling PromptLock()
*/
Q_SCRIPTABLE void LockRequested();
void lockRequested();
/**
* Emitted after the session has been locked.
*/
Q_SCRIPTABLE void Locked();
/**
* Emitted after the session has been unlocked.
*/
Q_SCRIPTABLE void Unlocked();
void unlocked();
public Q_SLOTS:
/**
* Logout the system.
*
* This method directly logs out the system without user's confirmation.
* Ordinary applications should avoid calling this method. Please call
* RequestLogout() to ask the user to decide logout or not.
*/
Q_SCRIPTABLE void Logout();
/**
* Reboot the system.
*
* This method directly reboots the system without user's confirmation.
* Ordinary applications should avoid calling this method. Please call
* RequestReboot() to ask the user to decide reboot or not.
*/
Q_SCRIPTABLE void Reboot();
/**
* Shutdown the system.
*
* This method directly shuts down the system without user's confirmation.
* Ordinary applications should avoid calling this method. Please call
* RequestShutdown() to ask the user to decide shutdown or not.
*/
Q_SCRIPTABLE void Shutdown();
/**
* Suspend the system
*
* This method puts the system into sleep without user's confirmation.
*/
Q_SCRIPTABLE void Suspend();
/**
* Hibernate the system
*
* This method puts the system into hibernation without user's confirmation.
*/
Q_SCRIPTABLE void Hibernate();
/**
* Hybrid sleep
*
* This method puts the system into hybrid sleep without user's confirmation.
*
* @since unity8
*/
Q_SCRIPTABLE void HybridSleep();
/**
* Issue a logout request.
*
* This method emits the LogoutRequested signal to the shell with a boolean
* which indicates if there's any inhibitors. The shell should receive
* this signal and display a dialog to ask the user to confirm the logout
* action. If confirmed, shell can call Logout() method to logout.
*/
Q_SCRIPTABLE void RequestLogout();
/**
* Issue a reboot request.
*
* This method emits the RebootRequested signal to the shell with a boolean
* which indicates if there's any inhibitors. The shell should receive
* this signal and display a dialog to ask the user to confirm the reboot
* action. If confirmed, shell can call Reboot() method to reboot.
*/
Q_SCRIPTABLE void RequestReboot();
/**
* Issue a shutdown request.
*
* This method emits the ShutdownRequested signal to the shell with a
* boolean which indicates if there's any inhibitors.
* The shell should receive
* this signal and display a dialog to ask the user to confirm the reboot
* action. If confirmed, shell can call Shutdown() method to shutdown.
*/
Q_SCRIPTABLE void RequestShutdown();
/**
* Issue an EndSession request.
*
* This method calls the EndSession() Upstart DBus method on the
* current DBus session bus.
*/
Q_SCRIPTABLE void EndSession();
/**
* @return whether the system is capable of hibernating
*/
Q_SCRIPTABLE bool CanHibernate() const;
/**
* @return whether the system is capable of suspending
*/
Q_SCRIPTABLE bool CanSuspend() const;
/**
* @return whether the system is capable of hybrid sleep
* @since unity8
*/
Q_SCRIPTABLE bool CanHybridSleep() const;
/**
* @return whether the system is capable of rebooting
* @since unity8
*/
Q_SCRIPTABLE bool CanReboot() const;
/**
* @return whether the system is capable of shutting down
*/
Q_SCRIPTABLE bool CanShutdown() const;
/**
* @return whether the system is capable of locking the session
*/
Q_SCRIPTABLE bool CanLock() const;
/**
* @return the login name of the current user
*/
Q_SCRIPTABLE QString UserName() const;
/**
* @return the real name of the current user
*/
Q_SCRIPTABLE QString RealName() const;
/**
* @return the local hostname
*/
Q_SCRIPTABLE QString HostName() const;
/**
* Request that the session get locked, emits signal LockRequested()
*/
Q_SCRIPTABLE void PromptLock();
/**
* Locks the session immediately
*/
Q_SCRIPTABLE void Lock();
/**
* @return whether the session is currently locked
*/
Q_SCRIPTABLE bool IsLocked() const;
private Q_SLOTS:
void doUnlock();
private:
void switchToGreeter();
};
class DBusGnomeSessionManagerWrapper : public UnityDBusObject
{
Q_OBJECT
Q_CLASSINFO("D-Bus Interface", "org.gnome.SessionManager.EndSessionDialog")
public:
DBusGnomeSessionManagerWrapper();
~DBusGnomeSessionManagerWrapper() = default;
public Q_SLOTS:
Q_SCRIPTABLE void Open(const unsigned int type, const unsigned int arg_1, const unsigned int max_wait, const QList &inhibitors);
private:
void performAsyncCall(const QString &method);
};
class DBusGnomeScreensaverWrapper: public UnityDBusObject
{
Q_OBJECT
Q_CLASSINFO("D-Bus Interface", "org.gnome.ScreenSaver")
public:
DBusGnomeScreensaverWrapper();
~DBusGnomeScreensaverWrapper() = default;
public Q_SLOTS:
/**
* @return whether the session is currently locked (screensaver is on)
*/
Q_SCRIPTABLE bool GetActive() const;
/**
* Locks the session immediately if @p lock is true
*/
Q_SCRIPTABLE void SetActive(bool lock);
/**
* Locks the session immediately
*/
Q_SCRIPTABLE void Lock();
/**
* @return the number of seconds elapsed since the screensaver had been active
*/
Q_SCRIPTABLE quint32 GetActiveTime() const;
Q_SCRIPTABLE void SimulateUserActivity();
Q_SIGNALS:
void ActiveChanged(bool active);
};
class DBusScreensaverWrapper: public UnityDBusObject
{
Q_OBJECT
Q_CLASSINFO("D-Bus Interface", "org.freedesktop.ScreenSaver")
public:
DBusScreensaverWrapper();
~DBusScreensaverWrapper() = default;
public Q_SLOTS:
/**
* @return whether the session is currently locked (screensaver is on)
*/
Q_SCRIPTABLE bool GetActive() const;
/**
* Locks the session immediately if @p lock is true
*/
Q_SCRIPTABLE bool SetActive(bool lock);
/**
* Locks the session immediately
*/
Q_SCRIPTABLE void Lock();
/**
* @return the number of seconds elapsed since the screensaver had been active
*/
Q_SCRIPTABLE quint32 GetActiveTime() const;
/**
* @return the number of seconds that this session has been idle
*/
Q_SCRIPTABLE quint32 GetSessionIdleTime() const;
Q_SCRIPTABLE void SimulateUserActivity();
Q_SIGNALS:
void ActiveChanged(bool active);
};
#endif // DBUSUNITYSESSIONSERVICE_H