FAXSETUP(8)

💖 FAXSETUP 💖

okay bestie, so this is faxsetup from section 8 of the System Manager's Manual — the whole setup-a-machine-for-HylaFAX situation — and honestly? it's giving essential. periodt.

---

✨ NAME ✨

faxsetup — setup a machine for use with HylaFAX 🎀

---

🌸 SYNOPSIS 🌸

/usr/sbin/faxsetup [ -client ] [ -server ] [ -with-VAR[=value] ]

---

🦋 DESCRIPTION 🦋

so faxsetup is an interactive shell script — yes, interactive, she wants to talk to you — and what she does is all the necessary setup work to configure a client or a server machine for the HylaFAX software. 💅

and like, listen: faxsetup must be run on every HylaFAX server machine before the software will function. fr fr. if a HylaFAX server program or script gets invoked before faxsetup is run, the command will just abort with a message that says to run faxsetup. not me getting told to go run faxsetup 😭. and optionally? you can run faxsetup on a HylaFAX client machine too, to verify the configuration of the software. vibe check, basically. ✨

by default, faxsetup checks a machine for use both as a HylaFAX client and server. multitasking queen. 👑

---

🫶 Client-Specific Checks 🫶

• the installation of client programs and data
• the installation of the Adobe Font Metric (AFM) information files used by the HylaFAX text formatting support

---

💜 Server-Specific Checks 💜

• the installation of server programs and data
• the existence of the UUCP lock file directory
• the installation of the TIFF software tools
• the configuration of the getty programs invoked for data and voice calls
• the pathnames for various system programs used by server shell scripts
• proper support for FIFO special files
• proper installation of a POSTSCRIPT RIP
• definition of a ``fax'' user
• definitions for the hylafax'' and snpp'' services
• startup of the HylaFAX server processes: faxq(8) and hfaxd(8)
• definition of a ``FaxMaster'' mail alias for reporting server problems

---

and for server machines, faxsetup also creates two files that are required by the HylaFAX command scripts. one file contains master configuration parameters, and the other contains various definitions used by scripts such as faxaddmodem(8) that communicate with modems. two files, both iconic, no notes. 💅

---

🌈 OPTIONS 🌈

• -client — do client-specific consistency checks. just the client stuff, bestie.
• -server — do server-specific consistency checks. just the server stuff, bestie.
• -with-VAR[=value] — override the default definition for the configuration parameter named VAR; optionally specifying a new value (and if no value is specified then yes is used). this one is especially useful to override the default settings for the POSTSCRIPT interpreter package to use (e.g. -with-PS=dps), the spooling directory (-with-DIR_SPOOL=/mumble), the directory where the tool applications of TIFF software distribution are located (-with-TIFFBIN=/usr/freeware), etc. a complete list of the possible parameters can be found by looking at the contents of the faxsetup shell script; many of these configuration parameters are also described in the online documentation. iykyk 🔥
• -help — print a help message and terminate. she'll explain herself 💖
• -quiet — do not print verbose messages to the terminal. shhh 🤫
• -verbose — print informative messages to the terminal (default). the girl loves to chat 🎀

---

💀 BUGS 💀

okay so this is the part where we keep it real: faxsetup does not query a modem to find out its capabilities when invoking the faxmodem program to setup a server in a send-only configuration; it may be necessary to run faxmodem manually. so like… yeah. 🙈

---

🍓 FILES 🍓

• /var/spool/hylafax/etc/setup.cache — master configuration parameters
• /var/spool/hylafax/etc/setup.modem — modem-related configuration support

consult hylafax-server(5) for a complete discussion of the structure and content of the spooling area. it's the deep lore bestie, go read it 📚

---

⭐ SEE ALSO ⭐

hylafax-server(5), hylafax-config(5), faxq(8), faxgetty(8), faxmodem(8), faxconfig(8), faxsend(8)

---

lowkey a whole ecosystem. go read the friends. 🫶

---

and that's the whole page, bestie — this one came from the System Manager's Manual, dated August 26, 1996, and it's literally the very first FAXSETUP(8) energy we've got. slay, fax era. 💅💖✨