'\" t
.\" Copyright (c) Michael Haardt (michael@cantor.informatik.rwth-aachen.de), Sun Jan 15 19:16:33 1995
.\"
.\" This is free documentation; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License as
.\" published by the Free Software Foundation; either version 2 of
.\" the License, or (at your option) any later version.
.\"
.\" The GNU General Public License's references to "object code"
.\" and "executables" are to be interpreted as the output of any
.\" document formatting or typesetting system, including
.\" intermediate and printed output.
.\"
.\" This manual is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public
.\" License along with this manual; if not, write to the Free
.\" Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139,
.\" USA.
.\"
.\" Modified, Sun Feb 26 15:02:58 1995, faith@cs.unc.edu
.\" Modified Mon Jun 10 01:32:53 1996 by Martin Schulze (joey@linux.de)
.\"
.TH LP 4 "15. Januar, 1995" "" "Gertedateien"
.SH BEZEICHNUNG
lp \- line printer devices (Zeilendrucker)
.SH BERSICHT
.I "#include <linux/lp.h>"
.SH KONFIGURATION
.BR lp [0\(en2]
sind zeichenorientierte Gerte fr Drucker an der parallelen Schnittstelle;
ihre major numbers sind 6, ihre minor numbers sind 0\(en2.  Die minor
numbers korrespondieren zu den Basisadressen 0x03bc, 0x0378 and 0x0278 der
Druckerports.  Normalerweise haben sie mode 220 und gehren root und Gruppe
lp.  Die Druckerports knnen entweder im polling- oder interrupt-Betrieb
benutzt werden.  Falls ein groer Datendurchsatz erwartet wird, z.B. fr
Laserdrucker, sollten Interrupts benutzt werden.  Fr normale Matrixdrucker
sollte polling ausreichen.  Der default ist polling.
.SH BESCHREIBUNG
Die folgenden
.IR ioctl (2)
Aufrufe werden untersttzt:
.TP
.BI "int ioctl(int " Ifd ", LPTIME, int " arg ")"
Wenn der Druckerpuffer voll ist, schlft der Treiber fr
.I arg
Hundertstelsekunden, bevor er den Puffer erneut prft.  Fr einen
schnellen Drucker sollte dieser Wert niedrig, fr einen langsamen
Drucker dagegen hoch gewhlt werden.  Der default betrgt 2, also 0,02
Sekunden.  Dies beeinflut nur den pollenden Treiber.
.TP
.BI "int ioctl(int " fd ", LPCHAR, int " arg ")"
Setzt die maximale Anzahl von busy-wait Iterationen des pollenden
Treibers, die gemacht werden wenn der Treiber darauf wartet da der
Drucker bereit wird, auf
.IR arg .
Die Zahl sollte erhht werden falls das Drucken zu langsam ist und
erniedrigt werden, wenn das System zu stark belastet wird.  Der Standardwert
ist 1000.  Dies beeinflut nur den pollenden Treiber.
.TP
.BI "int ioctl(int " fd ", LPABORT, int " arg ")"
.RI "Falls " arg
0 ist, wird es der Druckertreiber bei Fehlern erneut
versuchen, ansonsten aufgeben.  Der Standardwert ist 0.
.TP
.BI "int ioctl(int " fd ", LPABORTOPEN, int " arg")"
.RI "Falls " arg " 0 ist, wird"
.BR open (2)
bei auftretenden Fehlern abgebrochen, ansonsten werden Fehler ignoriert.
Der default ist ignorieren.
.TP
.BI "int ioctl(int " fd ", LPCAREFUL, int " arg ")"
.RI "Falls " arg " 0 ist, mssen alle out-of-paper-, offline- und"
Fehlersignale bei allen Schreibzugriffen logisch falsch sein, ansonsten
werden sie ignoriert.  Standard ist es, sie zu ignorieren.
.TP
.BI "int ioctl(int " fd ", LPWAIT, int " arg ")"
Setzt die Anzahl von busy-wait Iterationen, die ausgefhrt werden, bevor
der strobe Impuls beginnt.  (Strobe signalisiert dem Drucker, da die
Daten am Datenport stabil anliegen und ein neues Zeichen enthalten.)  Es
werden ebenfalls
.I arg
Iterationen ausgefhrt, bevor der strobe
Impuls beendet wird.  Die Spezifikation gibt eine Impulslnge von 1 bis
500 Mikrosekunden vor.  Der Impuls darf frhestens eine Mikrosekunde
nach dem Anlegen der Daten gegeben werden, welche mit seinem Ende
bernommen werden, und die Daten mssen noch mindestens eine Mikrosekunde
nach dem Ende anliegen.  Der Default ist 0, es werden also keine
zustzlichen Verzgerungsschleifen ausgefhrt.  Die Erfahrung hat gezeigt, da
die verzgerung durch den code selbst ausreicht.  Dies gilt fr den 
Interruptgetriebenen wie fr den pollenden Treiber.  
.TP
.BI "int ioctl(int " fd ", LPSETIRQ, int " arg ")"
Dieser
.B ioctl()
bentigt superuser Privilegien. 
.I arg
gibt den neuen IRQ an, der Wert 0 schaltet interrupts ab und polling
ein, was auch default ist.  Als Seiteneffekt wird der Drucker dabei
zurckgesetzt.
.TP
.BI "int ioctl(int " fd ", LPGETIRQ, int *" arg ")"
Speichert den zur Zeit genutzten IRQ in
.IR arg .
.TP
.BI "int ioctl(int " fd ", LPGETSTATUS, int *" arg ")"
Speichert den Wert des status port in
.IR arg .
Die Bits haben folgende Bedeutung:
.sp
.TS
l l.
LP_PBUSY	invertierter busy Eingang, aktiv high
LP_PACK	unvernderter acknowledge Eingang, aktiv low
LP_POUTPA	unvernderter out-of-paper Eingang, aktiv high
LP_PSELECD	unvernderter selected Eingang, aktiv high
LP_PERRORP	unvernderter error Eingang, aktiv low
.TE
.sp
Siehe auch Dein Drucker Handbuch fr die Bedeutung der Signale.  Beachte
dabei, da auch undokumentierte Bits, in Abhngigkeit vom Drucker,
gesetzt werden knnen.
.TP
.BI "int ioctl(int " fd ", LPRESET)"
Setzt den Drucker zurck.  Ohne Argument.
.SH FILES
.I /dev/lp[0\-2]
.SH AUTOREN
Der Druckertreiber ist im Original von Jim Weigand und Linus Torvalds
geschrieben worden.  Michael K.\& Johnson hat ihn weiter verbessert.
Der Interrupt code stammt von Nigel Gamble.  Alan Cox modularisierte
ihn.  LPCAREFUL, LPABORT, LPGETSTATUS wurden von Chris Metcalf
hinzugefgt.
.SH "SIEHE AUCH"
.BR mknod (1),
.BR chown (1),
.BR chmod (1),
.BR tunelp (8),
.BR lpcntl (8).