summaryrefslogtreecommitdiff
path: root/usr/src/man/man1/postio.1
diff options
context:
space:
mode:
Diffstat (limited to 'usr/src/man/man1/postio.1')
-rw-r--r--usr/src/man/man1/postio.132
1 files changed, 3 insertions, 29 deletions
diff --git a/usr/src/man/man1/postio.1 b/usr/src/man/man1/postio.1
index 10f3459e90..ffd7084208 100644
--- a/usr/src/man/man1/postio.1
+++ b/usr/src/man/man1/postio.1
@@ -3,19 +3,19 @@
.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
-.TH postio 1 "9 Sep 1996" "SunOS 5.11" "User Commands"
+.TH POSTIO 1 "Sep 9, 1996"
.SH NAME
postio \- serial interface for PostScript printers
.SH SYNOPSIS
.LP
.nf
-\fBpostio\fR \fB-l\fR \fIline\fR [\fB-D\fR] [\fB-i\fR] [\fB-q\fR] [\fB-t\fR] [\fB-S\fR] [\fB-b\fR \fIspeed\fR] [\fB-B\fR \fInum\fR]
+\fBpostio\fR \fB-l\fR \fIline\fR [\fB-D\fR] [\fB-i\fR] [\fB-q\fR] [\fB-t\fR] [\fB-S\fR] [\fB-b\fR \fIspeed\fR] [\fB-B\fR \fInum\fR]
[\fB-L\fR \fIfile\fR] [\fB-P\fR \fIstring\fR] [\fB-R\fR \fInum\fR] [\fIfile\fR]...
.fi
.LP
.nf
-\fB/usr/lib/lp/postscript/postio\fR
+\fB/usr/lib/lp/postscript/postio\fR
.fi
.SH DESCRIPTION
@@ -29,24 +29,20 @@ postio \- serial interface for PostScript printers
The first group of \fIoptions\fR should be sufficient for most applications:
.sp
.ne 2
-.mk
.na
\fB\fB-D\fR\fR
.ad
.RS 13n
-.rt
Enable debug mode. Guarantees that everything read on \fBline\fR will be added
to the log file (standard error by default).
.RE
.sp
.ne 2
-.mk
.na
\fB\fB-q\fR\fR
.ad
.RS 13n
-.rt
Prevents status queries while \fIfiles\fR are being sent to the printer. When
status queries are disabled a dummy message is appended to the log file before
each block is transmitted.
@@ -54,12 +50,10 @@ each block is transmitted.
.sp
.ne 2
-.mk
.na
\fB\fB-b\fR\fI speed\fR\fR
.ad
.RS 13n
-.rt
Transmit data over \fBline\fR at baud rate \fIspeed\fR. Recognized baud rates
are 1200, 2400, 4800, 9600, and 19200. The default \fIspeed\fR is \fB9600\fR
baud.
@@ -67,24 +61,20 @@ baud.
.sp
.ne 2
-.mk
.na
\fB\fB-B\fR\fI num\fR\fR
.ad
.RS 13n
-.rt
Set the internal buffer size for reading and writing \fIfiles\fR to \fInum\fR
bytes. By default \fInum\fR is \fB2048\fR bytes.
.RE
.sp
.ne 2
-.mk
.na
\fB\fB-l\fR\fI line\fR\fR
.ad
.RS 13n
-.rt
Connect to the printer attached to \fBline\fR. In most cases there is no
default and \fBpostio\fR must be able to read and write \fBline\fR. If the
\fBline\fR does not begin with a \fB/\fR it may be treated as a Datakit
@@ -93,12 +83,10 @@ destination.
.sp
.ne 2
-.mk
.na
\fB\fB-L\fR\fI file\fR\fR
.ad
.RS 13n
-.rt
Data received on \fBline\fR gets put in \fBfile\fR. The default log \fBfile\fR
is standard error. Printer or status messages that don't show a change in state
are not normally written to \fBfile\fR but can be forced out using the \fB-D\fR
@@ -107,24 +95,20 @@ option.
.sp
.ne 2
-.mk
.na
\fB\fB-P\fR\fI string\fR\fR
.ad
.RS 13n
-.rt
Send \fIstring\fR to the printer before any of the input files. The default
\fIstring\fR is simple PostScript code that disables timeouts.
.RE
.sp
.ne 2
-.mk
.na
\fB\fB-R\fR\fI num\fR\fR
.ad
.RS 13n
-.rt
Run \fBpostio\fR as a single process if \fInum\fR is 1 or as separate read and
write processes if \fInum\fR is 2. By default \fBpostio\fR runs as a single
process.
@@ -137,12 +121,10 @@ The next two \fIoptions\fR are provided for users who expect to run
programs:
.sp
.ne 2
-.mk
.na
\fB\fB-i\fR\fR
.ad
.RS 6n
-.rt
Run the program in interactive mode. Any \fIfiles\fR are sent first and
followed by the standard input. Forces separate read and write processes and
overrides many other options. To exit interactive mode use your interrupt or
@@ -152,12 +134,10 @@ quit character. To get a friendly interactive connection with the printer type
.sp
.ne 2
-.mk
.na
\fB\fB-t\fR\fR
.ad
.RS 6n
-.rt
Data received on \fBline\fR and not recognized as printer or status information
is written to the standard output. Forces separate read and write processes.
Convenient if you have a PostScript program that will be returning useful data
@@ -170,12 +150,10 @@ The last option is not generally recommended and should only be used if all
else fails to provide a reliable connection:
.sp
.ne 2
-.mk
.na
\fB\fB-S\fR\fR
.ad
.RS 6n
-.rt
Slow the transmission of data to the printer. Severely limits throughput, runs
as a single process, disables the \fB-q\fR option, limits the internal buffer
size to 1024 bytes, can use an excessive amount of CPU time, and does nothing
@@ -273,23 +251,19 @@ data in file results, and put log messages in file \fIlog\fR:
The following exit values are returned:
.sp
.ne 2
-.mk
.na
\fB\fB0\fR\fR
.ad
.RS 12n
-.rt
Successful completion.
.RE
.sp
.ne 2
-.mk
.na
\fBnon-zero\fR
.ad
.RS 12n
-.rt
An error occurred.
.RE