is usually set by including it in the
.B plan9.ini
file read by the PC boot program.
-.IR 9boot(8).
.TP
.B -p
print the current or expected register values at appropriate points depending on
.PP
.I Mode
is of the form
-.IB X x Y x Z
+.IB X x Y x Z[,S][,#N]
, where
.IR X ,
.IR Y ,
and
.I Z
are numbers specifying the display height, width, and depth respectively.
+.I S
+is scaling mode, either
+.I scalefull
+or
+.IR scaleaspect ;
+not specifying it disables scaling altogether.
+.I #N
+is used to switch to a specific display using its index
+.IR N .
+.PP
The mode must appear in
.B /lib/vgadb
as a value for one of the monitor entries.
.B vesa
monitor in
.IR vgadb .
-For a list of available VESA modes, use
+For a list of available VESA modes and connected displays, use
.IP
.EX
aux/vga -m vesa -p
aux/vga -l 1600x1200x8
.EE
.PP
+Show connected and active displays:
+.IP
+.EX
+aux/vga -m vesa -p | grep dsp
+.EE
+.PP
+Switch to display
+.I 4
+and load a specific mode:
+.IP
+.EX
+aux/vga -m vesa -l '1920x1080x16,#4'
+.EE
+.PP
Print the current VGA controller registers.
It is usually best to redirect the output of a
.B -p
.SH SEE ALSO
.IR vga (3),
.IR vgadb (6),
-.IR 9boot (8)
.SH BUGS
.B Aux/vga
makes every effort possible to verify that the mode it is about
It is useful in such cases to have
the above command for setting the controller to a known state
at your fingertips.
+.PP
+Scaling modes currently work with Intel and NVIDIA video
+adapters only, using VESA. Intel doesn't support
+.I scaleaspect
+mode.
+.PP
+Display switching currently works with Intel video adapters
+only, using VESA.