1DM-TOOL(1) General Commands Manual DM-TOOL(1)
2
3
4
6 dm-tool - a tool to control the display manager
7
9 dm-tool [ OPTIONS ] COMMAND [ ARGS ]
10
12 dm-tool is a tool to communicate with the LightDM display manager.
13
15 -h, --help
16 Show help options
17
18 --version
19 Show release version
20
21 --session-bus
22 Attempt to connect to the display manager using the session bus.
23 This is useful if you are running a display manager in a test
24 mode. If this option is not present dm-tool will connect using
25 the system bus.
26
27 The following commands are available:
28
29 switch-to-greeter
30 Switch to the greeter suitable for logging into a new session.
31
32 switch-to-user USERNAME [SESSION]
33 Switch to a user session. If this user is already logged in
34 then the display manager will switch to that session, otherwise
35 a new session is started. If authentication is required a
36 greeter will start to collect this. If the session option is
37 provided then this session type will be used, otherwise the
38 default for this user is used.
39
40 switch-to-guest [SESSION]
41 Switch to a guest session. If the guest session is already
42 active the display manager will switch to that session, other‐
43 wise the guest session is started. If the session option is
44 provided then this session type will be used, otherwise the
45 default for the guest user is used.
46
47 lock Lock the current seat. This will switch to a greeter with a
48 hint that the screen is locked. You can return to this session
49 by authenticating in the greeter.
50
51 list-seats
52 List the active seats and sessions that are running.
53
54 add-nested-seat
55 Start an X server inside a session and connect it to a display
56 manager.
57
58 add-local-x-seat DISPLAY_NUMBER
59 Connect an existing X server to the display manager.
60
61 add-seat TYPE [NAME=VALUE...]
62 Add a dynamic seat.
63
65 XDG_SEAT_PATH
66 Used by dm-tool to determine in which display manager session
67 it's running. When executing dm-tool outside of a display-man‐
68 ager use its list-seats command to show active sessions and set
69 the session to connect to with: export
70 XDG_SEAT_PATH=/org/freedesktop/DesktopManager/SeatX where SeatX
71 is one of the listed sessions.
72
74 lightdm(1)
75
76
77
78 7 November 2013 DM-TOOL(1)