wiki/src/blueprint/TailsGreeter/design.mdwn

   1 [[!meta title="tails-greeter design"]]
   2
   3 [[!toc levels=2]]
   4
   5 Design decisions:
   6 =====================
   7
   8 - display manager: GDM (with potential migration in future (after GSoC) to LightDM)
   9   [reasoning: need to be compatible with current builds based on Debian Squeeze]
  10 - programming language: python
  11   [reasoning: existing implementation gdm-community-greeter]
  12 - project is based on [[https://code.launchpad.net/gdm-commmunity-greeter/]]
  13   (reasoning: use of TranslatableWindow as a basis for implementation of [[todo/localization_at_runtime]])
  14 - tails-greeter as part of DM preferred over custom DM
  15   [reasoning: smaller amount of code, easier maintenance, easier extensibility in future (after gsoc)]
  16 - repository layout: 'upstream' branch contains periodic snapshots of gdm-community-greeter, 'master' branch contains actual project code.
  17   (reasoning: initially tails-greeter will stay rather close to
  18   gdm-community-greeter, later it diverged significantly)
  19 - software running in the Tails user GNOME session can know if
  20   persistence was enabled by checking if
  21   `TAILS_PERSISTENCE_ENABLED=true` is set in `/var/lib/live/config/tails.persistence`
  22
  23 ## Localization notes:
  24
  25 ### Design:
  26
  27 - since locale generation and setup might be time consuming it's performed in the background by /etc/gdm3/PostLogin/Default script (set-user-password-and-locale in TailsGreeter)
  28 - window translation is handled on the fly (via TranslatableWindow) independently from locale generation
  29 - language and layout are applied immediately as they selected
  30
  31 ### Design clarification:
  32
  33 When talking about language support in greeter it is important to distinguish between:
  34
  35 0. language support in Tails: the locales available to use once user successfully logged-in
  36 0. language support in tails-greeter: translations which can be utilized by greeter itself before user logged in
  37
  38 The available locales dynamically populated into list. Once language is chosen corresponding translation is applied to the widget (if available) but actual locale generation is handled by external script which is activated by GDM on logon.
  39
  40 N. B. TailsGreeter is executed under Debian-gdm user while locale generation requires root access which is available for PostLogin script. This makes very inconvenient usage of env. variables for parameter transfer. That's why parameters to PostLogin script are supplied via temporary files in /var/lib/gdm3/tails.*
  41
  42 ##  Additional notes:
  43
  44 ### Quick login:
  45
  46 Since greeter is shown with every login, there got to be a way to skip all the greeter screens and quickly login with the default settings with 1-click button if there are more than one screen used by TailsGreeter.
  47
  48 ### choice of programming language justification:
  49
  50 Python is selected as main language for the project because it's already used by gdm-community-greeter. This makes code re-use easier.
  51
  52 ### GDM notes
  53
  54 - GDM read autostart folder in unpredictable manner so dpkg-divert is required to properly disable existing greeter unless it's in separate .deb which could be removed
  55
  56 - GDM's dbus interface is "private":
  57 which in this case means "unstable" there are only two consumer's for GDM's greeter API (GDM's own greeter, gdm-community-greeter and TailsGreeter).
  58
  59 ### packages
  60
  61 #### diversion
  62
  63 post- and pre- install scripts are invoked on every upgrade to "be on a safe side": we apply diversion to GDM file which will effectively break logon procedure in the absence of tails-greeter. Hence - dumb but failsafe approach which makes lintian unhappy (override used to hide lintian error).
  64
  65 #### requirements
  66
  67 - build and install with Debian Squeeze (as long as current Tails is based on it)
  68 - build and install with Debian Sid (2nd priority - just to make portability and maintenance easier)
  69
  70 #### Future
  71 In the near future, we should implement [[todo/tails-greeter:_revamp_UI/]] in some way.
  72 We should also be thinking about [[todo/tails-greeter_vs._Wheezy/]].