1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
|
VTPRINT(1) USER COMMANDS VTPRINT(1)
NNAAMMEE
vtprint - print files from UNIX host to printer attached
to local terminal
SSYYNNOOPPSSIISS
vvttpprriinntt [ --bbBBccCCddDDeeEEffFFhhllnnNNqqQQttvvww ] [ --LL _v_t_p_r_i_n_t_c_a_p ] [ --TT
_t_e_r_m_t_y_p_e ] [ --VV _d_e_v_i_c_e ] [ _f_i_l_e_n_a_m_e_._._. ]
DDEESSCCRRIIPPTTIIOONN
vvttpprriinntt is a simple filter that prints ASCII text to a
printer connected to a terminal or terminal emulator. It
uses terminal escape sequences to print, and can substi-
tute for llpprr(1) in circumstances where the printer is not
connected directly to the host or available via TCP/IP.
OOPPTTIIOONNSS
--bb Causes vvttpprriinntt to open the output stream in binary
modes, overriding any automatic postprocessing done
by the host (e.g. CR/LF translations). This has no
effect if the output stream is not a tty device.
--BB Undoes the effect of the --bb option. Note that this
does _n_o_t open the output stream in text mode if it
would not normally be opened in that mode.
--cc Causes vvttpprriinntt to append any linefeeds (ASCII 0xA)
with carriage returns (ASCII 0xD). This is useful
for printing data from a UNIX or similiar host to
an MS-DOS system's printer that expects CR/LF line
termination.
--CC Causes vvttpprriinntt to pass all carriage returns and
linefeeds unmodified.
--dd Use the tty device file instead of stdout for out-
put. This is defined as //ddeevv//ttttyy on this system.
(This is operating system specific and may vary
from system to system.) This is useful for using
vvttpprriinntt as a pipe called by programs that suppress
or redirect the stdout stream of the pipe or print-
ing process.
--DD Use the stdout stream for output, rather than a tty
device file.
--ee Forces vvttpprriinntt to ignore the TERM environment vari-
able and use the builtin control codes instead.
--EE Undoes the effect of the --ee option, which allows
vvttpprriinntt to attempt to find an entry in
//uussrr//llooccaall//lliibb//vvttpprriinntt//vvttpprriinnttccaapp for the TERM
value and use the corresponding control codes.
--ff Requests vvttpprriinntt to suppress inclusion of formfeeds
vtprint v2.0.2 25 October 1994 1
VTPRINT(1) USER COMMANDS VTPRINT(1)
(ASCII 0xC) between multiple files. Note that this
has no affect on any formfeeds that may be present
in the input files already.
--FF Requests vvttpprriinntt to include formfeeds between mul-
tiple files specified on the command-line and at
the end of the last file printed.
--hh Print out a simple usage message.
--ll Print out the vvttpprriinntt license agreement.
--LL _v_t_p_r_i_n_t_c_a_p
Specifies an alternate file to use instead of
//uussrr//llooccaall//lliibb//vvttpprriinntt//vvttpprriinnttccaapp.
--nn Causes vvttpprriinntt to strip the CR from any CR/LF
sequences. This will not affect handling of any
CRs present elsewhere in the file.
--NN Causes vvttpprriinntt to pass all carriage returns and
linefeeds unmodified.
--qq Quiet mode. Suppress various status messages from
being displayed, useful in situations where vvttpprriinntt
is used as part of a shell script, for example.
--QQ Cancels the effect of the --qq option, allowing nor-
mal progress reporting to occur.
--tt Force the use of the TERM variable to perform a
look up of the control sequences to be used in
//uussrr//llooccaall//lliibb//vvttpprriinntt//vvttpprriinnttccaapp. If an entry in
that file can't be found, vvttpprriinntt will abort with
an error.
--TT _t_e_r_m_t_y_p_e
Use the value of _t_e_r_m_t_y_p_e instead of the value of
the TERM environment variable when performing
lookups in //uussrr//llooccaall//lliibb//vvttpprriinntt//vvttpprriinnttccaapp.
--vv Display version information.
--VV _d_e_v_i_c_e
Specifies an alternate device file instead of
//ddeevv//ttttyy to use.
--ww Display important warranty waiver information. NO
WARRANTY!
---- This option changes no special operational parame-
ters of vvttpprriinntt.. But it does indicate to the pro-
gram that all of the command-line arguments which
follow are to be parsed as filenames, even if they
vtprint v2.0.2 25 October 1994 2
VTPRINT(1) USER COMMANDS VTPRINT(1)
begin with a dash. Hence to process a single file
with the name "file" you would call vvttpprriinntt as "
vvttpprriinntt -- -file".
EENNVVIIRROONNMMEENNTT
TERM the type of the terminal vvttpprriinntt will assume is
being used.
VTPRINT
string of options to be used by vvttpprriinntt..
AAUUTTHHOORR
vvttpprriinntt was written by Garrett D'Amore, on December 27,
1993 and last modified on October 25, 1994. It is heavily
derived from a similar program, called llpprriinntt,, by the same
author. He can be reached via Internet e-mail at gar-
rett@sciences.sdsu.edu.
DDIISSTTRRIIBBUUTTIIOONN
The latest version of vvttpprriinntt can be obtained by anonymous
ftp at ftp.sdsu.edu in the //ppuubb//vvttpprriinntt directory. Please
read the IINNDDEEXX and RREEAADDMMEE files before downloading.
If you do not have ftp availability, then you can request
a uuencoded copy of vvttpprriinntt be sent to you via e-mail from
the author. The author is also willing to make other
arrangements as needed, within certain limitations.
MMAAIILLIINNGG LLIISSTT
A mailing list for the discussion of topics related to and
about vvttpprriinntt exists. To subscribe to this mailing list,
send a message to "vtprint-request@sdsu.edu" with the word
"subscribe" as the body. An automated list server will
reply with information about the mailing list.
CCOOPPYYRRIIGGHHTT
vvttpprriinntt is copyrighted 1994, by Garrett D'Amore. It may
be freely redistributed or modified, so long as this and
any other copyright notices are included in their original
form with the program. The user is granted the right to
use this program without limitation.
DDIISSCCLLAAIIMMEERR
vvttpprriinntt is provided WITHOUT WARRANTY. The user agrees to
indemnify the author from any claims of damage or loss
arising from the use of or inability to use this program.
In other words, USE AT YOUR OWN RISK!
CCAAVVEEAATTSS
vvttpprriinntt cannot be used to print files containing non-
printable characters, as these may cause conflicts with
the terminal or emulator used.
When used over a serial (modem) connection, vvttpprriinntt may
vtprint v2.0.2 25 October 1994 3
VTPRINT(1) USER COMMANDS VTPRINT(1)
not work properly unless hardware (CTS/RTS) flow control
is used. This is due to the fact that most printers are
slower than serial connections in common use.
vvttpprriinntt uses terminal escape sequences to print, and not
all terminal emulators support these sequences, and of
those that do, some support it differently. You can find
a listing of some of the programs known to work and not to
work with vvttpprriinntt in the file CCOOMMPPAATT.. The best thing to
do is try your particular emulator, and find out if it
works. The author would appreciate any reports of success
or failure, or strange behavior. You can send those to
him via Internet e-mail. (See the AAUUTTHHOORR chapter for how
to reach him.)
The //uussrr//llooccaall//lliibb//vvttpprriinntt//vvttpprriinnttccaapp file is still
largely incomplete. The author would very much appreciate
it if individuals with more information different termi-
nals would get in contact with him so that support can be
added for these terminals in the master archive.
Do _n_o_t background this program, as it has no way of know-
ing when it is in the background and when it is in the
foreground. This will result in your foreground process'
output being printed as well as the output from vvttpprriinntt..
FFIILLEESS
//uussrr//llooccaall//lliibb//vvttpprriinntt//vvttpprriinnttccaapp
TTOODDOOSS
Fix any bugs present, clean-up the documentation, continue
to build upon entries in the CCOOMMPPAATT and
//uussrr//llooccaall//lliibb//vvttpprriinntt//vvttpprriinnttccaapp files, and finally,
finish getting a college education!
BBUUGGSS
vvttpprriinntt doesn't handle some signals properly, especially
the SIGKILL and SIGSTOP signals, which can't be caught
anyway. Also it doesn't check to see if you have back-
grounded the process. The resulting condition may leave
all output directed to the printer instead of the screen.
The fix for this condition is to run the provided vvttpprrttooffff
program with no arguments, which will restore normal
screen output. (You probably won't be able to see what
you're typing while you start vvttpprrttooffff from the shell.)
SSEEEE AALLSSOO
llpprr(1), vvttpprriinnttccaapp(5), vvttpprrttooffff(1)
vtprint v2.0.2 25 October 1994 4
|
