~kennylevinsen/greetd

ref: 0.8.0 greetd/man/greetd-1.scd -rw-r--r-- 2.0 KiB
d2477a8fKenny Levinsen Bump version to 0.8.0 8 months ago
                                                                                
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
greetd(1)

# NAME

greetd - A login manager daemon

# SYNOPSIS

*greetd* [options]

# OPTIONS

*-h, --help*
	Show help message and quit.

*-c, --config <config>*
	Specifies the configuration file to use.

# DESCRIPTION

greetd was created to fill the need for a simple login manager that makes no
assumptions about the applications it starts, thus being equally suitable for
starting console sessions, Wayland sessions, or something else entirely.

greetd does not itself interact with the user, but relies on an external
greeter process like agreety(1) to handle that aspect.

# OPERATION

greetd operates on *sessions*. A greeter creates a session, attempts to
authenticate a user in it, and finally, uses it start an arbitrary
application.

There are two types of preconfigured sessions: The default session, also known
as the *greeter*, and the optional initial session, serving the purpose of
"auto-login". The initial session, if configured, is started once when greetd
launches. The default session is started on launch if an initial session is
not configured, and started again whenever no session is running, such as when
the user logs out.

An IPC socket is exposed to this greeter, as reported by *GREETD_SOCK*. The
greeter can use this to create, authenticate and finally start a session. For
more information about the IPC layer, see greetd-ipc(7).

Once the greeter has requested the start of a session and terminated itself,
greetd will start the new session. Once this session terminates, the process
starts over.

greetd makes no assumptions about any sessions, including the greeter. They
can be text-based, running in the active console, or full-on graphical
environments.

# CONFIGURATION

greetd looks for a configuration file in /etc/greetd/config.toml by default.
This can be overriden with a command-line argument.

For information on the config file format, see greetd(5).

# AUTHORS

Maintained by Kenny Levinsen <contact@kl.wtf>. For more information about
greetd development, see https://git.sr.ht/~kennylevinsen/greetd.

# SEE ALSO
*greetd*(5) *greetd-ipc*(7)