NAME

       dm-tool - a tool to control the display manager

SYNOPSIS

       dm-tool [ OPTIONS ] COMMAND [ ARGS ]

DESCRIPTION

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

OPTIONS

       -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-user USERNAME [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-seat DISPLAY_NUMBER
              Connect an existing X server to the display manager.

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

ENVIRONMENT

       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:   export
              XDG_SEAT_PATH=/org/freedesktop/DesktopManager/SeatX  where  SeatX  is  one  of  the
              listed sessions.

SEE ALSO

       lightdm(1)

                                         7 November 2013                               DM-TOOL(1)