FAXCONFIG(8)

💖 FAXCONFIG — the faxconfig(8) glow-up 💖

okay bestie, listen up — this is the System Manager's Manual page for faxconfig(8), and honestly? it's giving "tiny command, huge main character energy." let's get into it 🎀

---

✨ NAME ✨

faxconfig — dynamically change HylaFAX configuration parameters 💅

---

🦋 SYNOPSIS 🦋

/usr/sbin/faxconfig [ -q queue-dir ] [ -m modem ] [ parameter value  ...
]

yes the bracket spacing is weird. no we are not fixing it. it's iconic.

---

🌸 DESCRIPTION 🌸

so basically, faxconfig sends messages to a HylaFAX server process telling it to install new values for one or more configuration parameters. it's like sliding into the server's DMs and being like "hey babe, new value just dropped" 💌

BUT — and this is the part that matters — these new values are maintained only for as long as that server process executes. they are not forever. to set up long-lasting configuration parameters, you have to edit the appropriate configuration file(s) instead (peep hylafax-config(5) 👀).

faxconfig is especially useful for setting certain configuration parameters that control the operation of HylaFAX server processes. for example? by manipulating the ModemPriority parameter of one or more faxgetty(8) processes, it is easy to dynamically reconfigure the order in which HylaFAX will assign modems to outbound jobs. slay. 🔥

if no modem is specified with the -m option, then faxconfig will send messages to the central scheduler process, faxq(8). 🫶

if a faxgetty process is to be contacted, the specified modem must be the last component of the character special device filename the modem is attached to. iykyk 🧚

consult hylafax-config(5) for the list of configuration parameters that can be set with faxconfig. no cap, go read it.

---

✨ OPTIONS ✨

the following options are available:

• -m devid — direct messages to the faxgetty process servicing devid instead of the central scheduler process, faxq. the devid is an identifier derived from the name of the modem's device file; for example ttym2 for /dev/ttym2, term_10 for /dev/term/10. 📟
• -q dir — use a spooling area other than /var/spool/hylafax. 🗂️

---

🎀 FILES 🎀

• /var/spool/hylafax — default spooling area
• /var/spool/hylafax/FIFO — fifo for contacting faxq

consult hylafax-server(5) for a complete discussion of the structure and content of the spooling area. it's a whole vibe, truly.

---

🌈 SEE ALSO 🌈

hylafax-server(5), faxmodem(8), faxstate(8), faxgetty(8), faxq(8), hylafax-config(5).

---

and that's the whole page bestie!! 🫶✨

this little baddie came out on Oct 3, 1995 as part of the System Manager's Manual (source/version: that's the one, that's the era) — so yeah, faxconfig(8) has been serving since before most of us could walk, and it's still out here dynamically changing parameters. legacy behavior honestly 👑