David Herrmann 11eaec0e68 Introduce session management
On seats other than seat0 we do not have any session-management, because
VTs are not available. Furthermore, if we want to get rid of CONFIG_VT
entirely, we also need to provide session-management for seat0.

This commit introduces sessions. Every seat (seats are now managed in
kmscon_seat.c) can have registered sessions. One of the sessions is active
and gets control over all displays. Session switching is entirely handled
inside of kmscon so there is always an active session (except if no
session is registered at all).

This also reworks the seat-management. kmscon_main.c now only manages the
seat allocation/deallocation and video-objects. The seat itself is handled
inside of kmscon_seat.c and does not know of uterm_video objects. Instead,
it is assigned a list of displays that it can use. Everything is still
hotplugging capable so user-experience should be the same as before.

The kmscon_terminal layer is reworked to be session based. So every
terminal is now a single session. By default, a single terminal-session is
created for each seat. This may be changed, though.

There is currently no input-control to change between session with
keyboard hotkeys. However, this will be added when we have more than one
session.

Signed-off-by: David Herrmann <dh.herrmann@googlemail.com>
2012-10-11 10:54:01 +02:00
2012-09-18 20:41:55 +02:00
2012-10-01 10:10:50 +02:00
2012-10-11 10:54:01 +02:00
2012-10-09 13:56:30 +02:00
2012-09-11 19:30:26 +02:00
2012-09-11 16:54:49 +02:00
2012-10-11 10:54:01 +02:00
2012-09-30 15:05:13 +02:00
2012-10-01 10:10:50 +02:00

= KMSCON =

Kmscon is a simple terminal emulator based on linux kernel mode setting (KMS).
It is an attempt to replace the in-kernel VT implementation with a userspace
console.

== Requirements ==

  Kmscon requires the following software:
    - libudev: providing input, video, etc. device hotplug support
    - libxkbcommon: providing internationalized keyboard handling
      libxkbcommon has no public release, yet, but is available on freedesktop.org.
      Building libxkbcommon from Git without root:
       - You can fetch it from Git using: git clone git://anongit.freedesktop.org/xorg/lib/libxkbcommon
       - You can then ``./autogen.sh && make`` in its directory
       - You configure kmscon using:
           PKG_CONFIG_PATH="libxkbcommon/" ./configure --enable-debug
         assuming you cloned it into a subfolder of kmscon called libxkbcommon.

  Everything else is optional:

    For video output at least one of the following is required:
      - fbdev: For framebuffer video output the kernel headers must be installed
               and located in the default include path.
      - DRM: For unaccelerated drm output the "libdrm" library must be installed
             and accessible via pkg-config.
      - OpenGLES2: For accelerated video output via OpenGLESv2 the following must
                   be installed: libdrm, libgbm, egl, glesv2 (i.e., mesa)

    For font handling the following is required:
      - 8x16: The 8x16 font is a static built-in font which does not require
              external dependencies.
      - freetype2: The freetype2 font uses libfreetype2 and libfontconfig to
                   provide a very basic font backend.
      - pango: drawing text with pango
               Pango requires: glib, pango, fontconfig, freetype2 and more

    For multi-seat support you need the following packages:
      - systemd: Actually only the systemd-logind daemon and library is required.

== Install ==

  To compile the kmscon binary, run the standard autotools commands:
    $ ./autogen.sh (you need this only when building from git directly)
    $ ./configure [--enable-debug] (debug-mode is strongly recommended)
    $ make
    $ make install (TODO: this is currently not supported)
  To compile the test applications, run:
    $ make check

  If you want only a very basic kmscon program without any major dependencies,
  use:
    $ ./configure --disable-debug --disable-drm --disable-xkbcommon --disable-systemd --disable-pango --disable-freetype2
  However, you will loose a lot of functionality by dropping all dependencies.

  The following configure options are available. If build-time dependencies
  cannot be satisfied, an option is automatically turned off, except if you
  explicitely enable it via command line:
    --enable-systemd: This requires the systemd-logind library to provide
                      multi-seat support for kmscon. [default: on]
    --enable-udev: This requires libudev for hotplugging support. This is
                   currently mandatory and cannot be disabled. [default: on]
    --enable-fbdev: This adds fbdev video output support. [default: on]
    --enable-drm: This adds DRM video output support. [default: on]
    --enable-gles2: This adds OpenGL hardware accelerated font rendering
                    [default: on]
    --enable-f8x16: The 8x16 font is a static built-in fallback font
                    [default: on]
    --enable-freetype2: Uses freetype2 and fontconfig as font-backend.
                        [default: on]
    --enable-pango: Uses pango as font-backend. [default: on]
    --enable-bblit: Use simply 2D bit-blitting as renderering fallback
                    [default: on]
    --enable-debug: Enable debug mode [default: off]
    --enable-optimizations: Use GCC code optimizations [default: on]

== Running ==

  To get usage information, run:
    $ ./kmscon --help
  You can then run kmscon with:
    $ ./kmscon [options]

  For debug output use "--debug". For verbose output use "--verbose". If you
  didn't compile DRM support then you can use "--fbdev" to make kmscon select
  available framebuffer devices.

  With "--xkb-layout=<lang>" you can switch the keyboard layout.

== License ==

  This software is licensed under the terms of the MIT license. Please see
  ./COPYING for further information.

== FAQ ==

  Please see http://github.com/dvdhrm/kmscon/wiki

== Contact ==

  This software is maintained by:
    David Herrmann <dh.herrmann@googlemail.com>
  If you have any questions, do not hesitate to contact one of the maintainers.

== Code Base ==

  The kmscon code is split into several independent subsystems:
    - uterm:
      This code manages the KMS/DRI output and provides OpenGL framebuffers.
    - console:
      This draws the text on the screen and provides an API for any terminal
      emulator to visualize its contents.
    - eloop:
      Main loop implementation.
    - log:
      Log file handling.
    - unicode:
      Provides basic Unicode handling.
    - font:
      Font loading, caching and drawing operations.
    - input:
      All linux input events are captured here and converted to Unicode
      characters for input handling.
    - vt:
      The linux VT subsystem integration. This allows to run the application in
      a classic linux VT like X does.
    - vte:
      The terminal emulator library.
    - terminal:
      Connects the console, output, input and vte handling into a real terminal.
    - main:
      This connects all subsystems into a usable console application.
Languages
C 93.4%
M4 2.9%
Makefile 1.6%
GLSL 1.3%
C++ 0.7%
Other 0.1%