.\" Copyright (c) 1983, 1991 Regents of the University of California.
.\" All rights reserved.
.\"
.\" Traduzione in italiano di Giordano Neri <neri@cli.di.unipi.it>
.\" Marzo 1999.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\" 3. All advertising materials mentioning features or use of this software
.\"    must display the following acknowledgement:
.\"	This product includes software developed by the University of
.\"	California, Berkeley and its contributors.
.\" 4. Neither the name of the University nor the names of its contributors
.\"    may be used to endorse or promote products derived from this software
.\"    without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\"     @(#)printcap.5	6.6 (Berkeley) 5/10/91
.\"
.Dd 10 maggio 1991
.Dt PRINTCAP 5
.Os BSD 4.2
.Sh NOME
.Nm printcap
.Nd database delle capacit delle stampanti
.Sh SINTASSI
.Nm printcap
.Sh DESCRIZIONE
La funzione
.Nm Printcap
 una versione semplificata del database
.Xr termcap 5
usato per descrivere le stampanti. Il sistema di spooling accede al file
.Nm printcap
ogni volta che viene usato, permettendo l'inserimento e l'eliminazione
dinamica di stampanti. Ogni voce nel database  usata per descrivere
una stampante. Questo database non pu essere sostituito, come avviene per 
.Xr termcap ,
perch permetterebbe di sfuggire alla registrazione contabile.
.Pp
La stampante predefinita  normalmente
.Em lp ,
ma la variabile di ambiente
.Ev PRINTER
pu essere usata per modificarla. Ogni utilit di spooling supporta un'opzione,
.Fl P Ar stampante ,
che permette di nominare esplicitamente una stampante di destinazione.
.Pp
Fate riferimento al
.%T "4.3 BSD Line Printer Spooler Manual"
per una trattazione completa su come configurare il database per una
data stampante.
.Sh CAPACIT
Fate riferimento a
.Xr termcap 5
per una descrizione del formato del file.
.Bl -column Nomexxx Tipoxx "/var/spool/lpdxxxxx"
.Sy Nome	Tipo	Descrizione
.It "af	str" Ta Dv NULL Ta No "nome del file di registrazione contabile"
.It "br	num	none	se lp  un tty, imposta il baud rate"
.Pf "(chiamando " Xr ioctl 2 )
.It "cf	str" Ta Dv NULL Ta No "filtro dati da cifplot"
.It "df	str" Ta Dv NULL Ta No "filtro dati da tex"
.Pf ( Tn DVI
format)
.It "fc	num	0	se lp  un tty, pulisce i flag bit"
.Pq Pa sgtty.h
.It "ff	str" Ta So Li \ef Sc Ta No "stringa da inviare per il form feed"
.It "fo	bool	false	invia un form feed quando il dispositivo viene aperto"
.It "fs	num	0	come `fc' ma imposta i bit"
.It "gf	str" Ta Dv NULL Ta No "filtro per dati grafici formato"
.Pf ( Xr plot 3 )
.It "hl	bool	false	stampa la pagina di intestazione per ultima"
.It "ic	bool	false	driver di supporto ioctl (non standard) per indentare le stampe"
.It "if	str" Ta Dv NULL Ta No "nome del filtro di testo che si occupa della registrazione contabile "
.It "lf	str" Ta Pa /dev/console Ta No "nome del file di log"
.It "lo	str" Ta Pa lock Ta No "nome del file di lock"
.It "lp	str" Ta Pa /dev/lp Ta No "nome del dispositivo da aprire per l'output"
.It "mx	num	1000	dimensione massima dei file (in"
.Dv BUFSIZ
blocchi), zero = illimitata
.It "nd	str" Ta Dv NULL Ta No "prossima directory per la lista delle code (non implementato)"
.It "nf	str" Ta Dv NULL Ta No "filtro dati da ditroff (device independent troff)"
.It "of	str" Ta Dv NULL Ta No "nome del programma che filtra l'output"
.It "pc	num	200	prezzo per piedi o pagine in centinaia di centesimi"
.It "pl	num	66	lunghezza di pagina (in linee)"
.It "pw	num	132	larghezza di pagina (in caratteri)"
.It "px	num	0	larghezza di pagina in pixel (orizzontali)"
.It "py	num	0	lunghezza di pagina in pixel (verticali)"
.It "rf	str" Ta Dv NULL Ta No "filtro per stampare file di testo in stile"
.Tn FORTRAN
.It "rg	str" Ta Dv NULL Ta No "gruppo ristretto. Solo i membri del gruppo sono autorizzati"
.It "rm	str" Ta Dv NULL Ta No "nome della macchina per stampe remote"
.It "rp	str	``lp''	argomento nome della stampante remota"
.It "rs	bool	false	restringe gli utenti remoti a quelli con account locale"
.It "rw	bool	false	apre il dispositivo di stampa in lettura/scrittura"
.It "sb	bool	false	piccolo banner (una sola riga)"
.It "sc	bool	false	evita le copie multiple"
.It "sd	str" Ta Pa /var/spool/lpd Ta No "directory di spool"
.It "sf	bool	false	evita i form feed"
.It "sh	bool	false	evita la stampa della pagina di intestazione"
.It "st	str" Ta Pa stato Ta No "nome del file di stato"
.It "tf	str" Ta Dv NULL Ta No "filtro dati da troff (cat phototypesetter)"
.It "tr	str" Ta Dv NULL Ta No "stringa da stampare quando la coda si svuota"
.It "vf	str" Ta Dv NULL Ta No "filtro per immagini raster"
.El
.Pp
Se il driver locale della stampante supporta l'indentazione, il demone 
deve sapere come invocarla.
.Sh FILTRI
Il demone
.Xr lpd 8
crea una pipeline di
.Em filtri
per processare file per vari tipi di stampanti.
I filtri selezionati dipendono dai flag passati a
.Xr lpr 1 .
L'impostazione della pipeline  :
.Bd -literal -offset indent
p	pr | se	testo normale + pr(1)
none	if	testo normale
c	cf	cifplot
d	df	DVI (tex)
g	gf	plot(3)
n	nf	ditroff
f	rf	Fortran
t	tf	troff
v	vf	immagine raster
.Ed
.Pp
Il filtro
.Sy if
viene invocato con questi argomenti:
.Bd -filled -offset indent
.Cm if
.Op Fl c
.Fl w Ns Ar larghezza
.Fl l Ns Ar lunghezza
.Fl i Ns Ar indentazione
.Fl n Ar login
.Fl h Ar host file-di-registrazione-contabile
.Ed
.Pp
Il flag
.Fl c
viene passato solo se  stato specificato il flag
.Fl l
(passa i caratteri di controllo alla lettera) a
.Xr lpr .
.Ar Larghezza
e
.Ar lunghezza
specificano la larghezza e la lunghezza della pagina
(da
.Cm pw
e
.Cm pl
rispettivamente) in caratteri.
I parametri 
.Fl n
e
.Fl h
specificano rispettivamente il nome di login e il nome dell'host del
proprietario del job.
Il parametro
.Ar file-di-registrazione-contabile
viene passato dalla voce 
.Cm af
di
.Nm printcap .
.Pp
Se non viene specificato
.Cm if
, al suo posto viene usato
.Cm of
, con la differenza che
.Cm of
 aperto solo una volta,
