… | |
… | |
159 | daemon. |
159 | daemon. |
160 | |
160 | |
161 | =item I am using Debian GNU/Linux and have a problem... |
161 | =item I am using Debian GNU/Linux and have a problem... |
162 | |
162 | |
163 | The Debian GNU/Linux package of rxvt-unicode in sarge contains large |
163 | The Debian GNU/Linux package of rxvt-unicode in sarge contains large |
164 | patches that considerably change the behaviour of rxvt-unicode. Before |
164 | patches that considerably change the behaviour of rxvt-unicode (but |
165 | reporting a bug to the original rxvt-unicode author please download and |
165 | unfortunately this notice has been removed). Before reporting a bug to |
166 | install the genuine version (L<http://software.schmorp.de#rxvt-unicode>) |
166 | the original rxvt-unicode author please download and install the genuine |
167 | and try to reproduce the problem. If you cannot, chances are that the |
167 | version (L<http://software.schmorp.de#rxvt-unicode>) and try to reproduce |
168 | problems are specific to Debian GNU/Linux, in which case it should be |
168 | the problem. If you cannot, chances are that the problems are specific to |
169 | reported via the Debian Bug Tracking System (use C<reportbug> to report |
169 | Debian GNU/Linux, in which case it should be reported via the Debian Bug |
170 | the bug). |
170 | Tracking System (use C<reportbug> to report the bug). |
171 | |
171 | |
172 | For other problems that also affect the Debian package, you can and |
172 | For other problems that also affect the Debian package, you can and |
173 | probably should use the Debian BTS, too, because, after all, it's also a |
173 | probably should use the Debian BTS, too, because, after all, it's also a |
174 | bug in the Debian version and it serves as a reminder for other users that |
174 | bug in the Debian version and it serves as a reminder for other users that |
175 | might encounter the same issue. |
175 | might encounter the same issue. |
176 | |
176 | |
177 | =item I am maintaining rxvt-unicode for distribution/OS XXX, any recommendation? |
177 | =item I am maintaining rxvt-unicode for distribution/OS XXX, any |
|
|
178 | recommendation? |
178 | |
179 | |
179 | You should build one binary with the default options. F<configure> |
180 | You should build one binary with the default options. F<configure> |
180 | now enables most useful options, and the trend goes to making them |
181 | now enables most useful options, and the trend goes to making them |
181 | runtime-switchable, too, so there is usually no drawback to enbaling them, |
182 | runtime-switchable, too, so there is usually no drawback to enbaling them, |
182 | except higher disk and possibly memory usage. The perl interpreter should |
183 | except higher disk and possibly memory usage. The perl interpreter should |
… | |
… | |
194 | C<--enable-everything> (less useful, it will be very big due to a lot of |
195 | C<--enable-everything> (less useful, it will be very big due to a lot of |
195 | encodings built-in that increase download times and are rarely used). |
196 | encodings built-in that increase download times and are rarely used). |
196 | |
197 | |
197 | =item I need to make it setuid/setgid to support utmp/ptys on my OS, is this safe? |
198 | =item I need to make it setuid/setgid to support utmp/ptys on my OS, is this safe? |
198 | |
199 | |
199 | Likely not. While I honestly try to make it secure, and am probably not |
200 | It should be, starting with release 7.1. You are encouraged to properly |
200 | bad at it, I think it is simply unreasonable to expect all of freetype |
201 | install urxvt with privileges necessary for your OS now. |
201 | + fontconfig + xft + xlib + perl + ... + rxvt-unicode itself to all be |
|
|
202 | secure. Also, rxvt-unicode disables some options when it detects that it |
|
|
203 | runs setuid or setgid, which is not nice. Besides, with the embedded perl |
|
|
204 | interpreter the possibility for security problems easily multiplies. |
|
|
205 | |
202 | |
206 | Elevated privileges are only required for utmp and pty operations on some |
203 | When rxvt-unicode detects that it runs setuid or setgid, it will fork |
207 | systems (for example, GNU/Linux doesn't need any extra privileges for |
204 | into a helper process for privileged operations (pty handling on some |
208 | ptys, but some need it for utmp support). It is planned to mvoe this into |
205 | systems, utmp/wtmp/lastlog handling on others) and drop privileges |
209 | a forked handler process, but this is not yet done. |
206 | immediately. This is much safer than most other terminals that keep |
|
|
207 | privileges while running (but is more relevant to urxvt, as it contains |
|
|
208 | things as perl interpreters, which might be "helpful" to attackers). |
210 | |
209 | |
211 | So, while setuid/setgid operation is supported and not a problem on your |
210 | This forking is done as the very first within main(), which is very early |
212 | typical single-user-no-other-logins unix desktop, always remember that |
211 | and reduces possible bugs to initialisation code run before main(), or |
213 | its an awful lot of code, most of which isn't checked for security issues |
212 | things like the dynamic loader of your system, which should result in very |
214 | regularly. |
213 | little risk. |
215 | |
214 | |
216 | =item When I log-in to another system it tells me about missing terminfo data? |
215 | =item When I log-in to another system it tells me about missing terminfo data? |
217 | |
216 | |
218 | The terminal description used by rxvt-unicode is not as widely available |
217 | The terminal description used by rxvt-unicode is not as widely available |
219 | as that for xterm, or even rxvt (for which the same problem often arises). |
218 | as that for xterm, or even rxvt (for which the same problem often arises). |
… | |
… | |
1669 | B<< C<Ps = 12> >> Change colour of text cursor foreground to B<< C<Pt> >> |
1668 | B<< C<Ps = 12> >> Change colour of text cursor foreground to B<< C<Pt> >> |
1670 | B<< C<Ps = 13> >> Change colour of mouse foreground to B<< C<Pt> >> |
1669 | B<< C<Ps = 13> >> Change colour of mouse foreground to B<< C<Pt> >> |
1671 | B<< C<Ps = 17> >> Change colour of highlight characters to B<< C<Pt> >> |
1670 | B<< C<Ps = 17> >> Change colour of highlight characters to B<< C<Pt> >> |
1672 | B<< C<Ps = 18> >> Change colour of bold characters to B<< C<Pt> >> [deprecated, see 706] |
1671 | B<< C<Ps = 18> >> Change colour of bold characters to B<< C<Pt> >> [deprecated, see 706] |
1673 | B<< C<Ps = 19> >> Change colour of underlined characters to B<< C<Pt> >> [deprecated, see 707] |
1672 | B<< C<Ps = 19> >> Change colour of underlined characters to B<< C<Pt> >> [deprecated, see 707] |
1674 | B<< C<Ps = 20> >> Change default background to B<< C<Pt> >> |
1673 | B<< C<Ps = 20> >> Change background pixmap parameters (see section XPM) (Compile XPM). |
1675 | B<< C<Ps = 39> >> Change default foreground colour to B<< C<Pt> >>. |
1674 | B<< C<Ps = 39> >> Change default foreground colour to B<< C<Pt> >>. |
1676 | B<< C<Ps = 46> >> Change Log File to B<< C<Pt> >> I<unimplemented> |
1675 | B<< C<Ps = 46> >> Change Log File to B<< C<Pt> >> I<unimplemented> |
1677 | B<< C<Ps = 49> >> Change default background colour to B<< C<Pt> >>. |
1676 | B<< C<Ps = 49> >> Change default background colour to B<< C<Pt> >>. |
1678 | 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> >> |
1677 | 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> >> |
1679 | B<< C<Ps = 55> >> Log all scrollback buffer and all of screen to B<< C<Pt> >> |
1678 | B<< C<Ps = 55> >> Log all scrollback buffer and all of screen to B<< C<Pt> >> |
… | |
… | |
1948 | alternative input methods (e.g. kinput2) and will also correctly |
1947 | alternative input methods (e.g. kinput2) and will also correctly |
1949 | set up the input for people using dead keys or compose keys. |
1948 | set up the input for people using dead keys or compose keys. |
1950 | |
1949 | |
1951 | =item --enable-unicode3 (default: off) |
1950 | =item --enable-unicode3 (default: off) |
1952 | |
1951 | |
|
|
1952 | Recommended to stay off unless you really need non-BMP characters. |
|
|
1953 | |
1953 | Enable direct support for displaying unicode codepoints above |
1954 | Enable direct support for displaying unicode codepoints above |
1954 | 65535 (the basic multilingual page). This increases storage |
1955 | 65535 (the basic multilingual page). This increases storage |
1955 | requirements per character from 2 to 4 bytes. X11 fonts do not yet |
1956 | requirements per character from 2 to 4 bytes. X11 fonts do not yet |
1956 | support these extra characters, but Xft does. |
1957 | support these extra characters, but Xft does. |
1957 | |
1958 | |
… | |
… | |
1967 | composite characters. This is required for proper viewing of text |
1968 | composite characters. This is required for proper viewing of text |
1968 | where accents are encoded as seperate unicode characters. This is |
1969 | where accents are encoded as seperate unicode characters. This is |
1969 | done by using precomposited characters when available or creating |
1970 | done by using precomposited characters when available or creating |
1970 | new pseudo-characters when no precomposed form exists. |
1971 | new pseudo-characters when no precomposed form exists. |
1971 | |
1972 | |
1972 | Without --enable-unicode3, the number of additional precomposed characters |
1973 | Without --enable-unicode3, the number of additional precomposed |
1973 | is rather limited (2048, if this is full, rxvt-unicode will use the |
1974 | characters is somewhat limited (the 6400 private use characters will be |
1974 | private use area, extending the number of combinations to 8448). With |
|
|
1975 | --enable-unicode3, no practical limit exists. |
1975 | (ab-)used). With --enable-unicode3, no practical limit exists. |
1976 | |
1976 | |
1977 | This option will also enable storage (but not display) of characters |
1977 | This option will also enable storage (but not display) of characters |
1978 | beyond plane 0 (>65535) when --enable-unicode3 was not specified. |
1978 | beyond plane 0 (>65535) when --enable-unicode3 was not specified. |
1979 | |
1979 | |
1980 | The combining table also contains entries for arabic presentation forms, |
1980 | The combining table also contains entries for arabic presentation forms, |
1981 | but these are not currently used. Bug me if you want these to be used (and |
1981 | but these are not currently used. Bug me if you want these to be used (and |
1982 | tell me how these are to be used...). |
1982 | tell me how these are to be used...). |
1983 | |
1983 | |
1984 | =item --enable-fallback(=CLASS) (default: Rxvt) |
1984 | =item --enable-fallback(=CLASS) (default: Rxvt) |
1985 | |
1985 | |
1986 | When reading resource settings, also read settings for class CLASS. To disable resource fallback use --disable-fallback. |
1986 | When reading resource settings, also read settings for class CLASS. To |
|
|
1987 | disable resource fallback use --disable-fallback. |
1987 | |
1988 | |
1988 | =item --with-res-name=NAME (default: urxvt) |
1989 | =item --with-res-name=NAME (default: urxvt) |
1989 | |
1990 | |
1990 | Use the given name as default application name when |
1991 | Use the given name as default application name when |
1991 | reading resources. Specify --with-res-name=rxvt to replace rxvt. |
1992 | reading resources. Specify --with-res-name=rxvt to replace rxvt. |
… | |
… | |
2146 | |
2147 | |
2147 | =item --enable-pointer-blank (default: on) |
2148 | =item --enable-pointer-blank (default: on) |
2148 | |
2149 | |
2149 | Add support to have the pointer disappear when typing or inactive. |
2150 | Add support to have the pointer disappear when typing or inactive. |
2150 | |
2151 | |
2151 | =item --enable-perl (default: off) |
2152 | =item --enable-perl (default: on) |
2152 | |
2153 | |
2153 | Enable an embedded perl interpreter. See the B<@@RXVT_NAME@@perl(3)> |
2154 | Enable an embedded perl interpreter. See the B<@@RXVT_NAME@@perl(3)> |
2154 | manpage (F<doc/rxvtperl.txt>) for more info on this feature, or the files |
2155 | manpage (F<doc/rxvtperl.txt>) for more info on this feature, or the files |
2155 | in F<src/perl-ext/> for the extensions that are installed by default. The |
2156 | in F<src/perl-ext/> for the extensions that are installed by default. The |
2156 | perl interpreter that is used can be specified via the C<PERL> environment |
2157 | perl interpreter that is used can be specified via the C<PERL> environment |