> Linux Reviews > man >

lp

wysy�a ��dania do us�ugi druku LPRng

lp.1.man
lp.4.man

1. lp.1.man

Manpage of LP

LP

Section: User Commands (1)
Updated: LPRng-3.6.13
Index Return to Main Contents

NAZWA

lp - wysy�a ��dania do us�ugi druku LPRng

SK�ADNIA

lp: [-A] [-c] [-m] [-p] [-s] [-w] [-d dest]
[-f form-name [-d cokolwiek]] [-H special-handling]
[-n number] [-o option] [-P page-list]
[-q priority-level] [-S character-set [-d cokolwiek]]
[-S print-wheel] [-t title] [-T content-type [-r]]
[-y mode-list] [-D debug-options] [file...]

OPIS

Gdy nale��cy do LPRng klient lpr zostanie wywo�any pod nazw� lp, to obs�uguje interfejs lp. Zwykle robi si� to tworz�c dowi�zanie symboliczne o nazwie lp do programu lpr. Jest to podobne do zachowania program�w ex(1) i vi(1). Obs�ugiwana posta� polecenia lp organizuje wydruk wskazanego pliku(�w) file i skojarzonej z nim informacji (��cznie zwanych ��daniem, request). Je�eli w wierszu polece� nie podano �adnego pliku, to przyjmowane jest standardowe wej�cie. Mo�na te� w wierszu polece� poda� standardowe wej�cie razem ze wskazaniem pliku(�w) wymieniaj�c nazwy plik�w i podaj�c - (my�lnik) dla standardowego wej�cia. Pliki zostan� wydrukowane w kolejno�ci, w jakiej wyst�pi�y w wierszu polece�.

Us�uga drukowania LP z ka�dym ��daniem kojarzy unikalny identyfikator ��dania (request-ID) i wy�wietla go na standardowym wyj�ciu. Fragmentu b�d�cego numerem ��dania lub pe�nego ID-��dania mo�na u�y� p�niej jako argumentu dla cancel(1) lub lprm(1) przy anulowaniu zadania lub przy okre�laniu jego stanu. W podr�cznikach systemowych cancel(1) i lprm(1) zawarto szczeg�y dotycz�ce anulowania zada�, za� w lpstat(1) i lpq(1) informacje o sprawdzaniu stanu ��dania druku.

OPCJE

Opcje lp zawsze poprzedzaj� ewentualne nazwy plik�w, ale mog� by� podane w dowolnej kolejno�ci. Dost�pne s� poni�sze opcje:

-A

U�ywa uwierzytelnianego przesy�ania. Zauwa�, �e nie jest to standardowa opcja lp(1), lecz zosta�a dodana w celu utrzymania zgodno�ci z LPRng.

-c

Tworzy kopi� pliku file przed jego drukowaniem. (Nie ma to �adnego skutku, gdy� LPRng zawsze wysy�a zadania bezzw�ocznie na serwer zdalny, gdzie b�d� drukowane.)

-d dest

Wybiera dest jako drukark� lub klas� drukarek, kt�re maj� wykona� wydruk. Domy�lnie, dest pobierane jest ze zmiennej �rodowiska LPDEST (je�li jest ona ustawiona), a nast�pnie z PRINTER . W przeciwnym wypadku u�ywane jest (je�li istnieje) domy�lne miejsce docelowe w danym systemie komputerowym.

-f form-name

Drukuje ��danie na formularzu o nazwie form-name. Pierwsza litera form-name stosowana jest jako format filtru LPRng. Jest to zbli�one do opcji -F polecenia lpr.

-H special-handling

Te opcje s� ignorowane.

-m

Po wydrukowaniu plik�w wysy�a wiadomo�� pocztow� do u�ytkownika (zobacz mail(1)). Adres pocztowy pobierany jest ze zmiennej �rodowiska USER. Domy�lnie, po normalnym zako�czeniu wydruku ��dania nie jest wysy�ana �adna poczta.

-n number

Drukuje okre�lon� przez number liczb� kopii (domy�lnie jest to 1).

-o option

