2014-08-02 22:41:22 +08:00
|
|
|
## Installation instructions
|
|
|
|
|
|
|
|
|
|
SDDM uses CMake to configure and build the project.
|
|
|
|
|
|
|
|
|
|
1. From the project root, create a build directory: `mkdir build`
|
|
|
|
|
2. From the build directory, run cmake to the project root. Eg: `cd build && cmake ..`
|
|
|
|
|
3. To build, run `make`.
|
|
|
|
|
4. To install, run `make install`.
|
|
|
|
|
|
2014-08-03 13:27:37 +08:00
|
|
|
CMake accepts a number of standard and extra arguments:
|
|
|
|
|
|
|
|
|
|
- BUILD_MAN_PAGES, pass -DBUILD_MAN_PAGES=ON to build man pages
|
|
|
|
|
- ENABLE_JOURNALD, pass -DENABLE_JOURNALD=OFF
|
|
|
|
|
to disable logging to the journal
|
|
|
|
|
|
2014-08-02 22:41:22 +08:00
|
|
|
By default, a debug build is created. To build for production, use
|
|
|
|
|
`cmake -DCMAKE_BUILD_TYPE=Release`.
|
|
|
|
|
|
|
|
|
|
To see all the possible arguments, run `cmake -L ..`.
|
|
|
|
|
For documentation on standard CMake variables, see:
|
|
|
|
|
http://www.cmake.org/cmake/help/v3.0/manual/cmake-variables.7.html
|
|
|
|
|
|
|
|
|
|
### Post-installation steps
|
|
|
|
|
|
|
|
|
|
By default, SDDM runs as its own user. An `sddm` user needs to be created, with
|
|
|
|
|
its home set to `/var/lib/sddm` by default.
|
|
|
|
|
|
|
|
|
|
### Dependencies
|
|
|
|
|
|
|
|
|
|
SDDM depends on PAM for authorization and XCB to communicate with the X server.
|
|
|
|
|
Apart from other things, it also depends on Qt for the user interface and event
|
|
|
|
|
loop management.
|
2015-07-06 16:16:38 +08:00
|
|
|
SDDM can optionally make use of logind (the systemd login manager API), or
|
|
|
|
|
ConsoleKit2, or upower to enable support for suspend, hibernate etc.
|
2014-08-02 22:41:22 +08:00
|
|
|
In order to build the man pages, you will need `rst2man` installed. It is
|
|
|
|
|
provided by the python `docutils` package
|
|
|
|
|
|
|
|
|
|
Note that SDDM makes use of C++11 features for a modern and clean codebase,
|
|
|
|
|
therefore it needs a recent version of GCC to compile (4.7 at least).
|
