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