Okre�la opcje zale�ne do drukarki. Kilka takich opcji mo�na po��czy� podaj�c liter� kluczow� -o wielokrotnie (-o $opcja sub 1$ -o $opcja sub 2$ ... -o $opcja sub n$), lub podaj�c po literze -o list� opcji uj�t� w cudzys�owy (to jest, -o "$opcja sub 1$ $opcja sub 2$ ... $opcja sub n$"). Poni�sze opcje maj� efekt natychmiastowy; inne opcje przesy�ane s� jako pozycja Z wiersza pliku steruj�cego, tj. jako opcja -Z polecenia lpr(1).

nobanner: Nie drukuje nstony tytu�owej przy tym ��daniu. Jest to to samo, co opcja -h (no header) polecenia lpr(1).
width=number: Drukuje to ��danie z szeroko�ci� strony ustawion� na number kolumn. Jest to to samo, co opcja -w width polecenia lpr(1).

-P page-list

Drukuje strony uj�te na li�cie page-list. Ta opcja jest ignorowana.

-p

W��cza powiadamianie o zako�czeniu wydruku ��dania. Ta opcja jest ignorowana.

-q priority-level

Przypisuje temu ��daniu poziom priorytetu priority-level w kolejce druku. Poziomu priorytetu jest liczb� z zakresu od 0, najwy�szy priorytet, do 25, najni�szy. Je�eli nie podano priorytetu, to stosowany jest domy�lny priorytet dla us�ugi druku, przypisany przez administratora systemu. Administrator mo�e ustali� limit priorytetu dla konkretnych u�ytkownik�w. Warto�ci liczbowe s� przek�adane na odpowiadaj�ce im literowe warto�ci priorytetu.

-s

Eliminuje komunikaty od lp, jak te rozpoczynaj�ce si� od "request id is...".

-S character-set

-S print-wheel

Drukuje to ��danie u�ywaj�c podanego zestawu znak�w character-set lub g�owicy print-wheel (w drukarkach rozetkowych). Opcje te s� przekazywane jako opcja -Z polecenia lpr(1).

-t title

Drukuje tytu� title na stronie tytu�owej wyj�cia. Je�eli nie podano tytu�u, to na stronie tytu�owej drukowana jest nazwa pliku. Je�eli tytu� zawiera odst�py, to nale�y umie�ci� go w cudzys�owach.

-T content-type [-r]

Drukuje ��danie na drukarce potrafi�cej obs�ugiwa� podany typ zawarto�ci content-type. Typ zawarto�ci jest przekazywany jako opcja -Z polecenia lpr(1).

-w

Wypisuje komunikat na terminalu u�ytkownika po wydrukowaniu zadanych plik�w. Ta opcja jest ignorowana.

-y mode-list

Drukuje to ��danie zgodnie z trybami druku wyszczeg�lnionymi w mode-list. Podana lista tryb�w jest przekazywana jako opcja -Z polecenia lpr(1).

-D debug-options

Podaje list� opcji diagnostycznych programu. Mo�e to by� liczba (poziom debuggowania) lub s�owo kluczowe i poziom (flaga), jak 9, network, network+2 itp.

OPERANDY

lp obs�uguje nast�puj�ce operandy:

file: Nazwa pliku, jaki ma zosta� wydrukowany. Je�eli nie podano �adnych nazw plik�w, lub gdy nazw� jest -, to u�ywane b�dzie standardowe wej�cie. Argument - musi by� ostatnim na li�cie.

�RODOWISKO

Zobacz w podr�czniku systemowym environ(5), opisy poni�szych zmiennych �rodowiska wp�ywaj�cych na wykonanie lp i cancel:

LPDEST: Okre�la urz�dzenie wyj�ciowe lub miejsce przeznaczenia. LPDEST nie jest ustawiona, to zastosowana zostanie zmienna PRINTER. Opcja -P dest ma pierwsze�stwo nad LPDEST. Je�eli nie podano -P a LPDEST zawiera warto�� nie b�d�c� poprawnym urz�dzeniem lub nazw� okre�laj�c� miejsce przeznaczenia, to wyniki b�d� niezdefiniowane.
PRINTER: Okre�la urz�dzenie wyj�ciowe lub miejsce przeznaczenia. Je�eli nie ustawiono LPDEST ani PRINTER, to stosowane jest nieokre�lone urz�dzenie wyj�ciowe. Opcja -P dest i zmienna �rodowiska LPDEST maj� pierwsze�stwo nad PRINTER. Je�eli nie podano -P, LPDEST nie jest ustawione, za� PRINTER zawiera warto�� nie b�d�c� poprawnym urz�dzeniem lub nazw� okre�laj�c� miejsce przeznaczenia, to wyniki b�d� niezdefiniowane.

