Print this page
11639 some man pages show incorrect driver locations

Split Close
Expand all
Collapse all
          --- old/usr/src/man/man7d/ecpp.7d
          +++ new/usr/src/man/man7d/ecpp.7d
   1    1  '\" te
   2    2  .\"  Copyright (c) 2004, Sun Microsystems, Inc.  All Rights Reserved
   3    3  .\" 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.
   4    4  .\" 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.
   5    5  .\" 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]
   6      -.TH ECPP 7D "May 13, 2017"
        6 +.TH ECPP 7D "Jan 10, 2020"
   7    7  .SH NAME
   8    8  ecpp \- IEEE 1284 compliant parallel port driver
   9    9  .SH SYNOPSIS
  10      -.LP
  11   10  .nf
  12   11  #include <sys/types.h>
  13   12  .fi
  14   13  
  15   14  .LP
  16   15  .nf
  17   16  #include <sys/ecppio.h>
  18   17  .fi
  19   18  
  20   19  .LP
  21   20  .nf
  22   21  ecpp@unit-address
  23   22  .fi
  24   23  
  25   24  .SH DESCRIPTION
  26      -.LP
  27   25  The \fBecpp\fR driver provides a bi-directional interface to \fIIEEE 1284\fR
  28   26  compliant devices as well as a forward single-directional interface to
  29   27  Centronics devices. In addition to the Centronics protocol, the \fBecpp\fR
  30   28  driver supports the \fIIEEE 1284\fRCompatibility, Nibble, and ECP protocols.
  31   29  \fBECPP_COMPAT_MODE\fR and \fBECPP_CENTRONICS\fR modes of operation have
  32   30  logically identical handshaking protocols, however devices that support
  33   31  \fBECPP_COMPAT_MODE\fR are \fIIEEE 1284\fR compliant devices. \fIIEEE 1284\fR
  34   32  compliant devices support at least \fBECPP_COMPAT_MODE\fR and
  35   33  \fBECPP_NIBBLE_MODE\fR. Centronics devices support only \fBECPP_CENTRONICS\fR
  36   34  mode.
↓ open down ↓ 4 lines elided ↑ open up ↑
  41   39  default, the strobe pulse width for \fBECPP_CENTRONICS\fR devices is two
  42   40  microseconds. Forward transfers for these devices are managed through PIO. The
  43   41  default characteristics for both \fBECPP_COMPAT_MODE\fR and
  44   42  \fBECPP_CENTRONICS\fR devices may be changed through tunable variables defined
  45   43  in \fBecpp.conf\fR.
  46   44  .sp
  47   45  .LP
  48   46  The \fBecpp\fR driver is an \fIexclusive-use\fR device, meaning that if the
  49   47  device is already open, subsequent opens fail with \fBEBUSY\fR.
  50   48  .SS "Default Operation"
  51      -.LP
  52   49  Each time the \fBecpp\fR device is opened, the device is marked as \fBEBUSY\fR
  53   50  and the configuration variables are set to their default values. The
  54   51  \fBwrite_timeout\fR period is set to 90 seconds.
  55   52  .sp
  56   53  .LP
  57   54  The driver sets the mode variable according to the following algorithm: The
  58   55  driver initially attempts to negotiate the link into \fBECPP_ECP_MODE\fR during
  59   56  \fBopen\fR(2). If it fails, the driver tries to negotiate into
  60   57  \fBECPP_NIBBLE_MODE\fR mode. If that fails, the driver operates in
  61   58  \fBECPP_CENTRONICS\fR mode. Upon successfully opening the device, \fIIEEE
