Signals

ClientAdded      ('o' id)
ClientRemoved    ('o' id)
InhibitorAdded   ('o' id)
InhibitorRemoved ('o' id)
SessionRunning   ()
SessionOver      ()

Implemented Interfaces

Objects implementing org.gnome.SessionManager also implements org.freedesktop.DBus.Introspectable, org.freedesktop.DBus.Properties

Description

Details

Setenv (in  's' variable,
        in  's' value)

Adds the variable name to the application launch environment with the specified value. May only be used during the Session Manager initialization phase.

InitializationError (in  's' message,
                     in  'b' fatal)

May be used by applications launched during the Session Manager initialization phase to indicate there was a problem.

RegisterClient (in  's' app_id,
                in  's' client_startup_id,
                out 'o' client_id)

Register the caller as a Session Management client.

UnregisterClient (in  'o' client_id)

Unregister the specified client from Session Management.

Inhibit (in  's' app_id,
         in  'u' toplevel_xid,
         in  's' reason,
         in  'u' flags,
         out 'u' inhibit_cookie)

Applications should invoke this method when they begin an operation that should not be interrupted, such as creating a CD or DVD. The types of actions that may be blocked are specified by the flags parameter. When the application completes the operation it should call Uninhibit() or disconnect from the system bus.

Applications should not expect that they will always be able to block the action. In most cases, users will be given the option to force the action to take place.

Reasons should be short and to the point.

The flags parameter must include at least one of the following:

Values for flags may be bitwise or'ed together.

The returned cookie is used to uniquely identify this request. It should be used as an argument to Uninhibit() in order to remove the request.

Uninhibit (in  'u' inhibit_cookie)

Cancel a previous call to Inhibit() identified by the cookie.

IsInhibited (in  'u' flags,
             out 'b' is_inhibited)

Determine if operation(s) specified by the flags are currently inhibited. Flags are same as those accepted by the Inhibit() method.

GetClients (out 'ao' clients)

This gets a list of all the Clients that are currently known to the session manager.

Each Client ID is an D-Bus object path for the object that implements the Client interface.

See also: org.gnome.SessionManager.Client

GetInhibitors (out 'ao' inhibitors)

This gets a list of all the Inhibitors that are currently known to the session manager.

Each Inhibitor ID is an D-Bus object path for the object that implements the Inhibitor interface.

See also: org.gnome.SessionManager.Inhibitor

IsAutostartConditionHandled (in  's' condition,
                             out 'b' handled)

Allows the caller to determine whether the session manager is handling changes to the specified autostart condition.

Shutdown ()

Request a shutdown dialog

CanShutdown (out 'b' is_available)

Allows the caller to determine whether or not it's okay to show a shutdown option in the UI

Logout (in  'u' mode)

Request a logout dialog

Allowed values for the mode parameter are:

Values for flags may be bitwise or'ed together.

Signal Details

ClientAdded ('o' id)

Emitted when a client has been added to the session manager.

ClientRemoved ('o' id)

Emitted when a client has been removed from the session manager.

InhibitorAdded ('o' id)

Emitted when an inhibitor has been added to the session manager.

InhibitorRemoved ('o' id)

Emitted when an inhibitor has been removed from the session manager.

SessionRunning ()

Indicates the session has entered the Running phase.

SessionOver ()

Indicates the session is about to end.

Implemented Interfaces

Objects implementing org.gnome.SessionManager.Client also implements org.freedesktop.DBus.Introspectable, org.freedesktop.DBus.Properties

Description

Details

GetAppId (out 's' app_id)

Return the application ID associated with this client.

GetStartupId (out 's' startup_id)

Return the startup ID associated with this client.

GetRestartStyleHint (out 'u' hint)

Return the restart style hint for this client.

GetUnixProcessId (out 'u' pid)

Return the Unix process identifier for this client.

GetStatus (out 'u' status)

Return the status of this client.

Signals

Stop             ()
QueryEndSession  ('u' flags)
EndSession       ('u' flags)
CancelEndSession ()

Implemented Interfaces

Objects implementing org.gnome.SessionManager.ClientPrivate also implements org.freedesktop.DBus.Introspectable, org.freedesktop.DBus.Properties

Description

Details

EndSessionResponse (in  'b' is_ok,
                    in  's' reason)

This method should be used by the client in response to the QueryEndSession and EndSession signals.

Signal Details

Stop ()

QueryEndSession ('u' flags)

This signal is used to inform the client that the session is about to end. The client must respond by calling EndSessionResponse within one second of the signal emission.

The flags may include:

If the client responds with an EndSessionResponse is-ok argument equal to FALSE and a reason then this reason may be displayed to the user.

The client must not attempt to perform any actions or interact with the user in response to this signal. Any actions required for a clean shutdown should take place in response to the EndSession signal.

The client should limit operations until either a EndSession CancelEndSession signal is received.

EndSession ('u' flags)

This signal is used to inform the client that the session is about to end. The client must respond by calling EndSessionResponse within ten seconds of the signal emission.

The client must not attempt to interact with the user in response to this signal. The application will be given a maxium of ten seconds to perform any actions required for a clean shutdown.

CancelEndSession ()

Implemented Interfaces

Objects implementing org.gnome.SessionManager.Inhibitor also implements org.freedesktop.DBus.Introspectable, org.freedesktop.DBus.Properties

Description

Details

GetAppId (out 's' app_id)

Return the application ID associated with this inhibit.

GetClientId (out 'o' client_id)

Return the client object path associated with this inhibit.

GetReason (out 's' reason)

Return the reason for the inhibit

GetFlags (out 'u' flags)

Return the flags that determine the scope of the inhibit

GetToplevelXid (out 'u' xid)

Return the X11 toplevel window identifier associated with this inhibit. Zero if not set.