mentre
.Cm if
 aperto da ogni singolo job.
Quindi
.Cm if
 meglio indicato per gestire la contabilit.
A
.Cm of
sono passati solo i flag
.Ar larghezza
e
.Ar lunghezza.
.Pp
Tutti gli altri filtri sono chiamati come :
.Bd -filled -offset indent
.Nm filtro
.Fl x Ns Ar larghezza
.Fl y Ns Ar lunghezza
.Fl n Ar login
.Fl h Ar host file-di-registrazione-contabile
.Ed
.Pp
dove
.Ar larghezza
e
.Ar lunghezza
sono rappresentati in pixel,
specificati rispettivamente dalle voci
.Cm px
e
.Cm py .
.Pp
Tutti i filtri prendono
.Em stdin
come file,
.Em stdout
come stampante,
possono inviare il log a
.Em stderr
o usare 
.Xr syslog 3
e non devono ignorare
.Dv SIGINT . 
.Sh MESSAGGI DI LOG
I messaggi di errore generati direttamente dai programmi di gestione della
stampante (che sono i programmi
.Xr lp Ns *) sono gestiti da
.Xr syslog 3
usando la facility
.Dv LPR .
I messaggi inviati a
.Em stderr
da uno dei filtri
sono spediti al corrispondente file
.Cm lf .
I filtri possono, certamente, usare loro stessi
.Xr syslog .
.Pp
I messaggi di errore inviati alla console hanno un ritorno di carrello e
un ritorno di linea aggiunti in fondo, al posto del solo ritorno di linea.
.Sh VEDERE ANCHE
.Xr termcap 5 ,
.Xr lpc 8 ,
.Xr lpd 8 ,
.Xr pac 8 ,
.Xr lpr 1 ,
.Xr lpq 1 ,
.Xr lprm 1 .
.Rs
.Re
.Sh STORIA
Il formato del file
.Nm
 apparso in
.Bx 4.2 .