1 .TH ST 1 st\-VERSION 2 .SH NAME 3 st \- simple terminal 4 .SH SYNOPSIS 5 .B st 6 .RB [ \-aiv ] 7 .RB [ \-c 8 .IR class ] 9 .RB [ \-f 10 .IR font ] 11 .RB [ \-g 12 .IR geometry ] 13 .RB [ \-n 14 .IR name ] 15 .RB [ \-o 16 .IR iofile ] 17 .RB [ \-T 18 .IR title ] 19 .RB [ \-t 20 .IR title ] 21 .RB [ \-l 22 .IR line ] 23 .RB [ \-w 24 .IR windowid ] 25 .RB [[ \-e ] 26 .IR command 27 .RI [ arguments ...]] 28 .PP 29 .B st 30 .RB [ \-aiv ] 31 .RB [ \-c 32 .IR class ] 33 .RB [ \-f 34 .IR font ] 35 .RB [ \-g 36 .IR geometry ] 37 .RB [ \-n 38 .IR name ] 39 .RB [ \-o 40 .IR iofile ] 41 .RB [ \-T 42 .IR title ] 43 .RB [ \-t 44 .IR title ] 45 .RB [ \-w 46 .IR windowid ] 47 .RB \-l 48 .IR line 49 .RI [ stty_args ...] 50 .SH DESCRIPTION 51 .B st 52 is a simple terminal emulator. 53 .SH OPTIONS 54 .TP 55 .B \-a 56 disable alternate screens in terminal 57 .TP 58 .BI \-c " class" 59 defines the window class (default $TERM). 60 .TP 61 .BI \-f " font" 62 defines the 63 .I font 64 to use when st is run. 65 .TP 66 .BI \-g " geometry" 67 defines the X11 geometry string. 68 The form is [=][<cols>{xX}<rows>][{+-}<xoffset>{+-}<yoffset>]. See 69 .BR XParseGeometry (3) 70 for further details. 71 .TP 72 .B \-i 73 will fixate the position given with the -g option. 74 .TP 75 .BI \-n " name" 76 defines the window instance name (default $TERM). 77 .TP 78 .BI \-o " iofile" 79 writes all the I/O to 80 .I iofile. 81 This feature is useful when recording st sessions. A value of "-" means 82 standard output. 83 .TP 84 .BI \-T " title" 85 defines the window title (default 'st'). 86 .TP 87 .BI \-t " title" 88 defines the window title (default 'st'). 89 .TP 90 .BI \-w " windowid" 91 embeds st within the window identified by 92 .I windowid 93 .TP 94 .BI \-l " line" 95 use a tty 96 .I line 97 instead of a pseudo terminal. 98 .I line 99 should be a (pseudo-)serial device (e.g. /dev/ttyS0 on Linux for serial port 100 0). 101 When this flag is given 102 remaining arguments are used as flags for 103 .BR stty(1). 104 By default st initializes the serial line to 8 bits, no parity, 1 stop bit 105 and a 38400 baud rate. The speed is set by appending it as last argument 106 (e.g. 'st -l /dev/ttyS0 115200'). Arguments before the last one are 107 .BR stty(1) 108 flags. If you want to set odd parity on 115200 baud use for example 'st -l 109 /dev/ttyS0 parenb parodd 115200'. Set the number of bits by using for 110 example 'st -l /dev/ttyS0 cs7 115200'. See 111 .BR stty(1) 112 for more arguments and cases. 113 .TP 114 .B \-v 115 prints version information to stderr, then exits. 116 .TP 117 .BI \-e " command " [ " arguments " "... ]" 118 st executes 119 .I command 120 instead of the shell. If this is used it 121 .B must be the last option 122 on the command line, as in xterm / rxvt. 123 This option is only intended for compatibility, 124 and all the remaining arguments are used as a command 125 even without it. 126 .SH SHORTCUTS 127 .TP 128 .B Break 129 Send a break in the serial line. 130 Break key is obtained in PC keyboards 131 pressing at the same time control and pause. 132 .TP 133 .B Ctrl-Print Screen 134 Toggle if st should print to the 135 .I iofile. 136 .TP 137 .B Shift-Print Screen 138 Print the full screen to the 139 .I iofile. 140 .TP 141 .B Print Screen 142 Print the selection to the 143 .I iofile. 144 .TP 145 .B Ctrl-Shift-Page Up 146 Increase font size. 147 .TP 148 .B Ctrl-Shift-Page Down 149 Decrease font size. 150 .TP 151 .B Ctrl-Shift-Home 152 Reset to default font size. 153 .TP 154 .B Ctrl-Shift-y 155 Paste from primary selection (middle mouse button). 156 .TP 157 .B Ctrl-Shift-c 158 Copy the selected text to the clipboard selection. 159 .TP 160 .B Ctrl-Shift-v 161 Paste from the clipboard selection. 162 .SH CUSTOMIZATION 163 .B st 164 can be customized by creating a custom config.h and (re)compiling the source 165 code. This keeps it fast, secure and simple. 166 .SH AUTHORS 167 See the LICENSE file for the authors. 168 .SH LICENSE 169 See the LICENSE file for the terms of redistribution. 170 .SH SEE ALSO 171 .BR tabbed (1), 172 .BR utmp (1), 173 .BR stty (1), 174 .BR scroll (1) 175 .SH BUGS 176 See the TODO file in the distribution. 177
