|
|
1.1 root 1: .TH XNSPRINT 1 Cornell
2: .\" $Header: xnsprint.n,v 1.4 87/01/15 16:57:15 ed Exp $
3: .UC 4
4: .tr -\-
5: ." differences between troff and nroff compensated here:
6: .ie t .ds sc \(sc
7: .el .ds sc section\
8: .ds lq \&"\"
9: .ds rq \&"\"
10: .if t \
11: . ds rq ''
12: .if t \
13: . ds lq ``
14: .SH NAME
15: xnsprint \- Print an interpress master on a Xerox NS print server
16: .SH SYNOPSIS
17: xnsprint [options] file [file ...]
18: .SH DESCRIPTION
19: .I Xnsprint
20: delivers the interpress master in \*(lqfile\*(rq
21: to a Xerox Network Systems
22: print server for formatting and printing.
23: If no printer is specified, the value of the environment variable PRINTER
24: will be used. If this variable has no value, the first printer found in
25: the local Clearinghouse is used.
26: .PP
27: .I Xnsprint
28: first requests status
29: information from the print server, and delays actually sending the file until
30: the server's spooler is available. Unless the -q flag is specified, the printer
31: status information received will be written to standard out.
32: If an attempt to send the file(s) to the printer fails, a status value is
33: returned to the caller which can be used to determine whether retrying is
34: appropriate. Currently, a status of 0 indicates that the file was
35: successfully sent to the printer, a status of 1 indicates that continued
36: retries are appropriate, 2 suggests retrying a few times then giving up, and
37: 3 indicates a hard error which should make the caller give up.
38: .PP
39: The possible options are:
40: .TP
41: .BI -c \ n
42: Causes
43: .I n
44: copies of the output to be printed. The default is 1.
45: .TP
46: .BI -n \ name
47: Sets the delivery address of your output (the \*(lqFor\*(rq field on the
48: cover sheet) to
49: .IR name .
50: The default is your full name as recorded in the gecos field of the password
51: file (\*(lq/etc/passwd\*(rq).
52: .TP
53: .BI -b \ banner
54: Uses
55: .I banner
56: to label the output. It will appear on the cover page on the line labeled
57: \*(lqDocument\*(rq. The default is the name of the input file.
58: .TP
59: .BI -P \ printer
60: .TP
61: .BI -h \ printer
62: Delivers the interpress master to
63: .IR printer ,
64: where
65: .I printer
66: is either the clearinghouse name or the network address of the print server.
67: If an incomplete clearinghouse name (e.g. \*(lqslander\*(rq) is specified,
68: domain and organization fields are defaulted using
69: .IR CH.default .
70: .TP
71: .B -r
72: Causes
73: .I xnsprint
74: to unlink the input file after delivery to the print server.
75: .TP
76: .B -q
77: Causes
78: .I xnsprint
79: to be quiet about printer status and file delivery. Messages indicating that
80: the printer needs human attention will still be displayed.
81: .TP
82: .BI -a \ filename
83: Write lpd(8) status information to the file
84: .IR filename .
85: .TP
86: .B -l
87: Request legal-sized paper. If the printer has legal paper mounted in one
88: tray, that tray will be used.
89: .TP
90: .BI -s \ papersize
91: Request
92: .I papersize
93: sized paper. The argument may be an integer or one of ``usLetter,''
94: ``usLegal,'' ``a0,'' etc. If the requested paper size is not available a
95: serviceUnavailable error will be returned.
96: .TP
97: .BI -m \ message
98: Use
99: .I message
100: as the value for the message field passed to the printer and printed on the
101: cover sheet. Default is your
102: printer's XNS host name, for want of anything better.
103: .TP
104: .BI -W
105: Causes
106: .I xnsprint
107: to wait until the files sent are actually printed before returning.
108: Appropriate status messages are displayed during the waiting period.
109: .SH FILES
110: .nf
111: /etc/passwd for user names
112: /usr/new/lib/xnscourier/CH.default for Clearinghouse defaults
113: .fi
114: .SH "SEE ALSO"
115: maha(1), dipress(1)
116: .PP
117: Interpress Electronic Printing Standard, \s8XSIS\s0 048404
118: .SH DIAGNOSTICS
119: Various messages stating that the printer is unavailable or needs some kind
120: of attention.
121: .SH BUGS
122: Probably lots of them. In particular, the
123: .B -l
124: flag should be generalized.
125: .PP
126: The printer claims that it \*(lqNeeds Key Operator\*(rq when it is really just
127: warming up.
128: .PP
129: .SH AUTHORS
130: JQ Johnson, Larry Parmelee, and Bill Nesheim
131: .PP
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.