--- xrandr.man.txt 2007-07-25 18:19:10.400466232 -0700 +++ /shared/sac/PSARC/2007/430/materials/xrandr.man.txt 2007-07-25 18:20:56.745938600 -0700 @@ -9,35 +9,234 @@ xrandr - primitive command line interface to RandR extension SYNOPSIS - xrandr [-help] [-display display] [-o orientation] [-q] [- - v] [-s size] [-x] [-y] [--screen snum] [--verbose] + xrandr [-help] [-display display] [-q] [-v] [--verbose] + [--screen snum] + RandR version 1.2 options + [--prop] [--fb x] [--fbmm x] + [--dpi ] + Per-output options + [--output ] [--auto] [--mode ] [--preferred] + [--pos x] [--rate ] [--reflect reflection] + [--rotate orientation] [--left-of ] [--right-of + ] [--above ] [--below ] [--same-as + ] [--set ] [--off] [--crtc ] + [--newmode mode] [--rmmode ] [--addmode ] [--delmode ] + RandR version 1.0 and version 1.1 + [-o orientation] [-s size] [-x] [-y] DESCRIPTION - Xrandr is used to set the screen size, orientation and/or - reflection. The -s option is a small integer index used to - specify which size the screen should be set to. To find out - what sizes are available, use the -q option, which reports - the sizes available, the current rotation, and the possible - rotations and reflections. The default size is the first - size specified in the list. The -o option is used to - specify the orientation of the screen, and can be one of - "normal inverted left right 0 1 2 3". - - The -x option instructs the server to reflect the screen on - the X axis. The -y option instructs the server to reflect - the screen on the Y axis. Reflection is applied after rota- - tion. - - The -help option prints out a usage summary. The --verbose - option tells you what xrandr is doing, selects for events, - and tells you when events are received to enable debugging. + Xrandr is used to set the size, orientation and/or reflec- + tion of the outputs for a screen. It can also set the screen + size. There are a few global options; the rest modify a + particular output and follow the specification of that out- + put on the command line. + + --help + Print out a summary of the usage and exit. + + -v Print out the RandR version reported by the X server + and exit. + + --verbose + causes xrandr to be more verbose. When used with -q (or + without other options), xrandr will display more infor- + mation about the server state. When used along with + options that reconfigure the system, progress will be + reported while executing the configuration changes. + + -q When this option is present, or when no configuration + changes are requested, xrandr will display the current + state of the system. + + -screen snum + This option selects which screen to manipulate. Note + this refers to the X screen abstraction, not the moni- + tor (or output). + +RandR version 1.2 options + These options are only available for X server supporting + RandR version 1.2 or newer. + + + +X Version 11 Last change: xrandr 1.2.2 1 + + + + + + +User Commands XRANDR(1) + + + + --prop + This option causes xrandr to display the contents of + properties for each output. --verbose also enables + --prop. + + --fb x + Reconfigures the screen to the specified size. All con- + figured monitors must fit within this size. When this + option is not provided, xrandr computes the smallest + screen size that will hold the set of configured out- + puts; this option provides a way to override that + behaviour. + + --fbmm x + Sets the reported values for the physical size of the + screen. Normally, xrandr resets the reported physical + size values to keep the DPI constant. This overrides + that computation. + + --dpi + This also sets the reported physical size values of the + screen, it uses the specified DPI value to compute an + appropriate physical size using whatever pixel size + will be set. + + Per-output options + + --output + Selects an output to reconfigure. Use either the name + of the output or the XID. + + --auto + For connected but disabled outputs, this will enable + them using their preferred mode (or, something close to + 96dpi if they have no preferred mode). For disconnected + but enabled outputs, this will disable them. + + --mode + This selects a mode. Use either the name or the XID for + + + --preferred + This selects the same mode as --auto, but it doesn't + automatically enable or disable the output. + + --pos x + Position the output within the screen using pixel coor- + dinates. + + --rate + This marks a preference for refresh rates close to the + specified value, when multiple modes have the same + + + +X Version 11 Last change: xrandr 1.2.2 2 + + + + + + +User Commands XRANDR(1) + + + + name, this will select the one with the nearest refresh + rate. + + --reflect reflection + Reflection can be one of 'normal' 'x', 'y' or 'xy'. + This causes the output contents to be reflected across + the specified axes. + + --rotate rotation + Rotation can be one of 'normal', 'left', 'right' or + 'inverted'. This causes the output contents to be + rotated in the specified direction. + +put> + --left-of, --right-of, --above, --below, --same- + as + Sets an output property. Integer properties may be + specified as a valid (see --prop) decimal or hexade- + cimal (with a leading 0x) value. Atom properties may be + set to any of the valid atoms (see --prop). String pro- + perties may be set to any value. + + --off + Disables the output. + + --crtc + Uses the specified crtc (either as an index in the list + of CRTCs or XID). In normal usage, this option is not + required as xrandr tries to make sensible choices about + which crtc to use with each output. When that fails for + some reason, this option can override the normal selec- + tion. + + --newmode mode + New modelines can be added to the server and then asso- + ciated with outputs. This option does the former. The + mode is specified using the ModeLine syntax for + xorg.conf: hdisp hsyncstart hsyncend htotal vdisp + vsyncstart vsyncend vtotal flags. flags can be zero or + more of +HSync, -HSync, +VSync, -VSync, Interlace, + DoubleScan, CSync, +CSync, -CSync. + + --rmmode + This removes a mode from the server if it is otherwise + + + +X Version 11 Last change: xrandr 1.2.2 3 + + + + + + +User Commands XRANDR(1) + + + + unused. + + --addmode + Add a mode to the set of valid modes for an output. + + --delmode + Remove a mode from the set of valid modes for an out- + put. + +RandR version 1.1 options + These options are available for X servers supporting RandR + version 1.1 or older. They are still valid for newer X + servers, but they don't interact sensibly with version 1.2 + options on the same command line. + + -s or -s x + This sets the screen size, either matching by size or + using the index into the list of available sizes. + + -o rotation + This specifies the orientation of the screen, and can + be one of normal, inverted, left or right. + + -x Reflect across the X axis. + + -y Reflect across the Y axis. SEE ALSO Xrandr(3) AUTHORS - Keith Packard, and Jim Gettys, Cambridge Research Labora- - tory, HP Labs, HP. + Keith Packard, Open Source Technology Center, Intel Corpora- + tion. and Jim Gettys, Cambridge Research Laboratory, HP + Labs, HP. ATTRIBUTES @@ -59,8 +258,7 @@ - -X Version 11 Last change: xrandr 1.0.2 1 +X Version 11 Last change: xrandr 1.2.2 4