… | |
… | |
1203 | |
1203 | |
1204 | The rest of this document describes various technical aspects of |
1204 | The rest of this document describes various technical aspects of |
1205 | B<rxvt-unicode>. First the description of supported command sequences, |
1205 | B<rxvt-unicode>. First the description of supported command sequences, |
1206 | followed by pixmap support and last by a description of all features |
1206 | followed by pixmap support and last by a description of all features |
1207 | selectable at C<configure> time. |
1207 | selectable at C<configure> time. |
|
|
1208 | |
|
|
1209 | When some functionality is marked as (insecure mode), then it requires |
|
|
1210 | insecure mode to be enabled to work fully, e.g. by using the B<insecure> |
|
|
1211 | resource or command line switch. As that name implies, a terminal running |
|
|
1212 | in insecure mode might not be secure against attackers that can output |
|
|
1213 | arbitrary sequences to the terminal. |
1208 | |
1214 | |
1209 | =head2 Definitions |
1215 | =head2 Definitions |
1210 | |
1216 | |
1211 | =over 4 |
1217 | =over 4 |
1212 | |
1218 | |
… | |
… | |
1626 | |
1632 | |
1627 | =begin table |
1633 | =begin table |
1628 | |
1634 | |
1629 | B<< C<Ps = 5> >> Status Report B<< C<ESC [ 0 n> >> (``OK'') |
1635 | B<< C<Ps = 5> >> Status Report B<< C<ESC [ 0 n> >> (``OK'') |
1630 | B<< C<Ps = 6> >> Report Cursor Position (CPR) [row;column] as B<< C<ESC [ r ; c R> >> |
1636 | B<< C<Ps = 6> >> Report Cursor Position (CPR) [row;column] as B<< C<ESC [ r ; c R> >> |
1631 | B<< C<Ps = 7> >> Request Display Name |
1637 | B<< C<Ps = 7> >> Request Display Name (insecure mode) |
1632 | B<< C<Ps = 8> >> Request Version Number (place in window title) |
1638 | B<< C<Ps = 8> >> Request Version Number (place in window title) |
1633 | |
1639 | |
1634 | =end table |
1640 | =end table |
1635 | |
1641 | |
1636 | =item B<< C<ESC [ Ps SP q> >> |
1642 | =item B<< C<ESC [ Ps SP q> >> |
… | |
… | |
1675 | B<< C<Ps = 11> >> Report window state (responds with C<Ps = 1> or C<Ps = 2>) |
1681 | B<< C<Ps = 11> >> Report window state (responds with C<Ps = 1> or C<Ps = 2>) |
1676 | B<< C<Ps = 13> >> Report window position (responds with C<Ps = 3>) |
1682 | B<< C<Ps = 13> >> Report window position (responds with C<Ps = 3>) |
1677 | B<< C<Ps = 14> >> Report window pixel size (responds with C<Ps = 4>) |
1683 | B<< C<Ps = 14> >> Report window pixel size (responds with C<Ps = 4>) |
1678 | B<< C<Ps = 18> >> Report window text size (responds with C<Ps = 7>) |
1684 | B<< C<Ps = 18> >> Report window text size (responds with C<Ps = 7>) |
1679 | B<< C<Ps = 19> >> Currently the same as C<Ps = 18>, but responds with C<Ps = 9> |
1685 | B<< C<Ps = 19> >> Currently the same as C<Ps = 18>, but responds with C<Ps = 9> |
1680 | B<< C<Ps = 20> >> Reports icon label (B<< C<ESC ] L NAME \234> >>) |
1686 | B<< C<Ps = 20> >> Reports icon label (B<< C<ESC ] L NAME \234> >>) (insecure mode) |
1681 | B<< C<Ps = 21> >> Reports window title (B<< C<ESC ] l NAME \234> >>) |
1687 | B<< C<Ps = 21> >> Reports window title (B<< C<ESC ] l NAME \234> >>) (insecure mode) |
1682 | B<< C<Ps = 24..> >> Set window height to C<Ps> rows |
1688 | B<< C<Ps = 24..> >> Set window height to C<Ps> rows |
1683 | |
1689 | |
1684 | =end table |
1690 | =end table |
1685 | |
1691 | |
1686 | =item B<< C<ESC [ u> >> |
1692 | =item B<< C<ESC [ u> >> |
… | |
… | |
2076 | |
2082 | |
2077 | Set XTerm Parameters. 8-bit ST: 0x9c, 7-bit ST sequence: ESC \ (0x1b, |
2083 | Set XTerm Parameters. 8-bit ST: 0x9c, 7-bit ST sequence: ESC \ (0x1b, |
2078 | 0x5c), backwards compatible terminator BEL (0x07) is also accepted. any |
2084 | 0x5c), backwards compatible terminator BEL (0x07) is also accepted. any |
2079 | B<octet> can be escaped by prefixing it with SYN (0x16, ^V). |
2085 | B<octet> can be escaped by prefixing it with SYN (0x16, ^V). |
2080 | |
2086 | |
|
|
2087 | Many of these settings can be queried by specifying C<?> as parameter, but |
|
|
2088 | this requires insecure mode to be enabled for most of these. |
|
|
2089 | |
2081 | =begin table |
2090 | =begin table |
2082 | |
2091 | |
2083 | B<< C<Ps = 0> >> Change Icon Name and Window Title to B<< C<Pt> >> |
2092 | B<< C<Ps = 0> >> Change Icon Name and Window Title to B<< C<Pt> >> |
2084 | B<< C<Ps = 1> >> Change Icon Name to B<< C<Pt> >> |
2093 | B<< C<Ps = 1> >> Change Icon Name to B<< C<Pt> >> |
2085 | B<< C<Ps = 2> >> Change Window Title to B<< C<Pt> >> |
2094 | B<< C<Ps = 2> >> Change Window Title to B<< C<Pt> >> |
2086 | B<< C<Ps = 3> >> If B<< C<Pt> >> starts with a B<< C<?> >>, query the (STRING) property of the window and return it. If B<< C<Pt> >> contains a B<< C<=> >>, set the named property to the given value, else delete the specified property. |
2095 | B<< C<Ps = 3> >> If B<< C<Pt> >> starts with a B<< C<?> >>, query the (STRING) property of the window and return it (insecure mode). If B<< C<Pt> >> contains a B<< C<=> >>, set the named property to the given value, else delete the specified property. |
2087 | B<< C<Ps = 4> >> B<< C<Pt> >> is a semi-colon separated sequence of one or more semi-colon separated B<number>/B<name> pairs, where B<number> is an index to a colour and B<name> is the name of a colour. Each pair causes the B<number>ed colour to be changed to B<name>. Numbers 0-7 corresponds to low-intensity (normal) colours and 8-15 corresponds to high-intensity colours. 0=black, 1=red, 2=green, 3=yellow, 4=blue, 5=magenta, 6=cyan, 7=white |
2096 | B<< C<Ps = 4> >> B<< C<Pt> >> is a semi-colon separated sequence of one or more semi-colon separated B<number>/B<name> pairs, where B<number> is an index to a colour and B<name> is the name of a colour. Each pair causes the B<number>ed colour to be changed to B<name>. Numbers 0-7 corresponds to low-intensity (normal) colours and 8-15 corresponds to high-intensity colours. 0=black, 1=red, 2=green, 3=yellow, 4=blue, 5=magenta, 6=cyan, 7=white |
2088 | B<< C<Ps = 10> >> Change colour of text foreground to B<< C<Pt> >> |
2097 | B<< C<Ps = 10> >> Change colour of text foreground to B<< C<Pt> >> |
2089 | B<< C<Ps = 11> >> Change colour of text background to B<< C<Pt> >> |
2098 | B<< C<Ps = 11> >> Change colour of text background to B<< C<Pt> >> |
2090 | B<< C<Ps = 12> >> Change colour of text cursor foreground to B<< C<Pt> >> |
2099 | B<< C<Ps = 12> >> Change colour of text cursor foreground to B<< C<Pt> >> |
2091 | B<< C<Ps = 13> >> Change colour of mouse foreground to B<< C<Pt> >> |
2100 | B<< C<Ps = 13> >> Change colour of mouse foreground to B<< C<Pt> >> |
2092 | B<< C<Ps = 17> >> Change background colour of highlight characters to B<< C<Pt> >> |
2101 | B<< C<Ps = 17> >> Change background colour of highlight characters to B<< C<Pt> >> |
2093 | B<< C<Ps = 19> >> Change foreground colour of highlight characters to B<< C<Pt> >> |
2102 | B<< C<Ps = 19> >> Change foreground colour of highlight characters to B<< C<Pt> >> |
|
|
2103 | B<< C<Ps = 20> >> Change background image to B<< C<Pt> >> (see the L<urxvt-background>) extension documentation) |
2094 | B<< C<Ps = 39> >> Change default foreground colour to B<< C<Pt> >>. [deprecated, use 10] |
2104 | B<< C<Ps = 39> >> Change default foreground colour to B<< C<Pt> >>. [deprecated, use 10] |
2095 | B<< C<Ps = 46> >> Change Log File to B<< C<Pt> >> I<unimplemented> |
2105 | B<< C<Ps = 46> >> Change Log File to B<< C<Pt> >> I<unimplemented> |
2096 | B<< C<Ps = 49> >> Change default background colour to B<< C<Pt> >>. [deprecated, use 11] |
2106 | B<< C<Ps = 49> >> Change default background colour to B<< C<Pt> >>. [deprecated, use 11] |
2097 | B<< C<Ps = 50> >> Set fontset to B<< C<Pt> >>, with the following special values of B<< C<Pt> >> (B<rxvt>) B<< C<#+n> >> change up B<< C<n> >> B<< C<#-n> >> change down B<< C<n> >> if B<< C<n> >> is missing of 0, a value of 1 is used I<empty> change to font0 B<< C<n> >> change to font B<< C<n> >> |
2107 | B<< C<Ps = 50> >> Set fontset to B<< C<Pt> >>, with the following special values of B<< C<Pt> >> (B<rxvt>) B<< C<#+n> >> change up B<< C<n> >> B<< C<#-n> >> change down B<< C<n> >> if B<< C<n> >> is missing of 0, a value of 1 is used I<empty> change to font0 B<< C<n> >> change to font B<< C<n> >> |
2098 | B<< C<Ps = 55> >> Log all scrollback buffer and all of screen to B<< C<Pt> >> [disabled] |
2108 | B<< C<Ps = 55> >> Log all scrollback buffer and all of screen to B<< C<Pt> >> [disabled] |
2099 | B<< C<Ps = 701> >> Change current locale to B<< C<Pt> >>, or, if B<< C<Pt> >> is B<< C<?> >>, return the current locale (Compile frills). |
2109 | B<< C<Ps = 701> >> Change current locale to B<< C<Pt> >>, or, if B<< C<Pt> >> is B<< C<?> >>, return the current locale (insecure mode, Compile frills). |
2100 | B<< C<Ps = 702> >> Request version if B<< C<Pt> >> is B<< C<?> >>, returning C<rxvt-unicode>, the resource name, the major and minor version numbers, e.g. C<ESC ] 702 ; rxvt-unicode ; urxvt ; 7 ; 4 ST>. |
2110 | B<< C<Ps = 702> >> Request version if B<< C<Pt> >> is B<< C<?> >>, returning C<rxvt-unicode>, the resource name, the major and minor version numbers, e.g. C<ESC ] 702 ; rxvt-unicode ; urxvt ; 7 ; 4 ST>. |
2101 | B<< C<Ps = 704> >> Change colour of italic characters to B<< C<Pt> >> |
2111 | B<< C<Ps = 704> >> Change colour of italic characters to B<< C<Pt> >> |
|
|
2112 | B<< C<Ps = 705> >> Change background tint color to B<< C<Pt> >> (see the L<urxvt-background>) extension documentation) |
2102 | B<< C<Ps = 706> >> Change colour of bold characters to B<< C<Pt> >> |
2113 | B<< C<Ps = 706> >> Change colour of bold characters to B<< C<Pt> >> |
2103 | B<< C<Ps = 707> >> Change colour of underlined characters to B<< C<Pt> >> |
2114 | B<< C<Ps = 707> >> Change colour of underlined characters to B<< C<Pt> >> |
2104 | B<< C<Ps = 708> >> Change colour of the border to B<< C<Pt> >> |
2115 | B<< C<Ps = 708> >> Change colour of the border to B<< C<Pt> >> |
2105 | B<< C<Ps = 710> >> Set normal fontset to B<< C<Pt> >>. Same as C<Ps = 50>. |
2116 | B<< C<Ps = 710> >> Set normal fontset to B<< C<Pt> >>. Same as C<Ps = 50>. |
2106 | B<< C<Ps = 711> >> Set bold fontset to B<< C<Pt> >>. Similar to C<Ps = 50> (Compile styles). |
2117 | B<< C<Ps = 711> >> Set bold fontset to B<< C<Pt> >>. Similar to C<Ps = 50> (Compile styles). |