↓ open down ↓ 2 lines elided ↑ open up ↑
  64   61  \fBwrite\fR(2) invokes the driver to move the link into either
  65   62  \fBECPP_COMPAT_MODE\fR or the forward phase of \fBECPP_ECP_MODE\fR. After the
  66   63  transfer completes, the link returns to idle state.
  67   64  .sp
  68   65  .LP
  69   66  The application may attempt to negotiate the device into a specific mode or set
  70   67  the \fBwrite_timeout\fR values through the \fBECPPIOC_SETPARMS\fR
  71   68  \fBioctl\fR(2) call. For mode negotiation to be successful, both the host
  72   69  workstation and the peripheral must support the requested mode.
  73   70  .SS "Tunables"
  74      -.LP
  75      - Characteristics of the \fBecpp\fR driver may be tuned by the variables
       71 +Characteristics of the \fBecpp\fR driver may be tuned by the variables
  76   72  described in \fB/kernel/drv/ecpp.conf\fR. These variables are read by the
  77   73  kernel during system startup. To tune the variables, edit the \fBecpp.conf\fR
  78   74  file and invoke \fBupdate_drv\fR(1M) to have the kernel read the file again.
  79   75  .sp
  80   76  .LP
  81   77  Some Centronics peripherals and certain \fIIEEE 1284\fR compatible peripherals
  82   78  will not operate with the parallel port operating in a fast handshaking mode.
  83   79  If printing problems occur, set "fast-centronics" and "fast-1284-compatible" to
  84   80  "false." See \fB/kernel/drv/ecpp.conf\fR for more information.
  85   81  .SS "Read/Write Operation"
  86      -.LP
  87   82  The \fBecpp\fR driver is a full duplex STREAMS device driver. While an
  88   83  application is writing to an \fIIEEE 1284\fR compliant device, another thread
  89   84  may read from it.
  90   85  .SS "Write Operation"
  91      -.LP
  92   86  A \fBwrite\fR(2) operation returns the number of bytes successfully written to
  93   87  the stream head. If a failure occurs while a Centronics device is transferring
  94   88  data, the content of the status bits will be captured at the time of the error
  95   89  and can be retrieved by the application program using the \fBBPPIOC_GETERR\fR
  96   90  \fBioctl\fR(2) call. The captured status information is overwritten each time
  97   91  an attempted transfer or a \fBBPPIOC_TESTIO\fR \fBioctl\fR(2) occurs.
  98   92  .SS "Read Operation"
  99      -.LP
 100   93  If a failure or error condition occurs during a \fBread\fR(2), the number of
 101   94  bytes successfully read is returned (short read). When attempting to read a
 102   95  port that has no data currently available, \fBread\fR(2) returns \fB0\fR if
 103   96  \fBO_NDELAY\fR is set. If \fBO_NONBLOCK\fR is set, \fBread\fR(2) returns
 104   97  \fB-1\fR and sets errno to \fBEAGAIN.\fR If \fBO_NDELAY\fR and \fBO_NONBLOCK\fR
 105   98  are clear, \fBread\fR(2) blocks until data become available.
 106   99  .SH IOCTLS
 107      -.LP
 108  100  The \fBioctl\fR(2) calls described below are supported. Note that when
 109  101  \fBecpp\fR is transferring data, the driver waits until the data has been sent
 110  102  to the device before processing the \fBioctl\fR(2) call.
 111  103  .sp
 112  104  .LP
 113  105  The ecpp driver supports \fBprnio\fR(7I) interfaces.
 114  106  .LP
 115  107  Note -
 116  108  .sp
 117  109  .RS 2
