Page MenuHomeFreeBSD

Clarify lpd(8) for when printcap(5) is read
Needs ReviewPublic

Authored by felix.the.red_gmail.com on Jun 25 2025, 2:38 AM.
Tags
None
Referenced Files
F133012389: D51032.id157566.diff
Wed, Oct 22, 1:36 AM
F133012328: D51032.id.diff
Wed, Oct 22, 1:35 AM
F133012324: D51032.id157619.diff
Wed, Oct 22, 1:35 AM
Unknown Object (File)
Tue, Oct 21, 2:00 PM
Unknown Object (File)
Sat, Oct 18, 2:59 AM
Unknown Object (File)
Mon, Sep 29, 10:54 AM
Unknown Object (File)
Sep 14 2025, 5:22 AM
Unknown Object (File)
Sep 14 2025, 2:46 AM
Subscribers

Details

Reviewers
None
Group Reviewers
manpages
Summary

Document the three conditions for printcap(5) to be read.

  • On daemon startup
  • When a new print job is received
  • When receiving a queue control command (lpc disable, enable, stop, etc.)

From the original PR:
It appears to be the case that the print spooler, lpd, re-reads
the /etc/printcap file when changes to that file are made.
This important operational fact is not documented in the lpd(8) man page.

Please revise lpd(8) so as to specify ALL of the times and/or
conditions which will cause lpr to process or reprocess the
current contents of the current /etc/printcap file.

PR:238407

Test Plan

mandoc -Tlint

Diff Detail

Repository
rG FreeBSD src repository
Lint
Lint Skipped
Unit
Tests Skipped

Event Timeline

usr.sbin/lpr/lpd/lpd.8
319

New sentence, new line.

usr.sbin/lpr/lpd/lpd.8
319

Do we have to restate this in FILES? The files tables are usually kept terse, with descriptions in DESCRIPTION. This information is mostly above, and I think that is a better place for it.

Move printcap(5) read information from FILES to DESCRIPTION.