[unix-history] / usr / man / man8 / lpd.8

.TH LPD 8 
.SH NAME
lpd \- line printer daemon
.SH SYNOPSIS
.B /etc/lpd
.SH DESCRIPTION
.I Lpd
is the daemon for the line printer.
.I Lpd
uses the directory
.I /usr/lpd.
The file
.I lock
in that directory is used
to prevent two daemons from becoming active.
After the program has successfully set the lock,
it forks and the main path exits, thus
spawning the daemon.
The directory is scanned for files
beginning with
.B df.
Each such file is submitted as a job.
Each line of a job file must begin with a key
character to specify what to do with the remainder
of the line.
.TP 5
.B  L
specifies that the remainder of the line is to
be sent as a literal.
.TP 5
.B  B
specifies that the rest of the line
is a file name.
.TP 5
.B  F
is the same as
.B B
except a form feed is prepended to the file.
.TP 5
.B  U
specifies that the rest of the line
is a file name.
After the job has been transmitted,
the file is unlinked.
.TP 5
.B  M
is followed by a user ID; after the job is sent,
a message is
mailed to the user via the
.I mail(1)
command
to verify the sending of the job.
.PP
Any error encountered will cause the daemon to
wait 1 minute
and start over.
This means that an improperly constructed
.I df
file may cause the same job to be submitted
every 20 minutes.
.PP
.I Lpd
is automatically initiated by the line printer command,
.I lpr.
.PP
.PP
To restart
.I lpd
(in the case of hardware or software malfunction),
it is necessary to first kill the old
daemon
(if still alive),
and remove the lock file
before initiating
the new daemon.
This is done automatically when the system is brought up,
by
.I /etc/rc,
in case there were any jobs left in the spooling directory
when the system last went down.
.SH FILES
/usr/lpd/*
spool area for line printer daemon
.br
/etc/passwd
to get the user's name
.br
/dev/lp
line printer device
.sh "SEE ALSO"
lpr(1)
Commit	Line	Data
6abb708f TL	1	.TH LPD 8
	2	.SH NAME
	3	lpd \- line printer daemon
	4	.SH SYNOPSIS
	5	.B /etc/lpd
	6	.SH DESCRIPTION
	7	.I Lpd
	8	is the daemon for the line printer.
	9	.I Lpd
	10	uses the directory
	11	.I /usr/lpd.
	12	The file
	13	.I lock
	14	in that directory is used
	15	to prevent two daemons from becoming active.
	16	After the program has successfully set the lock,
	17	it forks and the main path exits, thus
	18	spawning the daemon.
	19	The directory is scanned for files
	20	beginning with
	21	.B df.
	22	Each such file is submitted as a job.
	23	Each line of a job file must begin with a key
	24	character to specify what to do with the remainder
	25	of the line.
	26	.TP 5
	27	.B L
	28	specifies that the remainder of the line is to
	29	be sent as a literal.
	30	.TP 5
	31	.B B
	32	specifies that the rest of the line
	33	is a file name.
	34	.TP 5
	35	.B F
	36	is the same as
	37	.B B
	38	except a form feed is prepended to the file.
	39	.TP 5
	40	.B U
	41	specifies that the rest of the line
	42	is a file name.
	43	After the job has been transmitted,
	44	the file is unlinked.
	45	.TP 5
	46	.B M
	47	is followed by a user ID; after the job is sent,
	48	a message is
	49	mailed to the user via the
	50	.I mail(1)
	51	command
	52	to verify the sending of the job.
	53	.PP
	54	Any error encountered will cause the daemon to
	55	wait 1 minute
	56	and start over.
	57	This means that an improperly constructed
	58	.I df
	59	file may cause the same job to be submitted
	60	every 20 minutes.
	61	.PP
	62	.I Lpd
	63	is automatically initiated by the line printer command,
	64	.I lpr.
65	.PP
66	.PP
67	To restart
68	.I lpd
69	(in the case of hardware or software malfunction),
70	it is necessary to first kill the old
71	daemon
72	(if still alive),
73	and remove the lock file
74	before initiating
75	the new daemon.
76	This is done automatically when the system is brought up,
77	by
78	.I /etc/rc,
79	in case there were any jobs left in the spooling directory
80	when the system last went down.
81	.SH FILES
82	/usr/lpd/*
83	spool area for line printer daemon
84	.br
85	/etc/passwd
86	to get the user's name
87	.br
88	/dev/lp
89	line printer device
90	.sh "SEE ALSO"
91	lpr(1)