POLLRCVD(8C)

👑 POLLRCVD — bestie edition

okay so this is the POLLRCVD page from section 8C of the HylaFAX manual, and it's literally about delivering faxes that showed up because somebody polled for them. sit down, grab a boba, we're doing this 💅

---

✨ NAME ✨

pollrcvd — the HylaFAX program that handles delivering a facsimile that got received by polling. that's it, that's the whole job description 🎀

---

🌸 SYNOPSIS 🌸

/var/spool/hylafax/bin/pollrcvd mailaddr faxfile devid commid error-msg

---

🦋 DESCRIPTION 🦋

so bin/pollrcvd is the program the HylaFAX server calls whenever a facsimile is received as a result of a polling operation. and here's the thing — it's designed to be customizable by the administrator. iconic, honestly.

(ideally you customize it the polite way: make your own customized pollrcvd program under a different filename, OR copy the default program to a different filename, customize that new file, and then use PollRcvdCmd in the modem config file to point faxgetty(8C) at your customized version. see hylafax-config(5F). that's the whole move 🫶)

the default program uses electronic mail to deliver the facsimile to the user who submitted the poll request. and the arguments are:

• mailaddr — the electronic mail address of the user that submitted the poll request 📧
• faxfile — the pathname of the received TIFF file, relative to the root of the spooling hierarchy
• commid — the communication identifier associated with the call (this one gets used to include a transcript when an error happens, so it's giving receipts 💀)
• devid — the modem device on which the document was received
• error-msg — an error message that is non-null if an error was encountered during the receive operation

---

💖 NOTES 💖

the default program delivers the facsimile as PostScript wrapped in MIME. yes bestie, wrapped. like a little present.

this program can be customized for the intended receipient. to do this, create a shell script etc/PollDispatch in the spooling area that sets:

• BCCTO — controls the blind copy recipient of the received fax notification. it's given as an e-mail address.
• CCTO — controls the copy recipient of the received fax notification. it's given as an e-mail address.
• LANG — controls the localization of the text of the received poll notification.
• FILETYPE — controls the filetype of the image attachment. current filetype options are ps, tif, and pdf. multiple values may be specified by separating them with whitespace. in that case a separate attachment is created for each filetype. so many attachments, so little time ✨

---

🎀 FILES 🎀

• /var/spool/hylafax — the spooling area
• /usr/bin/faxinfo — for printing information about the facsimile
• /usr/bin/fax2ps — for converting TIFF to PostScript
• /usr/bin/sendmail — for delivering mail

---

🌈 SEE ALSO 🌈

faxq(8C), hylafax-server(5F), recvq(5F)

go read those too, i'm not kidding, iykyk 📚

---

and that's a wrap on this one, bestie 💜 this little legend is dated May 12, 1996, and it comes to you from the HylaFAX crew. slay forever, no cap 👑