Print this page
12745 man page typos
*** 1,15 ****
'\" 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"
.SH NAME
usbprn \- USB printer class driver
.SH SYNOPSIS
- .LP
.nf
#include <sys/usb/clients/printer/usb_printer.h>
.fi
.LP
--- 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 17, 2020"
.SH NAME
usbprn \- USB printer class driver
.SH SYNOPSIS
.nf
#include <sys/usb/clients/printer/usb_printer.h>
.fi
.LP
*** 21,31 ****
.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.
--- 20,29 ----
*** 42,59 ****
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
--- 40,55 ----
*** 71,89 ****
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
--- 67,83 ----
*** 152,163 ****
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
--- 146,155 ----
*** 241,251 ****
\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
--- 233,242 ----
*** 352,362 ****
.RS 30n
Character special files
.RE
.SH ATTRIBUTES
- .LP
See \fBattributes\fR(5) for descriptions of the following attributes:
.sp
.sp
.TS
--- 343,352 ----
*** 367,380 ****
_
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),
\fBattach\fR(9E)
.sp
.LP
\fIWriting Device Drivers\fR
.sp
--- 357,369 ----
_
Architecture SPARC, x86, PCI-based systems
.TE
.SH SEE ALSO
\fBcfgadm_usb\fR(1M), \fBprintmgr\fR(1M), \fBioctl\fR(2), \fBopen\fR(2),
\fBread\fR(2), \fBwrite\fR(2), \fBattributes\fR(5),
! \fBecpp\fR(7D), \fBugen\fR(7D), \fBusba\fR(7D), \fBprnio\fR(7I),
\fBattach\fR(9E)
.sp
.LP
\fIWriting Device Drivers\fR
.sp
*** 385,395 ****
\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
--- 374,383 ----
*** 444,454 ****
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
--- 432,441 ----