Print this page
11639 some man pages show incorrect driver locations
*** 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 ECPP 7D "May 13, 2017"
.SH NAME
ecpp \- IEEE 1284 compliant parallel port driver
.SH SYNOPSIS
- .LP
.nf
#include <sys/types.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 ECPP 7D "Jan 10, 2020"
.SH NAME
ecpp \- IEEE 1284 compliant parallel port driver
.SH SYNOPSIS
.nf
#include <sys/types.h>
.fi
.LP
*** 21,31 ****
.nf
ecpp@unit-address
.fi
.SH DESCRIPTION
- .LP
The \fBecpp\fR driver provides a bi-directional interface to \fIIEEE 1284\fR
compliant devices as well as a forward single-directional interface to
Centronics devices. In addition to the Centronics protocol, the \fBecpp\fR
driver supports the \fIIEEE 1284\fRCompatibility, Nibble, and ECP protocols.
\fBECPP_COMPAT_MODE\fR and \fBECPP_CENTRONICS\fR modes of operation have
--- 20,29 ----
*** 46,56 ****
.sp
.LP
The \fBecpp\fR driver is an \fIexclusive-use\fR device, meaning that if the
device is already open, subsequent opens fail with \fBEBUSY\fR.
.SS "Default Operation"
- .LP
Each time the \fBecpp\fR device is opened, the device is marked as \fBEBUSY\fR
and the configuration variables are set to their default values. The
\fBwrite_timeout\fR period is set to 90 seconds.
.sp
.LP
--- 44,53 ----
*** 69,80 ****
The application may attempt to negotiate the device into a specific mode or set
the \fBwrite_timeout\fR values through the \fBECPPIOC_SETPARMS\fR
\fBioctl\fR(2) call. For mode negotiation to be successful, both the host
workstation and the peripheral must support the requested mode.
.SS "Tunables"
! .LP
! Characteristics of the \fBecpp\fR driver may be tuned by the variables
described in \fB/kernel/drv/ecpp.conf\fR. These variables are read by the
kernel during system startup. To tune the variables, edit the \fBecpp.conf\fR
file and invoke \fBupdate_drv\fR(1M) to have the kernel read the file again.
.sp
.LP
--- 66,76 ----
The application may attempt to negotiate the device into a specific mode or set
the \fBwrite_timeout\fR values through the \fBECPPIOC_SETPARMS\fR
\fBioctl\fR(2) call. For mode negotiation to be successful, both the host
workstation and the peripheral must support the requested mode.
.SS "Tunables"
! Characteristics of the \fBecpp\fR driver may be tuned by the variables
described in \fB/kernel/drv/ecpp.conf\fR. These variables are read by the
kernel during system startup. To tune the variables, edit the \fBecpp.conf\fR
file and invoke \fBupdate_drv\fR(1M) to have the kernel read the file again.
.sp
.LP
*** 81,112 ****
Some Centronics peripherals and certain \fIIEEE 1284\fR compatible peripherals
will not operate with the parallel port operating in a fast handshaking mode.
If printing problems occur, set "fast-centronics" and "fast-1284-compatible" to
"false." See \fB/kernel/drv/ecpp.conf\fR for more information.
.SS "Read/Write Operation"
- .LP
The \fBecpp\fR driver is a full duplex STREAMS device driver. While an
application is writing to an \fIIEEE 1284\fR compliant device, another thread
may read from it.
.SS "Write Operation"
- .LP
A \fBwrite\fR(2) operation returns the number of bytes successfully written to
the stream head. If a failure occurs while a Centronics device is transferring
data, the content of the status bits will be captured at the time of the error
and can be retrieved by the application program using the \fBBPPIOC_GETERR\fR
\fBioctl\fR(2) call. The captured status information is overwritten each time
an attempted transfer or a \fBBPPIOC_TESTIO\fR \fBioctl\fR(2) occurs.
.SS "Read Operation"
- .LP
If a failure or error condition occurs during a \fBread\fR(2), the number of
bytes successfully read is returned (short read). When attempting to read a
port that has no data currently available, \fBread\fR(2) returns \fB0\fR if
\fBO_NDELAY\fR is set. If \fBO_NONBLOCK\fR is set, \fBread\fR(2) returns
\fB-1\fR and sets errno to \fBEAGAIN.\fR If \fBO_NDELAY\fR and \fBO_NONBLOCK\fR
are clear, \fBread\fR(2) blocks until data become available.
.SH IOCTLS
- .LP
The \fBioctl\fR(2) calls described below are supported. Note that when
\fBecpp\fR is transferring data, the driver waits until the data has been sent
to the device before processing the \fBioctl\fR(2) call.
.sp
.LP
--- 77,104 ----
*** 338,348 ****
.ne 2
.na
\fB\fB/dev/lp\fIN\fR\fR\fR
.ad
.RS 19n
! Solaris x86 only. (Backwards compatibility with former \fBlp\fR(7D) devices.)
.RE
.sp
.ne 2
.na
--- 330,340 ----
.ne 2
.na
\fB\fB/dev/lp\fIN\fR\fR\fR
.ad
.RS 19n
! x86 only. (Backwards compatibility with former \fBlp\fR(7D) devices.)
.RE
.sp
.ne 2
.na
*** 353,419 ****
.RE
.SH FILES
.ne 2
.na
! \fB\fBkernel/drv/ecpp\fR\fR
.ad
.sp .6
.RS 4n
! 32-bit ELF kernel module
.RE
.sp
.ne 2
.na
! \fB\fBkernel/drv/sparcv9/ecpp\fR\fR
.ad
.sp .6
.RS 4n
! 64-bit SPARC ELF kernel module
.RE
.sp
.ne 2
.na
! \fB\fBkernel/drv/amd64/ecpp\fR\fR
.ad
.sp .6
.RS 4n
! 64-bit x86 ELF kernel module
.RE
- .sp
- .ne 2
- .na
- \fB\fBkernel/drv/ecpp.conf\fR\fR
- .ad
- .sp .6
- .RS 4n
- driver configuration file
- .RE
-
- .sp
- .ne 2
- .na
- \fB\fBkernel/drv/sparcv9/ecpp.conf\fR\fR
- .ad
- .sp .6
- .RS 4n
- driver configuration file for 64-bit SPARC
- .RE
-
- .sp
- .ne 2
- .na
- \fB\fBkernel/drv/amd64/ecpp.conf\fR\fR
- .ad
- .sp .6
- .RS 4n
- driver configuration file for 64-bit x86
- .RE
-
.SH ERRORS
.ne 2
.na
\fB\fBEBADF\fR\fR
.ad
--- 345,381 ----
.RE
.SH FILES
.ne 2
.na
! \fB/kernel/drv/sparcv9/ecpp\fR
.ad
.sp .6
.RS 4n
! Device driver (SPARC)
.RE
.sp
.ne 2
.na
! \fB/kernel/drv/amd64/ecpp\fR
.ad
.sp .6
.RS 4n
! Device driver (x86)
.RE
.sp
.ne 2
.na
! \fB/kernel/drv/ecpp.conf\fR
.ad
.sp .6
.RS 4n
! Driver configuration file
.RE
.SH ERRORS
.ne 2
.na
\fB\fBEBADF\fR\fR
.ad
*** 466,476 ****
The driver has received a write request for a unit which has an active
peripheral error.
.RE
.SH ATTRIBUTES
- .LP
See \fBattributes\fR(5) for descriptions of the following attributes:
.sp
.sp
.TS
--- 428,437 ----
*** 485,495 ****
_
Interface stability Evolving
.TE
.SH SEE ALSO
- .LP
\fBmodload\fR(1M), \fBmodunload\fR(1M), \fBupdate_drv\fR(1M), \fBioctl\fR(2),
\fBopen\fR(2), \fBread\fR(2), \fBwrite\fR(2), \fBattributes\fR(5),
\fBbpp\fR(7D), \fBusbprn\fR(7D), \fBprnio\fR(7I), \fBstreamio\fR(7I)
.sp
.LP
--- 446,455 ----