Go to main content

man pages section 1: User Commands

Exit Print View

Updated: July 2017
 
 

dispswitch (1)

Name

dispswitch - Display Device Switch

Synopsis

/usr/bin/dispswitch  [-display  display]  [-key keysym] [-mod modifier]
[-help] [-verbose] [-nosideview] [-testrun]

Description

                                                  DISPSWITCH(__appmansuffix__)



NAME
       dispswitch - Display Device Switch

SYNOPSIS
       /usr/bin/dispswitch  [-display  display]  [-key keysym] [-mod modifier]
       [-help] [-verbose] [-nosideview] [-testrun]

DESCRIPTION
       Dispswitch uses hotkey to switch/rotate on/off of display devices up to
       3  devices.  Side-by-side  views are included when two devices are con-
       nected. It works on systems where both server and driver support  RandR
       version  1.2  (or  above).  User can define a hotkey with -key and -mod
       options (see below), the default is "Shift + F5".

       If a key stroke is hit 5 seconds or longer after the  previous  switch,
       display  devices  are  re-probed  so that any changes such as adding or
       removing devices, can be detected and adapted to.

       If a new display device is added whose mode size is larger than the one
       with which X server is started, or a side-by-side view is switched into
       that needs a larger mode to cover both screens, a config file  specify-
       ing  larger  virtual screen size (Virtual field in Screen Section) will
       be needed during X server startup. Otherwise the larger mode  will  not
       be realized, or the side-by-side view will be skipped.


       -help  Print out a summary of the usage and exit.

       -verbose or -v
              Print out debug messages when run.

       -nosideview
              Skip side-by-side views in two devices rotating.

       -testrun
              Switch/rotate  display  device  states repeatedly without hotkey
              strokes.

       -key <keysym> or -k <keysym>
              Define the keysym of hotkey to be <keysym>,  which  can  be  any
              entry  defined  in defined in /usr/include/X11/keysymdef.h, with
              prefix XK_ removed, such as F5, F8, Escape.

       -mod <modifier> or -m <modifier>
              Define the modifier of hotkey to be  <modifier>.  <modifier>  is
              any  or  combination of modifiers on your system. Run xmodmap(1)
              to find all available modifiers on  your  system.  They  can  be
              none, shift, control, mod1, mod3, mod4, mod5, any.

Examples:
       dispswitch  -key  Escape -mod shift       defines hotkey to be 'shift +
       Esc'

       dispswitch -key F2  -mod  "shift+control"       defines  hotkey  to  be
       'shift + control + F2'



ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:


       +-----------------------------+------------------------------+
       |      ATTRIBUTE TYPE         |       ATTRIBUTE VALUE        |
       +-----------------------------+------------------------------+
       |Availability                 |pkg:/x11/x11-server-utilities |
       +-----------------------------+------------------------------+
       |Interface Stability          |Volatile                      |
       +-----------------------------+------------------------------+



                               __vendorversion__
                                                  DISPSWITCH(__appmansuffix__)