KOD ZAKO�CZENIA

lp zwraca nast�puj�ce kody zako�czenia:

0: Wszystkie pliki wej�ciowe przetworzono pomy�lnie.
>0: Nie by�o dost�pne �adne urz�dzenie wyj�ciowe lub wyst�pi� b��d.

ZOBACZ TAK�E

lpd.conf(5), lpc(8), lpd(8), lpr(1), lpq(1), lprm(1), printcap(5), lpd.perms(5), pr(1).

DIAGNOSTYKA

Wi�kszo�� komunikat�w diagnostycznych jest oczywista. Je�li dok�adny pow�d niepowodzenia pozostaje niejasny, nale�y w��czy� poziom debugowania (-D5) i uruchomi� ponownie. Informacja diagnostyczna pomo�e uchwyci� dok�adn� przyczyn�.

HISTORIA

LPRng jest rozszerzonym systemem buforowania wydruku o funkcjonalno�ci podobnej do oprogramowania Berkeley LPR. List� dyskusyjn� o LPRng jest lprng@lprng.com; subskrypcja przez wys�anie listu do lprng-request@lprng.com ze s�owem `subscribe` w tre�ci. Oprogramowanie to jest dost�pne z ftp://ftp.astart.com/pub/LPRng.

AUTOR

Patrick Powell <papowell@astart.com>.

This document was created by man2html using the manual pages.
Time: 00:24:59 GMT, November 20, 2008

2. lp.4.man

Manpage of LP

LP

Section: Pliki specjalne (4)
Updated: 1995-01-15
Index Return to Main Contents

NAZWA

lp - urz�dzenia drukarek wierszowych

SK�ADNIA

#include <linux/lp.h>

KONFIGURACJA

Pliki lp[0-2] s� urz�dzeniami znakowymi obs�uguj�cymi drukarki do��czone do port�w r�wnoleg�ych; numer g��wny tych urz�dze� jest r�wny 6, numer podrz�dny 0-2. Numery podrz�dne odpowiadaj� adresom portu r�wnoleg�ego kolejno 0x03bc, 0x0378 and 0x0278. Zwykle prawa dost�pu do plik�w tych urz�dze� wynosz� 220 i nale�� do u�ytkownika root i grupy lp. Porty r�wnoleg�e mog� by� obs�ugiwane zar�wno przy wykorzystaniu pr�bkowania, jak i przerwa�. Stosowanie przerwa� jest zalecane gdy spodziewamy si� du�ego ruchu, np. wynikaj�cego z u�ywania drukarki laserowej. W przypadku zwyk�ych drukarek mozaikowych wystarczaj�ce jest pr�bkowanie. Standardowym trybem obs�ugi portu jest pr�bkowanie.

OPIS

Urz�dzenia lp obs�uguj� nast�puj�ce wywo�ania funkcji ioctl(2):

int ioctl(int fd, LPTIME, int arg)

Ustawia okres przez jaki sterownik jest u�piony, zanim powt�rnie sprawdzi stan drukarki w sytuacji, gdy bufor drukarki zdaje si� by� wype�nionym do arg. Je�li posiadamy szybk� drukark� mo�emy zmniejszy� ten parametr. Je�li drukarka jest wolna, nale�y zwi�kszy� ten parametr. Jest to liczba okre�laj�ca czas w setnych cz�ciach sekundy, warto�� domy�lna wynosi 2, co oznacza 0,02 s. Parametr ten ma wp�yw jedynie w trybie pr�bkowania.

int ioctl(int fd, LPCHAR, int arg)

Ustawia maksymaln� liczb� iteracji aktywnego oczekiwania (busy-wait), jakie wykonuje sterownik pr�bkuj�cy czekaj�c a� drukarka b�dzie gotowa na otrzymywanie znak�w do arg. Je�li drukowanie odbywa si� zbyt wolno nale�y zwi�kszy� t� liczb�; je�li system za bardzo zwalnia - nale�y j� zmniejszy�. Standardow� warto�ci� tego parametru jest 1000. Parametr ma wp�yw na sterownik jedynie w trybie pr�bkowania.

