Tiny Login Manager Reference Manual: org.O1.Tlm.Login

org.O1.Tlm.Login

org.O1.Tlm.Login — a D-Bus interface to TLM

Methods

loginUser  (IN  s     seat_id,
            IN  s     username,
            IN  s     password,
            IN  a{ss} environ);
logoutUser (IN  s     seat_id);
switchUser (IN  s     seat_id,
            IN  s     username,
            IN  s     password,
            IN  a{ss} environ);

Description

Login objects can be used to login, logout and switch users. Login object with root access is exported at TLM_DBUS_ROOT_SOCKET_ADDRESS which can be used to login, logout and switch any user. TLM_DBUS_ROOT_SOCKET_ADDRESS can be fetched as a variable from package configuration file tlm.pc. Besides whenever a user is logged in, a dbus login object is also exported which can be used for 'logout-user' and 'switch-user' functionalities by that user. The dbus object can be accessed at TLM_DBUS_SOCKET_PATH/<seat_id-uid> by the user (uid) who is logged in at the seat (seat_id).

Method Details

The loginUser() method

loginUser (IN  s     seat_id,
           IN  s     username,
           IN  s     password,
           IN  a{ss} environ);

`IN s seat_id`:	id of the seat
`IN s username`:	name of the user
`IN s password`:	password to use for login
`IN a{ss} environ`:	key-value pairs of environment variables

The logoutUser() method

logoutUser (IN  s seat_id);

Logout the user.

IN s seat_id:

id of the seat

The switchUser() method

switchUser (IN  s     seat_id,
            IN  s     username,
            IN  s     password,
            IN  a{ss} environ);

Logout the currently logged in user (if any), and login new user. loginUser() will fail if the user is already logged in, while switchUser() will not.

`IN s seat_id`:	id of the seat
`IN s username`:	name of the user
`IN s password`:	password to use for login
`IN a{ss} environ`:	key-value pairs of environment variables