summaryrefslogtreecommitdiff
path: root/app/xterm/ctlseqs.txt
diff options
context:
space:
mode:
Diffstat (limited to 'app/xterm/ctlseqs.txt')
-rw-r--r--app/xterm/ctlseqs.txt124
1 files changed, 77 insertions, 47 deletions
diff --git a/app/xterm/ctlseqs.txt b/app/xterm/ctlseqs.txt
index 932744ec2..91916521f 100644
--- a/app/xterm/ctlseqs.txt
+++ b/app/xterm/ctlseqs.txt
@@ -20,8 +20,8 @@
Thomas Dickey
XFree86 Project (1996-2006)
- invisible-island.net (2006-2016)
- updated for XTerm Patch #326 (2016/10/02)
+ invisible-island.net (2006-2017)
+ updated for XTerm Patch #329 (2017/06/11)
@@ -312,6 +312,7 @@ CSI ? Ps J
Ps = 0 -> Selective Erase Below (default).
Ps = 1 -> Selective Erase Above.
Ps = 2 -> Selective Erase All.
+ Ps = 3 -> Selective Erase Saved Lines (xterm).
CSI Ps K Erase in Line (EL).
Ps = 0 -> Erase to Right (default).
Ps = 1 -> Erase to Left.
@@ -328,18 +329,45 @@ CSI Ps S Scroll up Ps lines (default = 1) (SU).
CSI ? Pi; Pa; Pv S
If configured to support either Sixel Graphics or ReGIS Graph-
ics, xterm accepts a three-parameter control sequence, where
- Pi, Pa and Pv are the item, action and value.
- Pi = 1 -> item (color registers)
- Pa = 1 -> read the number of color registers
- Pa = 2 -> reset the number of color registers
- Pa = 3 -> set the number of color registers to the value Pv
- The control sequence returns a response using the same form:
+ Pi, Pa and Pv are the item, action and value:
+
+ Pi = 1 -> item is number of color registers.
+ Pi = 2 -> item is Sixel graphics geometry (in pixels).
+ Pi = 3 -> item is ReGIS graphics geometry (in pixels).
+
+ Pa = 1 -> read
+ Pa = 2 -> reset to default
+ Pa = 3 -> set to value in Pv
+ Pa = 4 -> read the maximum allowed value
+
+ Pv can be omitted except when setting (Pa == 3 ).
+ Pv = n <- A single integer is used for color registers.
+ Pv = width; height <- Two integers for graphics geometry.
+
+ xterm replies with a control sequence of the same form:
CSI ? Pi; Ps; Pv S
where Ps is the status:
- Ps = 0 -> success
- Ps = 3 -> failure
+ Ps = 0 -> success.
+ Ps = 1 -> error in Pi.
+ Ps = 2 -> error in Pa.
+ Ps = 3 -> failure.
+
+ On success, Pv represents the value read or set.
+
+ Notes:
+ o The current implementation allows reading the graphics
+ sizes, but disallows modifying those sizes because that is
+ done once, using resource-values.
+ o Graphics geometry is not necessarily the same as "window
+ size" (see the dtterm window manipulation extensions). For
+ example, xterm limits the maximum graphics geometry at com-
+ pile time (1000x1000 as of version 328) although the window
+ size can be larger.
+ o While resizing a window will always change the current
+ graphics geometry, the reverse is not true. Setting graph-
+ ics geometry does not affect the window size.
CSI Ps T Scroll down Ps lines (default = 1) (SD).
CSI Ps ; Ps ; Ps ; Ps ; Ps T
Initiate highlight mouse tracking. Parameters are
@@ -469,7 +497,8 @@ CSI ? Pm h
Ps = 1 0 0 4 -> Send FocusIn/FocusOut events.
Ps = 1 0 0 5 -> Enable UTF-8 Mouse Mode.
Ps = 1 0 0 6 -> Enable SGR Mouse Mode.
- Ps = 1 0 0 7 -> Enable Alternate Scroll Mode.
+ Ps = 1 0 0 7 -> Enable Alternate Scroll Mode, i.e., the
+ alternateScroll resource.
Ps = 1 0 1 0 -> Scroll to bottom on tty output (rxvt).
Ps = 1 0 1 1 -> Scroll to bottom on key press (rxvt).
Ps = 1 0 1 5 -> Enable urxvt Mouse Mode.
@@ -569,7 +598,8 @@ CSI ? Pm l
Ps = 1 0 0 4 -> Don't send FocusIn/FocusOut events.
Ps = 1 0 0 5 -> Disable UTF-8 Mouse Mode.
Ps = 1 0 0 6 -> Disable SGR Mouse Mode.
- Ps = 1 0 0 7 -> Disable Alternate Scroll Mode.
+ Ps = 1 0 0 7 -> Disable Alternate Scroll Mode, i.e., the
+ alternateScroll resource.
Ps = 1 0 1 0 -> Don't scroll to bottom on tty output
(rxvt).
Ps = 1 0 1 1 -> Don't scroll to bottom on key press (rxvt).
@@ -754,14 +784,14 @@ CSI ? Ps n
available, if compiled-in, or CSI ? 5 0 n No Locator, if not.
Ps = 5 6 -> Report Locator type as CSI ? 5 7 ; 1 n Mouse,
if compiled-in, or CSI ? 5 7 ; 0 n Cannot identify, if not.
- Ps = 6 2 -> Report macro space (DECMSR) as CSI Pn \* {
+ Ps = 6 2 -> Report macro space (DECMSR) as CSI Pn \* { .
Ps = 6 3 -> Report memory checksum (DECCKSR) as DCS Pt ! x
- x x x ST
+ x x x ST .
Pt is the request id (from an optional parameter to the
request).
The x's are hexadecimal digits 0-9 and A-F.
Ps = 7 5 -> Report data integrity as CSI ? 7 0 n (ready,
- no errors)
+ no errors).
Ps = 8 5 -> Report multi-session configuration as CSI ? 8 3
n (not configured for multiple-session operation).
CSI > Ps p
@@ -776,6 +806,16 @@ CSI > Ps p
the window. If no parameter is given, xterm uses the default,
which is 1 .
CSI ! p Soft terminal reset (DECSTR).
+CSI Ps ; Ps " p
+ Set conformance level (DECSCL). Valid values for the first
+ parameter:
+ Ps = 6 1 -> VT100.
+ Ps = 6 2 -> VT200.
+ Ps = 6 3 -> VT300.
+ Valid values for the second parameter:
+ Ps = 0 -> 8-bit controls.
+ Ps = 1 -> 7-bit controls (always set for VT100).
+ Ps = 2 -> 8-bit controls.
CSI Ps $ p
Request ANSI mode (DECRQM). For VT300 and up, reply is
CSI Ps; Pm$ y
@@ -791,16 +831,6 @@ CSI ? Ps$ p
CSI ? Ps; Pm$ y
where Ps is the mode number as in DECSET, Pm is the mode value
as in the ANSI DECRQM.
-CSI Ps ; Ps " p
- Set conformance level (DECSCL). Valid values for the first
- parameter:
- Ps = 6 1 -> VT100.
- Ps = 6 2 -> VT200.
- Ps = 6 3 -> VT300.
- Valid values for the second parameter:
- Ps = 0 -> 8-bit controls.
- Ps = 1 -> 7-bit controls (always set for VT100).
- Ps = 2 -> 8-bit controls.
CSI Ps q Load LEDs (DECLL).
Ps = 0 -> Clear all LEDS (default).
Ps = 1 -> Light Num Lock.
@@ -834,11 +864,11 @@ CSI Pt; Pl; Pb; Pr; Ps$ r
Change Attributes in Rectangular Area (DECCARA), VT400 and up.
Pt; Pl; Pb; Pr denotes the rectangle.
Ps denotes the SGR attributes to change: 0, 1, 4, 5, 7.
-CSI Pl ; Pr s
- Set left and right margins (DECSLRM), available only when
- DECLRMM is enabled (VT420 and up).
CSI s Save cursor (ANSI.SYS), available only when DECLRMM is dis-
abled.
+CSI Pl; Pr s
+ Set left and right margins (DECSLRM), available only when
+ DECLRMM is enabled (VT420 and up).
CSI ? Pm s
Save DEC Private Mode Values. Ps values are the same as for
DECSET.
@@ -895,11 +925,6 @@ CSI Ps ; Ps ; Ps t
Ps = 2 3 ; 1 -> Restore xterm icon title from stack.
Ps = 2 3 ; 2 -> Restore xterm window title from stack.
Ps >= 2 4 -> Resize to Ps lines (DECSLPP).
-CSI Pt; Pl; Pb; Pr; Ps$ t
- Reverse Attributes in Rectangular Area (DECRARA), VT400 and
- up.
- Pt; Pl; Pb; Pr denotes the rectangle.
- Ps denotes the attributes to reverse, i.e., 1, 4, 5, 7.
CSI > Ps; Ps t
Set one or more features of the title modes. Each parameter
enables a single feature.
@@ -913,6 +938,11 @@ CSI Ps SP t
Ps = 0 or 1 -> off.
Ps = 2 , 3 or 4 -> low.
Ps = 5 , 6 , 7 , or 8 -> high.
+CSI Pt; Pl; Pb; Pr; Ps$ t
+ Reverse Attributes in Rectangular Area (DECRARA), VT400 and
+ up.
+ Pt; Pl; Pb; Pr denotes the rectangle.
+ Ps denotes the attributes to reverse, i.e., 1, 4, 5, 7.
CSI u Restore cursor (ANSI.SYS).
CSI Ps SP u
Set margin-bell volume (DECSMBV, VT520).
@@ -952,6 +982,10 @@ CSI Ps * x
Ps = 0 -> from start to end position, wrapped.
Ps = 1 -> from start to end position, wrapped.
Ps = 2 -> rectangle (exact).
+CSI Pc ; Pt ; Pl ; Pb ; Pr $ x
+ Fill Rectangular Area (DECFRA), VT420 and up.
+ Pc is the character to use.
+ Pt; Pl; Pb; Pr denotes the rectangle.
CSI Pi ; Pg ; Pt; Pl; Pb; Pr * y
Request Checksum of Rectangular Area (DECRQCRA), VT420 and up.
Response is
@@ -960,10 +994,6 @@ CSI Pi ; Pg ; Pt; Pl; Pb; Pr * y
Pg is the page number.
Pt; Pl; Pb; Pr denotes the rectangle.
The x's are hexadecimal digits 0-9 and A-F.
-CSI Pc ; Pt ; Pl ; Pb ; Pr $ x
- Fill Rectangular Area (DECFRA), VT420 and up.
- Pc is the character to use.
- Pt; Pl; Pb; Pr denotes the rectangle.
CSI Ps ; Pu ' z
Enable Locator Reporting (DECELR).
Valid values for the first parameter:
@@ -1038,8 +1068,8 @@ CSI Pm ' ~
Delete Ps Column(s) (default = 1) (DECDC), VT420 and up.
Operating System Commands
-OSC Ps ; Pt ST
OSC Ps ; Pt BEL
+OSC Ps ; Pt ST
Set Text Parameters. For colors and font, if Pt is a "?", the
control sequence elicits a response which consists of the con-
trol sequence which would set the corresponding value. The
@@ -1758,7 +1788,7 @@ CSI ? Pm h
Ps = 8 4 5 2 -> Sixel scrolling leaves cursor to right of
graphic.
DCS Pa; Pb; Ph q Ps..Ps ST
- See
+ See:
http://vt100.net/docs/vt3xx-gp/chapter14.html
@@ -1782,16 +1812,16 @@ CSI ? Pm h
Ps = 1 0 7 0 -> use private color registers for each
graphic.
DCS Pm p Pr..Pr ST
- See
+ See:
http://vt100.net/docs/vt3xx-gp/chapter1.html
The ReGIS data device control string has one positional param-
eter with four possible values:
- Pm = 0 -> resume command, use fullscreen mode
- Pm = 1 -> start new command, use fullscreen mode
- Pm = 2 -> resume command, use command display mode
- Pm = 3 -> start new command, use command display mode
+ Pm = 0 -> resume command, use fullscreen mode.
+ Pm = 1 -> start new command, use fullscreen mode.
+ Pm = 2 -> resume command, use command display mode.
+ Pm = 3 -> start new command, use command display mode.
Tektronix 4014 Mode
Most of these sequences are standard Tektronix 4014 control sequences.
@@ -1854,6 +1884,9 @@ Parameters for cursor movement are at the end of the ESC Y escape
sequence. Each ordinate is encoded in a single character as value+32.
For example, ! is 1. The screen coordinate system is 0-based.
+ESC < Exit VT52 mode (Enter VT100 mode).
+ESC = Enter alternate keypad mode.
+ESC > Exit alternate keypad mode.
ESC A Cursor up.
ESC B Cursor down.
ESC C Cursor right.
@@ -1868,6 +1901,3 @@ ESC Y Ps Ps
Move the cursor to given row and column.
ESC Z Identify.
-> ESC / Z ("I am a VT52.").
-ESC = Enter alternate keypad mode.
-ESC > Exit alternate keypad mode.
-ESC < Exit VT52 mode (Enter VT100 mode).