Print this page
12745 man page typos

@@ -1,15 +1,14 @@
 '\" te
 .\" Copyright (c) 2004, Sun Microsystems, Inc. All Rights Reserved
 .\" 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 USBPRN 7D "May 13, 2017"
+.TH USBPRN 7D "May 17, 2020"
 .SH NAME
 usbprn \- USB printer class driver
 .SH SYNOPSIS
-.LP
 .nf
 #include <sys/usb/clients/printer/usb_printer.h>
 .fi
 
 .LP

@@ -21,11 +20,10 @@
 .nf
 usbprn@unit-address
 .fi
 
 .SH DESCRIPTION
-.LP
 The \fBusbprn\fR driver is a USBA (Solaris USB Architecture) compliant client
 driver that supports the \fIUSB Printer Class 1.0\fR specification. The
 \fBusbprn\fR driver supports a subset of the \fBecpp\fR(7D) parallel port
 driver functionality. However, unlike the STREAMS-based \fBecpp\fR driver,
 \fBusbprn\fR is a character driver.

@@ -42,18 +40,16 @@
 selection of printer manufacturer/model information while creating a print
 queue. For USB connected printers, it attempts to pre-select the
 manufacturer and model information based on the 1284 device id supplied by the
 printer.
 .SS "UGEN (Generic USB)"
-.LP
 The \fBusbprn\fR driver also supports a \fBugen\fR(7D) interface allowing raw
 access to the device, for example by libusb applications, by
 passing the drivers bound to each interface. Because a libusb application might
 change the state of the device, you should not access the device through the
 child interface drivers.
 .SH DEFAULT OPERATION
-.LP
 With certain minor exceptions (outlined in the Notes sections below), the
 \fBusbprn\fR driver supports a subset of the \fBecpp\fR(7D) ioctl interfaces:
 .sp
 .LP
 Configuration variables are set to their default values each time the USB

@@ -71,19 +67,17 @@
 Unlike the \fBecpp\fR(7D) driver, \fBusbprn\fR resets configuration variables
 to their default values with each \fBattach\fR(9E). (The \fBecpp\fR(7D) driver
 resets configuration variables with each \fBopen\fR(2).)
 .RE
 .SH WRITE OPERATION
-.LP
 A \fBwrite\fR(2) operation returns the number of bytes successfully written to
 the device. If a failure occurs while a driver is transferring data to printer,
 the contents of the status bits are captured at the time of the error and can
 be retrieved by the application program using the ECPPIOC_GETERR \fBioctl\fR(2)
 call. The captured status information is overwritten each time an
 ECPPIOC_TESTIO \fBioctl\fR(2) occurs.
 .SH IOCTLS
-.LP
 The \fBusbprn\fR driver supports \fBprnio\fR(7I) interfaces. Note that the
 \fBPRNIOC_RESET\fR command has no effect on USB printers.
 .sp
 .LP
 The following \fBioctl\fR(2) calls are supported for backward compatibility and

@@ -152,12 +146,10 @@
 Tests the transfer readiness of a print device and checks status bits to
 determine if a \fBwrite\fR(2) will succeed. If status bits are set, a transfer
 will fail. If a transfer will succeed, zero is returned. If a transfer fails,
 the driver returns \fBEIO\fR and the state of the status bits are captured. The
 captured status can be retrieved using the BPPIOC_GETERR \fBioctl\fR(2) call.
-BPPIOC_TESTIO and BPPIOC_GETERR are compatible to the ioctls specified in
-\fBbpp\fR(7D).
 .LP
 Note -
 .sp
 .RS 2
 Unlike the \fBecpp\fR(7D) driver, only the ECPP_CENTRONICS mode is currently

@@ -241,11 +233,10 @@
 \fBusbprn\fR.
 .RE
 .RE
 
 .SH READ OPERATION
-.LP
 The \fBread\fR operation is not supported and returns \fBEIO\fR.
 .SH ERRORS
 .ne 2
 .na
 \fB\fBEBUSY\fR\fR

@@ -352,11 +343,10 @@
 .RS 30n
 Character special files
 .RE
 
 .SH ATTRIBUTES
-.LP
 See \fBattributes\fR(5) for descriptions of the following attributes:
 .sp
 
 .sp
 .TS

@@ -367,14 +357,13 @@
 _
 Architecture    SPARC, x86, PCI-based systems
 .TE
 
 .SH SEE ALSO
-.LP
 \fBcfgadm_usb\fR(1M), \fBprintmgr\fR(1M), \fBioctl\fR(2), \fBopen\fR(2),
 \fBread\fR(2), \fBwrite\fR(2), \fBattributes\fR(5),
-\fBbpp\fR(7D), \fBecpp\fR(7D), \fBugen\fR(7D), \fBusba\fR(7D), \fBprnio\fR(7I),
+\fBecpp\fR(7D), \fBugen\fR(7D), \fBusba\fR(7D), \fBprnio\fR(7I),
 \fBattach\fR(9E)
 .sp
 .LP
 \fIWriting Device Drivers\fR
 .sp

@@ -385,11 +374,10 @@
 \fIUSB Device Class Definition for Printing Devices 1.0\fR
 .sp
 .LP
 \fISystem Administration Guide: Basic Administration\fR
 .SH DIAGNOSTICS
-.LP
 In addition to being logged, the following messages may appear on the system
 console. All messages are formatted in the following manner:
 .sp
 .in +2
 .nf

@@ -444,11 +432,10 @@
 to the same port. It is available for access but the job that was running prior
 to the hot-removal may be lost.
 .RE
 
 .SH NOTES
-.LP
 The USB printer will be power managed if the device is closed.
 .sp
 .LP
 If a printer is hot-removed before a job completes, the job is terminated and
 the driver will return EIO. All subsequent opens will return \fBENODEV\fR. If a