int ioctl(int fd, LPABORT, int arg)

Je�li parametr arg jest r�wny 0, wtedy sterownik drukarki b�dzie powtarza� operacj� po wyst�pieniu b��du; w przeciwmym wypadku przerwie w dzia�anie. Standardow� warto�ci� tego parametru jest 0.

int ioctl(int fd, LPABORTOPEN, int arg)

Je�li arg jest r�wny 0, funkcja open(2) zostanie przerwana po wyst�pieniu b��du; w przeciwnym wypadku b��d zostanie zignorowany. Standardowe zachowanie polega na ignorowaniu b��d�w.

int ioctl(int fd, LPCAREFUL, int arg)

Je�li arg jest r�wny 0, wtedy wymaga si� aby sygna�y out-of-paper, offline oraz sygna�y b��d�w by�y puste (false) we wszystkich operacjach zapisu, w przeciwnym wypadku s� ignorowane. Ustawienie standardowe polega na ignorowaniu b��d�w.

int ioctl(int fd, LPWAIT, int arg)

Ustawia na arg liczb� iteracji aktywnego oczekiwania (busy-wait) przed spr�bkowaniem, czy drukarka zaakceptowa�a w�a�nie zapisany znak oraz liczb� iteracji, kt�re nale�y przeczeka� przed kolejnym pr�bkowaniem. Specyfikacje okre�laj� ten czas jako 0.5 mikrosekundy, lecz do�wiadczenie wykaza�o, �e op�nienie spowodowane wykonaniem kodu jest ju� wystarczaj�ce. Z tego powodu warto�ci� domy�ln� dla tego ustawienia jest 0. Jest ono wykorzystywane w sterowniku zar�wno w trybie pr�bkowania, jak i w trybie przerwa�.

int ioctl(int fd, LPSETIRQ, int arg)

To wywo�anie funkcji ioctl() wymaga uprawnie� administratora. Funkcja pobiera argument typu int zawieraj�cy nowe przerwanie IRQ. Skutekiem ubocznym jest inicjalizacja drukarki. Gdy arg jest zerem, to stosowany b�dzie sterownik z pr�bkowaniem; jest to r�wnocze�nie zachowanie domy�lne.

int ioctl(int fd, LPGETIRQ, int *arg)

Zachowuje w parametrze arg aktualnie stosowane przerwanie IRQ.

int ioctl(int fd, LPGETSTATUS, int *arg)

Zachowuje warto�� stanu portu w zmiennej arg. Poszczeg�lne bity maj� nast�puj�ce znazenie:

LP_PBUSY	odwr�cony sygna� zaj�to�ci, aktywny w stanie wysokim
LP_PACK	niezmienione potwierdzenie wej�cia, aktywny w stanie
	niskim
LP_POUTPA	niezmieniony sygnal braku papieru, aktywny
	w stanie wysokim
LP_PSELECD	niezmieniony sygna� wyboru, aktywny w stanie wysokim
LP_PERRORP	niezmieniony sygna� b��du, aktywny w stanie niskim

Znaczenia sygna��w nale�y szuka� w dokumentacji drukarki. Nale�y pami�ta�, �e dla niekt�rych drukarek ustawiane mog� by� te� nieudokumentowane tu bity.

int ioctl(int fd, LPRESET)

Inicjalizuje drukark�. Nie stosuje si� �adnych parametr�w.

PLIKI

/dev/lp*

AUTORZY

Sterownik drukarki zosta� napisany przez Jima Weiganda i Linusa Torvaldsa. P�niej zosta� on ulepszony przez Michaela K. Johnsona. Oprogramowanie przerwa� wykona� Nigel Gamble. Zmodularyzowa� go Alan Cox. LPCAREFUL, LPABORT, LPGETSTATUS doda� Chris Metcalf.

ZOBACZ TAK�E

mknod(1), chown(1), chmod(1), tunelp(8), lpcntl(8)

Index

NAZWA
SK�ADNIA
KONFIGURACJA
OPIS
PLIKI
AUTORZY
ZOBACZ TAK�E

This document was created by man2html using the manual pages.
Time: 00:25:00 GMT, November 20, 2008