1DM-TOOL(1)                  General Commands Manual                 DM-TOOL(1)
2
3
4

NAME

6       dm-tool - a tool to control the display manager
7

SYNOPSIS

9       dm-tool [ OPTIONS ] COMMAND [ ARGS ]
10

DESCRIPTION

12       dm-tool is a tool to communicate with the LightDM display manager.
13

OPTIONS

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

ENVIRONMENT

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

SEE ALSO

74       lightdm(1)
75
76
77
78                                7 November 2013                     DM-TOOL(1)
Impressum