↓ open down ↓ 215 lines elided ↑ open up ↑
 333  325  bits are reserved. Reading reserved bits always return 1. An attempt to write
 334  326  0s into these bits results in \fBEINVAL\fR.
 335  327  .RE
 336  328  
 337  329  .SH DEVICE SPECIAL FILES
 338  330  .ne 2
 339  331  .na
 340  332  \fB\fB/dev/lp\fIN\fR\fR\fR
 341  333  .ad
 342  334  .RS 19n
 343      -Solaris x86 only. (Backwards compatibility with former \fBlp\fR(7D) devices.)
      335 +x86 only. (Backwards compatibility with former \fBlp\fR(7D) devices.)
 344  336  .RE
 345  337  
 346  338  .sp
 347  339  .ne 2
 348  340  .na
 349  341  \fB\fB/dev/printers/\fIN\fR\fR\fR
 350  342  .ad
 351  343  .RS 19n
 352  344  1284 compliant parallel port device special files appears in both namespaces.
 353  345  .RE
 354  346  
 355  347  .SH FILES
 356  348  .ne 2
 357  349  .na
 358      -\fB\fBkernel/drv/ecpp\fR\fR
      350 +\fB/kernel/drv/sparcv9/ecpp\fR
 359  351  .ad
 360  352  .sp .6
 361  353  .RS 4n
 362      -32-bit ELF kernel module
      354 +Device driver (SPARC)
 363  355  .RE
 364  356  
 365  357  .sp
 366  358  .ne 2
 367  359  .na
 368      -\fB\fBkernel/drv/sparcv9/ecpp\fR\fR
      360 +\fB/kernel/drv/amd64/ecpp\fR
 369  361  .ad
 370  362  .sp .6
 371  363  .RS 4n
 372      -64-bit SPARC ELF kernel module
      364 +Device driver (x86)
 373  365  .RE
 374  366  
 375  367  .sp
 376  368  .ne 2
 377  369  .na
 378      -\fB\fBkernel/drv/amd64/ecpp\fR\fR
      370 +\fB/kernel/drv/ecpp.conf\fR
 379  371  .ad
 380  372  .sp .6
 381  373  .RS 4n
 382      -64-bit x86 ELF kernel module
      374 +Driver configuration file
 383  375  .RE
 384  376  
 385      -.sp
 386      -.ne 2
 387      -.na
 388      -\fB\fBkernel/drv/ecpp.conf\fR\fR
 389      -.ad
 390      -.sp .6
 391      -.RS 4n
 392      -driver configuration file
 393      -.RE
 394      -
 395      -.sp
 396      -.ne 2
 397      -.na
 398      -\fB\fBkernel/drv/sparcv9/ecpp.conf\fR\fR
 399      -.ad
 400      -.sp .6
 401      -.RS 4n
 402      -driver configuration file for 64-bit SPARC
 403      -.RE
 404      -
 405      -.sp
 406      -.ne 2
 407      -.na
 408      -\fB\fBkernel/drv/amd64/ecpp.conf\fR\fR
 409      -.ad
 410      -.sp .6
 411      -.RS 4n
 412      -driver configuration file for 64-bit x86
 413      -.RE
 414      -
 415  377  .SH ERRORS
 416  378  .ne 2
 417  379  .na
 418  380  \fB\fBEBADF\fR\fR
 419  381  .ad
 420  382  .RS 10n
 421  383  The device is opened for write-only access and a read is attempted, or the
 422  384  device is opened for read-only access and a write is attempted.
 423  385  .RE
 424  386  
↓ open down ↓ 36 lines elided ↑ open up ↑
 461  423  .na
 462  424  \fB\fBENXIO\fR\fR
 463  425  .ad
 464  426  .RS 10n
 465  427  The driver has received an open request for a unit for which the attach failed.
 466  428  The driver has received a write request for a unit which has an active
 467  429  peripheral error.
 468  430  .RE
 469  431  
 470  432  .SH ATTRIBUTES
 471      -.LP
 472  433  See \fBattributes\fR(5) for descriptions of the following attributes:
 473  434  .sp
 474  435  
 475  436  .sp
 476  437  .TS
 477  438  box;
 478  439  c | c
 479  440  l | l .
 480  441  ATTRIBUTE TYPE  ATTRIBUTE VALUE
 481  442  _
 482  443  Architecture    PCI-based systems
 483  444  _
 484  445          ISA-based systems (x86)
 485  446  _
 486  447  Interface stability     Evolving
 487  448  .TE
 488  449  
 489  450  .SH SEE ALSO
 490      -.LP
 491  451  \fBmodload\fR(1M), \fBmodunload\fR(1M), \fBupdate_drv\fR(1M), \fBioctl\fR(2),
 492  452  \fBopen\fR(2), \fBread\fR(2), \fBwrite\fR(2), \fBattributes\fR(5),
 493  453  \fBbpp\fR(7D), \fBusbprn\fR(7D), \fBprnio\fR(7I), \fBstreamio\fR(7I)
 494  454  .sp
 495  455  .LP
 496  456  \fIIEEE Std 1284-1994\fR
 497  457  .SH DIAGNOSTICS
 498  458  .ne 2
 499  459  .na
 500  460  \fBParallel port controller not supported\fR
 501  461  .ad
 502  462  .sp .6
 503  463  .RS 4n
 504  464  Driver does not support parallel port controller on the given host. Attach
 505  465  failed.
 506  466  .RE
 507  467  
    
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX