General configuration

General configuration — tlm general configuration keys

Types and Values

Object Hierarchy


Description

General configuration keys are defined below. See TlmConfig for how to use them.

Functions

Types and Values

TLM_CONFIG_GENERAL

#define TLM_CONFIG_GENERAL                  "General"

A prefix for general keys. Should be used only when defining new keys.


TLM_CONFIG_GENERAL_ACCOUNTS_PLUGIN

#define TLM_CONFIG_GENERAL_ACCOUNTS_PLUGIN  "ACCOUNTS_PLUGIN"

Accounts plugin (implementation of TlmAccountPlugin) to use. Default value: "default". If Tlm has been configured with --enable-debug, the value can be overriden with TLM_ACCOUNT_PLUGIN environment variable.


TLM_CONFIG_GENERAL_SESSION_CMD

#define TLM_CONFIG_GENERAL_SESSION_CMD      "SESSION_CMD"

Session command line: the command run after successfull login. If the value is not defined in the config file, user's shell from /etc/passwd is used, and if that is not defined, the fallback is "systemd --user"


TLM_CONFIG_GENERAL_SESSION_PATH

#define TLM_CONFIG_GENERAL_SESSION_PATH     "SESSION_PATH"

Default value for PATH environment variable in user's session. If not set, "/usr/local/bin:/usr/bin:/bin" is used.


TLM_CONFIG_GENERAL_DATA_DIRS

#define TLM_CONFIG_GENERAL_DATA_DIRS        "XDG_DATA_DIRS"

Default value for XDG_DATA_DIRS environment variable. If not set, "/usr/share:/usr/local/share" is used.


TLM_CONFIG_GENERAL_AUTO_LOGIN

#define TLM_CONFIG_GENERAL_AUTO_LOGIN       "AUTO_LOGIN"

Autologin to default user : TRUE/FALSE. TRUE if value is not set

Whether to automatically log in the default user on startup and when another user session has been terminated.


TLM_CONFIG_GENERAL_PREPARE_DEFAULT

#define TLM_CONFIG_GENERAL_PREPARE_DEFAULT  "PREPARE_DEFAULT"

Prepare default user before auto-login: TRUE/FALSE (FALSE if value not set).

If set to TRUE, methods of TlmAccountPlugin are used to set up the default user's account before auto-login.


TLM_CONFIG_GENERAL_PAM_SERVICE

#define TLM_CONFIG_GENERAL_PAM_SERVICE      "PAM_SERVICE"

PAM service file to use for authentication and session setup. Default value: "tlm-login".


TLM_CONFIG_GENERAL_DEFAULT_PAM_SERVICE

#define TLM_CONFIG_GENERAL_DEFAULT_PAM_SERVICE "DEFAULT_PAM_SERVICE"

PAM service file to use for default user authentication and session setup. Default value: "tlm-default-login".


TLM_CONFIG_GENERAL_DEFAULT_USER

#define TLM_CONFIG_GENERAL_DEFAULT_USER     "DEFAULT_USER"

Default username for autologin. Default value: "guest".

The value can include: %S - seat number, %I - seat id string.


TLM_CONFIG_GENERAL_SETUP_TERMINAL

#define TLM_CONFIG_GENERAL_SETUP_TERMINAL   "SETUP_TERMINAL"

Setup terminal while creating session : TRUE/FALSE. (TRUE if not set).

Whether to connect the standard input, output and error streams for a newly created session to the terminal device.


TLM_CONFIG_GENERAL_TERMINATE_TIMEOUT

#define TLM_CONFIG_GENERAL_TERMINATE_TIMEOUT "TERMINATE_TIMEOUT" 

Timeout for session termination in seconds. Default value: 10

Specifies timeout between sending different termination signals in case the previous signal wasn't obeyed.


TLM_CONFIG_GENERAL_X11_SESSION

#define TLM_CONFIG_GENERAL_X11_SESSION      "X11_SESSION"

Use X11 style sessions. Default value: 0

Switches session handling style to X11 sessions where display manager is terminated and Xserver restarted for each session.


TLM_CONFIG_GENERAL_PAUSE_SESSION

#define TLM_CONFIG_GENERAL_PAUSE_SESSION    "PAUSE_SESSION"

Do not actually launch anything after creating session, let systemd handle it through PAM.