FAXINFO(8C)

💖 NAME 💖

okay bestie, meet faxinfo — she prints information about a received facsimile. that's it, that's her whole job, and she does it flawlessly. no cap. 🎀

---

✨ SYNOPSIS ✨

three whole moods, pick your fighter.

Basic usage

/usr/bin/faxinfo [ -b ] [ -n ] [ -D ] file.tif [ file2.tif [...] ]

Formatting shortcuts

/usr/bin/faxinfo [ -C delim | -c delim | -r ] file.tif [ file2.tif [...]
]

Raw formatting

/usr/bin/faxinfo [ -S fmt ] [ -s fmt ] [ -e fmt ] [ -E fmt ] file.tif [
file2.tif [...] ]

---

🌸 DESCRIPTION 🌸

so faxinfo prints descriptive info to standard output about a received facsimile file. like, it just tells you things. for example:

/var/spool/hylafax/recvq/fax00017.tif:
    Sender: +14159657824
     Pages: 3
   Quality: Normal
      Page: North American Letter
  Received: 1996:01:19 13:51:02
TimeToRecv: 0:39
SignalRate: 14400 bit/s
DataFormat: 2-D MR
ErrCorrect: No
   CallID1: 4159657824
   CallID2: 1000

this info is typically included in the notification mail that the faxrcvd(8C) script generates when a facsimile is received by HylaFAX. she's not just printing for fun, she's feeding the whole notification pipeline. iconic behavior honestly. 💅

• -n — suppresses the printing of the filename. gone. not invited. 🙈
• -b — strips any leading directory of the filename before printing. just the file, no path drama. ✂️
• -D — prints the actual print strings being used, for debug purposes. main character energy for when you need to see behind the curtain. 🔍

---

🎀 Formatting shortcuts 🎀

• -C delim — sets the format to a quoted CSV. it's a shortcut to -S '"%s"' -s ',"' -e '"' -E '\n' 🦋
• -c delim — sets the format to a CSV. shortcut to: -S '%s' -s ',' -e '' -E '\n' ⭐
• -r — sets the format to raw values. shortcut to: -S '' -s '' -e '0 -E '' 🔥

---

🌈 Raw formatting 🌈

• -S fmt — used to start each fax. it is passed one parameter, the fax file name. 🫶
• -s fmt — used to start each field. it is passed one parameter, the field name. 💜
• -e fmt — used to end each field. it is passed one parameter, the field name. 🌸
• -E fmt — used to end each fax. it is passed one parameter, the fax file name. 💖

---

📝 NOTES 📝

the info faxinfo prints comes from the tags stored in the TIFF image that the HylaFAX software writes. so if you hand her an invalid TIFF image, she may print uninteresting information — not a vibe, but that's the deal. 😭

same energy if you feed her a TIFF image that was not written by HylaFAX: only partial information may be printed. this is because HylaFAX stores certain information in private tags that other TIFF writers may not emit. it's giving exclusive. 💀

using the raw fmt options lets you directly control the print format strings used to format the output. these format strings are passed directly to printf, with basic \<char> sequences being interpreted — including \n, \r, and \t — and they can be used to make the output conform to specific requirements, like peculiar CVS, tables, HTML, etc. yes bestie, you can absolutely make it output HTML. go off. 🧚

⚠️ the order of the options is important. they are parsed from first to last, and any later options will override settings of previous ones. so like, last one wins. periodt. 👑

---

🚨 ERRORS 🚨

faxinfo returns 0 on success and 1 if the file passed as argument is not valid. binary queen — either she ate or she didn't. 🍓

---

👀 SEE ALSO 👀

hylafax-server(5F), faxrcvd(8C), faxgetty(8C)

---

and that's the whole page, bestie ✨ this one's from FAXINFO(8C), dated November 15, 1996 — old but still slaying fr fr 💖🎀🦋