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

Comparing rxvt-unicode/doc/rxvt.7.pod (file contents):
Revision 1.85 by root, Mon Jan 16 15:12:48 2006 UTC vs.
Revision 1.89 by root, Wed Jan 18 21:00:39 2006 UTC

… …
159daemon. 159daemon.
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
163The Debian GNU/Linux package of rxvt-unicode in sarge contains large 163The Debian GNU/Linux package of rxvt-unicode in sarge contains large
164patches that considerably change the behaviour of rxvt-unicode. Before 164patches that considerably change the behaviour of rxvt-unicode (but
165reporting a bug to the original rxvt-unicode author please download and 165unfortunately this notice has been removed). Before reporting a bug to
166install the genuine version (L<http://software.schmorp.de#rxvt-unicode>) 166the original rxvt-unicode author please download and install the genuine
167and try to reproduce the problem. If you cannot, chances are that the 167version (L<http://software.schmorp.de#rxvt-unicode>) and try to reproduce
168problems are specific to Debian GNU/Linux, in which case it should be 168the problem. If you cannot, chances are that the problems are specific to
169reported via the Debian Bug Tracking System (use C<reportbug> to report 169Debian GNU/Linux, in which case it should be reported via the Debian Bug
170the bug). 170Tracking System (use C<reportbug> to report the bug).
171 171
172For other problems that also affect the Debian package, you can and 172For other problems that also affect the Debian package, you can and
173probably should use the Debian BTS, too, because, after all, it's also a 173probably should use the Debian BTS, too, because, after all, it's also a
174bug in the Debian version and it serves as a reminder for other users that 174bug in the Debian version and it serves as a reminder for other users that
175might encounter the same issue. 175might 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
178recommendation?
178 179
179You should build one binary with the default options. F<configure> 180You should build one binary with the default options. F<configure>
180now enables most useful options, and the trend goes to making them 181now enables most useful options, and the trend goes to making them
181runtime-switchable, too, so there is usually no drawback to enbaling them, 182runtime-switchable, too, so there is usually no drawback to enbaling them,
182except higher disk and possibly memory usage. The perl interpreter should 183except higher disk and possibly memory usage. The perl interpreter should
… …
194C<--enable-everything> (less useful, it will be very big due to a lot of 195C<--enable-everything> (less useful, it will be very big due to a lot of
195encodings built-in that increase download times and are rarely used). 196encodings 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
199Likely not. While I honestly try to make it secure, and am probably not 200It should be, starting with release 7.1. You are encouraged to properly
200bad at it, I think it is simply unreasonable to expect all of freetype 201install urxvt with privileges necessary for your OS now.
201+ fontconfig + xft + xlib + perl + ... + rxvt-unicode itself to all be
202secure. Also, rxvt-unicode disables some options when it detects that it
203runs setuid or setgid, which is not nice. Besides, with the embedded perl
204interpreter the possibility for security problems easily multiplies.
205 202
206Elevated privileges are only required for utmp and pty operations on some 203When rxvt-unicode detects that it runs setuid or setgid, it will fork
207systems (for example, GNU/Linux doesn't need any extra privileges for 204into a helper process for privileged operations (pty handling on some
208ptys, but some need it for utmp support). It is planned to mvoe this into 205systems, utmp/wtmp/lastlog handling on others) and drop privileges
209a forked handler process, but this is not yet done. 206immediately. This is much safer than most other terminals that keep
207privileges while running (but is more relevant to urxvt, as it contains
208things as perl interpreters, which might be "helpful" to attackers).
210 209
211So, while setuid/setgid operation is supported and not a problem on your 210This forking is done as the very first within main(), which is very early
212typical single-user-no-other-logins unix desktop, always remember that 211and reduces possible bugs to initialisation code run before main(), or
213its an awful lot of code, most of which isn't checked for security issues 212things like the dynamic loader of your system, which should result in very
214regularly. 213little 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
218The terminal description used by rxvt-unicode is not as widely available 217The terminal description used by rxvt-unicode is not as widely available
219as that for xterm, or even rxvt (for which the same problem often arises). 218as 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> >>
… …
2046 2045
2047Add support for a very unobtrusive, plain-looking scrollbar that 2046Add support for a very unobtrusive, plain-looking scrollbar that
2048is the favourite of the rxvt-unicode author, having used it for 2047is the favourite of the rxvt-unicode author, having used it for
2049many years. 2048many years.
2050 2049
2051=item --enable-half-shadow (default: off)
2052
2053Make shadows on the scrollbar only half the normal width & height.
2054only applicable to rxvt scrollbars.
2055
2056=item --enable-ttygid (default: off) 2050=item --enable-ttygid (default: off)
2057 2051
2058Change tty device setting to group "tty" - only use this if 2052Change tty device setting to group "tty" - only use this if
2059your system uses this type of security. 2053your system uses this type of security.
2060 2054

Diff Legend

– Removed lines
+ Added lines
< Changed lines
> Changed lines