.TH "RXVT" "1" "26 MARCH 2003" "X Version 11" "X Tools" .SH "NAME" rxvt (ouR XVT) \- a VT102 emulator for the X window system.PP .SH "SYNOPSIS" .PP \fBrxvt\fP [options] [-e command [ args ]].PP .SH "DESCRIPTION" .PP \fBrxvt\fP, version \fB2\&.7\&.10\fP, is a colour vt102 terminal emulatorintended as an \fIxterm\fP(1) replacement for users who do not requirefeatures such as Tektronix 4014 emulation and toolkit-style configurability\&.As a result, \fBrxvt\fP uses much less swap space -- a significantadvantage on a machine serving many X sessions\&..PP .PP .SH "OPTIONS" .PP The \fBrxvt\fP options (mostly a subset of \fIxterm\fP\'s) are listed below\&.In keeping with the smaller-is-better philosophy, options may be eliminatedor default values chosen at compile-time, so options and defaults listedmay not accurately reflect the version installed on your system\&.  `rxvt -h\' gives a list of major compile-time options on the \fIOptions\fP line\&.Option descriptions may be prefixed with which compile option each isdependent upon\&.  e\&.g\&. `Compile \fIXIM\fP:\' requires \fIXIM\fP on the \fIOptions\fPline\&.  Note: `rxvt -help\' gives a list of all command-line options compiledinto your version\&..PP Note that \fBrxvt\fP permits the resource name to be used as a long-option(--/++ option) so the potential command-line options are far greater thanthose listed\&.For example: `rxvt --loginShell --color1 Orange\'\&..PP Also note that if you do not explictly specify a font (\fB-fn\fP and \fB-fm\fP)or a multichar encoding method (\fB-km\fP), rxvt will select a font for thepreferable encoding according to your locale\&.  Supported encodings are:\fBISO-8859-\fPn (n=\fB1\fP\&.\&.\&.\fB15\fP), \fBKOI8-R\fP, \fBKOI8-U\fP, \fBEUC-JP\fP,\fBShift_JIS\fP, \fBEUC-KR\fP, \fBEUC-CN\fP (aka \fBGB\fP), and \fBBig5\fP\&..PP The following options are available:.PP .IP "\fB-help\fP, \fB--help\fP" Print out a message describing available options\&..IP "\fB-display\fP \fIdisplayname\fP" Attempt to open a window on the named X display (\fB-d\fP stillrespected)\&.  In the absence of this option, the display specifiedby the \fBDISPLAY\fP environment variable is used\&..IP "\fB-geometry\fP \fIgeom\fP" Window geometry (\fB-g\fP still respected);resource \fBgeometry\fP\&..IP "\fB-rv\fP|\fB+rv\fP" Turn on/off simulated reverse video;resource \fBreverseVideo\fP\&..IP "\fB-j\fP|\fB+j\fP" Turn on/off jump scrolling;resource \fBjumpScroll\fP\&..IP "\fB-ip\fP|\fB+ip\fP" Turn on/off inheriting parent window\'s pixmap\&.  Alternative formis \fB-tr\fP;resource \fBinheritPixmap\fP\&..IP "\fB-bg\fP \fIcolour\fP" Window background colour;resource \fBbackground\fP\&..IP "\fB-fg\fP \fIcolour\fP" Window foreground colour;resource \fBforeground\fP\&..IP "\fB-pixmap:\fP \fIfile[;geom]\fP" Compile \fIXPM\fP: Specify XPM file for the background and alsooptionally specify its scaling with a geometry string\&.  Note youmay need to add quotes to avoid special shell interpretation ofthe `;\' in the command-line;resource \fBbackgroundPixmap\fP\&..IP "\fB-cr\fP \fIcolour\fP" The cursor colour;resource \fBcursorColor\fP\&..IP "\fB-pr\fP \fIcolour\fP" The mouse pointer colour;resource \fBpointerColor\fP\&..IP "\fB-bd\fP \fIcolour\fP" The colour of the border between the xterm scrollbar and the text;resource \fBborderColor\fP\&..IP "\fB-fn\fP \fIfontname\fP" Main normal text font;resource \fBfont\fP\&..IP "\fB-fb\fP \fIfontname\fP" Main bold text font;resource \fBboldFont\fP\&..IP "\fB-fm\fP \fIfontname\fP" Main multicharacter font;resource \fBmfont\fP\&..IP "\fB-km\fP \fImode\fP" Compile \fImultichar_languages\fP: Multiple-character font-set encoding mode;\fBeucj\fP: EUC Japanese encoding\&.\fBsjis\fP: Shift JIS encoding\&.\fBbig5\fP: BIG5 encoding\&.\fBgb\fP: GB encoding\&.\fBkr\fP: EUC Korean encoding\&.\fBnoenc\fP: no encoding;resource \fBmultichar_encoding\fP\&..IP "\fB-grk\fP \fImode\fP" Compile \fIGreek\fP: Greek keyboard translation;\fBiso\fP: ISO-8859 mapping\&.\fBibm\fP: IBM-437 mapping;resource \fBgreek_keyboard\fP\&..IP "\fB-name\fP \fIname\fP" Specify the application name under which resourcesare to be obtained, rather than the default executable file name\&.Name should not contain `\&.\' or `*\' characters\&.Also sets the icon and title name\&..IP "\fB-ls\fP|\fB+ls\fP" Start as a login-shell/sub-shell;resource \fBloginShell\fP\&..IP "\fB-ut\fP|\fB+ut\fP" Compile \fIutmp\fP: Inhibit/enable writing a utmp entry;resource \fButmpInhibit\fP\&..IP "\fB-vb\fP|\fB+vb\fP" Turn on/off visual bell on receipt of a bell character;resource \fBvisualBell\fP\&..IP "\fB-sb\fP|\fB+sb\fP" Turn on/off scrollbar;resource \fBscrollBar\fP\&..IP "\fB-si\fP|\fB+si\fP" Turn on/off scroll-to-bottom on TTY output inhibit;resource \fBscrollTtyOutput\fP has opposite effect\&..IP "\fB-sk\fP|\fB+sk\fP" Turn on/off scroll-to-bottom on keypress;resource \fBscrollTtyKeypress\fP\&..IP "\fB-sw\fP|\fB+sw\fP" Turn on/off scrolling with the scrollback buffer as newlines appear\&.  This only takes effect if \fB-si\fP is also given;resource \fBscrollWithBuffer\fP\&..IP "\fB-sr\fP|\fB+sr\fP" Put scrollbar on right/left;resource \fBscrollBar_right\fP\&..IP "\fB-st\fP|\fB+st\fP" Display normal (non XTerm/NeXT) scrollbar without/with a trough;resource \fBscrollBar_floating\fP\&..IP "\fB-mcc\fP|\fB+mcc\fP" Compile \fImultichar_languages\fP: treat multibyte glyphs as singlecharacter for backspace, delete and cursor movement keys;resource \fBmultibyte_cursor\fP\&..IP "\fB-iconic\fP" Start iconified, if the window manager supports that option\&.Alternative form is \fB-ic\fP\&..IP "\fB-sl\fP \fInumber\fP" Save \fInumber\fP lines in the scrollback buffer\&.  See resource entryfor limits; resource \fBsaveLines\fP\&..IP "\fB-b\fP \fInumber\fP" Compile \fIfrills\fP: Internal border of \fInumber\fP pixels\&.  Seeresource entry for limits;resource \fBinternalBorder\fP\&..IP "\fB-w\fP \fInumber\fP" Compile \fIfrills\fP: External border of \fInumber\fP pixels\&. Also, \fB-bw\fP and \fB-borderwidth\fP\&.  See resource entry for limits;resource \fBexternalBorder\fP\&..IP "\fB-lsp\fP \fInumber\fP" Compile \fIlinespace\fP: Lines (pixel height) to insert between eachrow of the display;resource \fBlinespace\fP\&..IP "\fB-tn\fP \fItermname\fP" This option specifies the name of the terminal type to be set in the\fBTERM\fP environment variable\&. This terminal type must exist in the\fItermcap(5)\fP database and should have \fIli#\fP and \fIco#\fP entries;resource \fBtermName\fP\&..IP "\fB-e\fP \fIcommand [arguments]\fP" Run the command with its command-line arguments in the \fBrxvt\fPwindow; also sets the window title and icon name to be the basenameof the program being executed if neither \fI-title\fP (\fI-T\fP) nor\fI-n\fP are given on the command line\&.  If this option is used, itmust be the last on the command-line\&.  If there is no \fB-e\fP optionthen the default is to run the program specified by the \fBSHELL\fPenvironment variable or, failing that, \fIsh(1)\fP\&..IP "\fB-title\fP \fItext\fP" Window title (\fB-T\fP still respected); the default title is thebasename of the program specified after the \fB-e\fP option, ifany, otherwise the application name;resource \fBtitle\fP\&..IP "\fB-n\fP \fItext\fP" Icon name; the default name is the basename of the program specifiedafter the \fB-e\fP option, if any, otherwise the application name;resource \fBiconName\fP\&..IP "\fB-C\fP" Capture system console messages\&..IP "\fB-pt\fP \fIstyle\fP" Compile \fIXIM\fP: input style for input method;\fBOverTheSpot\fP, \fBOffTheSpot\fP, \fBRoot\fP;resource \fBpreeditType\fP\&..IP "\fB-im\fP \fItext\fP" Compile \fIXIM\fP: input method name\&.resource \fBinputMethod\fP\&..IP "\fB-mod\fP \fImodifier\fP" Override detection of Meta modifier with specified key:\fBalt\fP, \fBmeta\fP, \fBhyper\fP, \fBsuper\fP, \fBmod1\fP, \fBmod2\fP, \fBmod3\fP,\fBmod4\fP, \fBmod5\fP;resource \fImodifier\fP\&..IP "\fB-xrm\fP \fIresourcestring\fP" No effect on rxvt\&.  Simply passes through an argument to be madeavailable in the instance\'s argument list\&.  Appears in \fIWM_COMMAND\fPin some window managers\&..SH "RESOURCES (available also as long-options)" .PP Note: `rxvt --help\' gives a list of all resources (long options) compiledinto your version\&.If compiled with internal Xresources support (i\&.e\&. \fBrxvt -h\fP lists \fB\&.Xdefaults\fP) then \fBrxvt\fP accepts application defaults set inXAPPLOADDIR/Rxvt (compile-time defined: usually\fB/usr/lib/X11/app-defaults/Rxvt\fP) and resources set in \fB~/\&.Xdefaults\fP,or \fB~/\&.Xresources\fP if \fB~/\&.Xdefaults\fP does not exist\&.  Note that whenreading X resources, \fBrxvt\fP recognizes two class names: \fBXTerm\fP and\fBRxvt\fP\&.  The class name \fBXTerm\fP allows resources common to both\fBrxvt\fP and \fIxterm\fP to be easily configured, while the class name\fBRxvt\fP allows resources unique to \fBrxvt\fP, notably colours andkey-handling, to be shared between different \fBrxvt\fP configurations\&. If no resources are specified, suitable defaults will be used\&. Command-line arguments can be used to override resource settings\&.  Thefollowing resources are allowed:.PP .IP "\fBgeometry:\fP \fIgeom\fP" Create the window with the specified X window geometry [default80x24];option \fB-geometry\fP\&..IP "\fBbackground:\fP \fIcolour\fP" Use the specified colour as the window\'s background colour [defaultWhite];option \fB-bg\fP\&..IP "\fBforeground:\fP \fIcolour\fP" Use the specified colour as the window\'s foreground colour [defaultBlack];option \fB-fg\fP\&..IP "\fBcolor\fP\fIn\fP\fB:\fP \fIcolour\fP" Use the specified colour for the colour value \fIn\fP, where 0-7corresponds to low-intensity (normal) colours and 8-15 corresponds tohigh-intensity (bold = bright foreground, blink = brightbackground) colours\&.  The canonical names are as follows:0=black, 1=red, 2=green, 3=yellow, 4=blue, 5=magenta, 6=cyan, 7=white,but the actual colour names used are listed in the\fBCOLORS AND GRAPHICS\fP section\&..IP "\fBcolorBD:\fP \fIcolour\fP" Use the specified colour to display bold characters when theforeground colour is the default\&..IP "\fBcolorUL:\fP \fIcolour\fP" Use the specified colour to display underlined characters when theforeground colour is the default\&..IP "\fBcolorRV:\fP \fIcolour\fP" Use the specified colour as the background for reverse videocharacters\&..IP "\fBcursorColor:\fP \fIcolour\fP" Use the specified colour for the cursor\&.  The default is to use theforeground colour;option \fB-cr\fP\&..IP "\fBcursorColor2:\fP \fIcolour\fP" Use the specified colour for the colour of the cursor text\&.  For thisto take effect, \fBcursorColor\fP must also be specified\&.  The defaultis to use the background colour\&..IP "\fBreverseVideo:\fP \fIboolean\fP" \fBTrue\fP: simulate reverse video by foreground and background colours;option \fB-rv\fP\&.\fBFalse\fP: regular screen colours [default];option \fB+rv\fP\&.See note in \fBCOLORS AND GRAPHICS\fP section\&..IP "\fBjumpScroll:\fP \fIboolean\fP" \fBTrue\fP: specify that jump scrolling should be used\&.  When scrollingquickly, fewer screen updates are performed [default];option \fB-j\fP\&.\fBFalse\fP: specify that smooth scrolling should be used;option \fB+j\fP\&..IP "\fBinheritPixmap:\fP \fIboolean\fP" \fBTrue\fP: make the background inherit the parent windows\' pixmap,giving artificial transparency\&.\fBFalse\fP: do not inherit the parent windows\' pixmap\&..IP "\fBscrollColor:\fP \fIcolour\fP" Use the specified colour for the scrollbar [default #B2B2B2]\&..IP "\fBtroughColor:\fP \fIcolour\fP" Use the specified colour for the scrollbar\'s trough area [default#969696]\&.  Only relevant for normal (non XTerm/NeXT) scrollbar\&..IP "\fBbackgroundPixmap:\fP \fIfile[;geom]\fP" Use the specified XPM file (note the `\&.xpm\' extension is optional)for the background and also optionally specify its scaling with ageometry string \fBWxH+X+Y\fP, in which \fB"W" / "H"\fP specify thehorizontal/vertical scale (percent) and \fB"X" / "Y"\fP locate theimage centre (percent)\&.  A scale of 0 displays the image with tiling\&.A scale of 1 displays the image without any scaling\&.  A scale of 2 to9 specifies an integer number of images in that direction\&.  No imagewill be magnified beyond 10 times its original size\&.  The maximumpermitted scale is 1000\&.  [default 0x0+50+50].IP "\fBmenu:\fP \fIfile[;tag]\fP" Read in the specified menu file (note the `\&.menu\' extension isoptional) and also optionally specify a starting tag to find\&.  Seethe reference documentation for details on the syntax for the menuBar\&..IP "\fBpath:\fP \fIpath\fP" Specify the colon-delimited search path for finding files (XPM andmenus), in addition to the paths specified by the \fBRXVTPATH\fP and\fBPATH\fP environment variables\&..IP "\fBfont:\fP \fIfontname\fP" Select the main text font used [default 7x14];option \fB-fn\fP\&..IP "\fBfont\fP\fIn\fP\fB:\fP \fIfontname\fP" Specify the alternative font \fIn\fP\&.  The default font values: .br .RS .IP .TS tab(`); l l .\fBfont\fP: `\ 7x14 \fBfont1\fP: `\ 6x10 \fBfont2\fP: `\ 6x13 \fBfont3\fP: `\ 8x13 \fBfont4\fP: `\ 9x15 .TE .RE .IP .IP "\fBboldFont:\fP \fIfontname\fP" Specify the name of the bold font to use if \fBcolorBD\fP has not beenspecified and it is not possible to map the default foreground colourto colour 8-15 [default NONE]\&.  This font must be the same height andwidth as the normal font;option \fB-fb\fP\&..IP "\fBmfont:\fP \fIfontname\fP" Select the main multiple-character text font used [default k14];option \fB-fk\fP\&..IP "\fBmfont\fP\fIn\fP\fB:\fP \fIfontname\fP" Specify the alternative multiple-character font \fIn\fP\&.  If compiledfor multiple-character fonts, the Roman and multiple-character fontsizes should match\&..IP "\fBmultichar_encoding:\fP \fImode\fP" Set the encoding mode to be used when multicharacter encoding isreceived;\fBeucj\fP: EUC Japanese encoding [default for Kanji]\&.\fBsjis\fP: Shift JIS encoding\&.\fBbig5\fP: BIG5 encoding\&.\fBgb\fP: GB encoding\&.\fBkr\fP: EUC Korean encoding\&.