dm-tool - a tool to control the display manager

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

XDG_SEAT_PATH
              Used by dm-tool to determine in which display manager session it's running. When executing dm-tool
              outside  of  a  display-manager  use  its  list-seats  command to show active sessions and set the
              session to connect to with: exportXDG_SEAT_PATH=/org/freedesktop/DisplayManager/SeatX where SeatX
              is one of the listed sessions.

       dm-tool - a tool to control the display manager

-h,--help
              Show help options

       --version
              Show release version

       --session-bus
              Attempt  to  connect  to  the  display  manager  using the session bus.  This is useful if you are
              running a display manager in a test mode.  If this option is  not  present  dm-tool  will  connect
              using the system bus.

       The following commands are available:

       switch-to-greeter
              Switch to the greeter suitable for logging into a new session.

       switch-to-userUSERNAME[SESSION]
              Switch  to a user session.  If this user is already logged in then the display manager will switch
              to that session, otherwise a new session is started.  If authentication is required a greeter will
              start to collect this.  If the session option is provided then this session  type  will  be  used,
              otherwise the default for this user is used.

       switch-to-guest[SESSION]
              Switch to a guest session.  If the guest session is already active the display manager will switch
              to  that  session, otherwise the guest session is started.  If the session option is provided then
              this session type will be used, otherwise the default for the guest user is used.

       lock   Lock the current seat.  This will switch to a greeter with a hint that the screen is locked.   You
              can return to this session by authenticating in the greeter.

       list-seats
              List the active seats and sessions that are running.

       add-nested-seat
              Start an X server inside a session and connect it to a display manager.

       add-local-x-seatDISPLAY_NUMBER
              Connect an existing X server to the display manager.

       add-seatTYPE[NAME=VALUE...]
              Add a dynamic seat.

lightdm(1)

                                                 7 November 2013                                      DM-TOOL(1)

dm-tool [ OPTIONS ] COMMAND [ ARGS ]