Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
DM-TOOL(1)		     General Commands Manual		      DM-TOOL(1)

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 au-
	    thenticating 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  man-
	    ager.

     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/DisplayMan-
	    ager/SeatX where SeatX is one of the listed sessions.

SEE ALSO
     lightdm(1)

				 7 November 2013		      DM-TOOL(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=dm-tool&manpath=FreeBSD+15.1-RELEASE+and+Ports>

home | help