ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/rxvt-unicode/doc/rxvt.7.txt
(Generate patch)

Comparing rxvt-unicode/doc/rxvt.7.txt (file contents):
Revision 1.44 by root, Mon Jan 16 14:48:39 2006 UTC vs.
Revision 1.48 by root, Thu Jan 19 19:26:31 2006 UTC

149 When using the rxvtc client, the version displayed is that of the 149 When using the rxvtc client, the version displayed is that of the
150 daemon. 150 daemon.
151 151
152 I am using Debian GNU/Linux and have a problem... 152 I am using Debian GNU/Linux and have a problem...
153 The Debian GNU/Linux package of rxvt-unicode in sarge contains large 153 The Debian GNU/Linux package of rxvt-unicode in sarge contains large
154 patches that considerably change the behaviour of rxvt-unicode. 154 patches that considerably change the behaviour of rxvt-unicode (but
155 Before reporting a bug to the original rxvt-unicode author please 155 unfortunately this notice has been removed). Before reporting a bug
156 download and install the genuine version 156 to the original rxvt-unicode author please download and install the
157 (<http://software.schmorp.de#rxvt-unicode>) and try to reproduce the 157 genuine version (<http://software.schmorp.de#rxvt-unicode>) and try
158 problem. If you cannot, chances are that the problems are specific 158 to reproduce the problem. If you cannot, chances are that the
159 to Debian GNU/Linux, in which case it should be reported via the 159 problems are specific to Debian GNU/Linux, in which case it should
160 Debian Bug Tracking System (use "reportbug" to report the bug). 160 be reported via the Debian Bug Tracking System (use "reportbug" to
161 report the bug).
161 162
162 For other problems that also affect the Debian package, you can and 163 For other problems that also affect the Debian package, you can and
163 probably should use the Debian BTS, too, because, after all, it's 164 probably should use the Debian BTS, too, because, after all, it's
164 also a bug in the Debian version and it serves as a reminder for 165 also a bug in the Debian version and it serves as a reminder for
165 other users that might encounter the same issue. 166 other users that might encounter the same issue.
186 of encodings built-in that increase download times and are rarely 187 of encodings built-in that increase download times and are rarely
187 used). 188 used).
188 189
189 I need to make it setuid/setgid to support utmp/ptys on my OS, is this 190 I need to make it setuid/setgid to support utmp/ptys on my OS, is this
190 safe? 191 safe?
191 Likely not. While I honestly try to make it secure, and am probably 192 It should be, starting with release 7.1. You are encouraged to
192 not bad at it, I think it is simply unreasonable to expect all of 193 properly install urxvt with privileges necessary for your OS now.
193 freetype + fontconfig + xft + xlib + perl + ... + rxvt-unicode 194
194 itself to all be secure. Also, rxvt-unicode disables some options
195 when it detects that it runs setuid or setgid, which is not nice. 195 When rxvt-unicode detects that it runs setuid or setgid, it will
196 Besides, with the embedded perl interpreter the possibility for 196 fork into a helper process for privileged operations (pty handling
197 security problems easily multiplies. 197 on some systems, utmp/wtmp/lastlog handling on others) and drop
198 privileges immediately. This is much safer than most other terminals
199 that keep privileges while running (but is more relevant to urxvt,
200 as it contains things as perl interpreters, which might be "helpful"
201 to attackers).
198 202
199 Elevated privileges are only required for utmp and pty operations on 203 This forking is done as the very first within main(), which is very
200 some systems (for example, GNU/Linux doesn't need any extra 204 early and reduces possible bugs to initialisation code run before
201 privileges for ptys, but some need it for utmp support). It is 205 main(), or things like the dynamic loader of your system, which
202 planned to mvoe this into a forked handler process, but this is not 206 should result in very little risk.
203 yet done.
204
205 So, while setuid/setgid operation is supported and not a problem on
206 your typical single-user-no-other-logins unix desktop, always
207 remember that its an awful lot of code, most of which isn't checked
208 for security issues regularly.
209 207
210 When I log-in to another system it tells me about missing terminfo data? 208 When I log-in to another system it tells me about missing terminfo data?
211 The terminal description used by rxvt-unicode is not as widely 209 The terminal description used by rxvt-unicode is not as widely
212 available as that for xterm, or even rxvt (for which the same 210 available as that for xterm, or even rxvt (for which the same
213 problem often arises). 211 problem often arises).
601 599
602 My input method wants <some encoding> but I want UTF-8, what can I do? 600 My input method wants <some encoding> but I want UTF-8, what can I do?
603 You can specify separate locales for the input method and the rest 601 You can specify separate locales for the input method and the rest
604 of the terminal, using the resource "imlocale": 602 of the terminal, using the resource "imlocale":
605 603
606 URxvt*imlocale: ja_JP.EUC-JP 604 URxvt.imlocale: ja_JP.EUC-JP
607 605
608 Now you can start your terminal with "LC_CTYPE=ja_JP.UTF-8" and 606 Now you can start your terminal with "LC_CTYPE=ja_JP.UTF-8" and
609 still use your input method. Please note, however, that you will not 607 still use your input method. Please note, however, that you will not
610 be able to input characters outside "EUC-JP" in a normal way then, 608 be able to input characters outside "EUC-JP" in a normal way then,
611 as your input method limits you. 609 as your input method limits you.
872 870
873RXVT TECHNICAL REFERENCE 871RXVT TECHNICAL REFERENCE
874DESCRIPTION 872DESCRIPTION
875 The rest of this document describes various technical aspects of 873 The rest of this document describes various technical aspects of
876 rxvt-unicode. First the description of supported command sequences, 874 rxvt-unicode. First the description of supported command sequences,
877 followed by menu and pixmap support and last by a description of all 875 followed by pixmap support and last by a description of all features
878 features selectable at "configure" time. 876 selectable at "configure" time.
879 877
880Definitions 878Definitions
881 "c" The literal character c. 879 "c" The literal character c.
882 880
883 "C" A single (required) character. 881 "C" A single (required) character.
1347 Ps = 12 Change colour of text cursor foreground to Pt 1345 Ps = 12 Change colour of text cursor foreground to Pt
1348 Ps = 13 Change colour of mouse foreground to Pt 1346 Ps = 13 Change colour of mouse foreground to Pt
1349 Ps = 17 Change colour of highlight characters to Pt 1347 Ps = 17 Change colour of highlight characters to Pt
1350 Ps = 18 Change colour of bold characters to Pt [deprecated, see 706] 1348 Ps = 18 Change colour of bold characters to Pt [deprecated, see 706]
1351 Ps = 19 Change colour of underlined characters to Pt [deprecated, see 707] 1349 Ps = 19 Change colour of underlined characters to Pt [deprecated, see 707]
1352 Ps = 20 Change default background to Pt 1350 Ps = 20 Change background pixmap parameters (see section XPM) (Compile XPM).
1353 Ps = 39 Change default foreground colour to Pt. 1351 Ps = 39 Change default foreground colour to Pt.
1354 Ps = 46 Change Log File to Pt unimplemented 1352 Ps = 46 Change Log File to Pt unimplemented
1355 Ps = 49 Change default background colour to Pt. 1353 Ps = 49 Change default background colour to Pt.
1356 Ps = 50 Set fontset to Pt, with the following special values of Pt (rxvt) #+n change up n #-n change down n if n is missing of 0, a value of 1 is used empty change to font0 n change to font n 1354 Ps = 50 Set fontset to Pt, with the following special values of Pt (rxvt) #+n change up n #-n change down n if n is missing of 0, a value of 1 is used empty change to font0 n change to font n
1357 Ps = 55 Log all scrollback buffer and all of screen to Pt 1355 Ps = 55 Log all scrollback buffer and all of screen to Pt
1646 --enable-plain-scroll (default: on) 1644 --enable-plain-scroll (default: on)
1647 Add support for a very unobtrusive, plain-looking scrollbar that is 1645 Add support for a very unobtrusive, plain-looking scrollbar that is
1648 the favourite of the rxvt-unicode author, having used it for many 1646 the favourite of the rxvt-unicode author, having used it for many
1649 years. 1647 years.
1650 1648
1651 --enable-half-shadow (default: off)
1652 Make shadows on the scrollbar only half the normal width & height.
1653 only applicable to rxvt scrollbars.
1654
1655 --enable-ttygid (default: off) 1649 --enable-ttygid (default: off)
1656 Change tty device setting to group "tty" - only use this if your 1650 Change tty device setting to group "tty" - only use this if your
1657 system uses this type of security. 1651 system uses this type of security.
1658 1652
1659 --disable-backspace-key 1653 --disable-backspace-key

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines