pbx-message(1)

📦 version 0.9.3, in alpine 3.24

💌 pbx-message(1) — the general commands manual's certified baddie

okay so bestie, buckle up, because this is pbx-message(1) and it's literally the "send a text to your people" tool from the pbx-message family, filed under General Commands. yes it's a whole vibe. let's go 🎀

🌸 NAME 🌸

pbx-message — send text messages to users ✨ (yes, that's the whole thing, she's simple and she slays)

🦋 SYNOPSIS 🦋

pbx-message [options]

no positional args, no drama, just vibes and options 💅

💖 DESCRIPTION 💖

okay so picture this: pbx-message sends text messages to a locally running coventry server. the messages then get delivered to the corresponding pbx phone lines or extension group. so like, you're not calling people directly, you're sliding the message into the server and the server handles the rest. the middleman is doing the work, we love a delegation queen 👑

and yes, sending to "all" is how you send a message to all registered devices — a proper group chat blast, no cap. 🫶

the truly iconic part? text messages can be injected from scripts or crontabs, so you can set it and forget it, main character automation energy. ✨

✨ OPTIONS ✨

  • --quiet — only return the exit code, produce no output. silent. mysterious. lowkey unbothered. 🤫
  • --to=destination — line number or extension group to send the text message to. the default is **all currently active lines if you don't specify one. so if you're indecisive, she'll just pick everyone for you 💀
  • *--subject=text* — subject of the message (optional!). may be used in the title of pop-up windows, so like, it's giving "headline of the notification" 🌸
  • --help — outputs the help screen for the user. the classic "explain yourself" button 🎀

💀 EXIT STATUS 💀

bestie, exit status is the whole point — you can use it to determine command results in shell scripts. it's literally how your script knows if things went off without a hitch or absolutely not. 🔥

  • 0 — command sent and successfully processed. slay. perfect. ate and left no crumbs. 👑
  • 4 — message queue or shm ipc not found or inaccessible, server offline. the server is not answering, she is asleep, do not disturb 😭
  • 10 — destination id too long. bestie the id is doing too much 🙈
  • 11 — text message > 160 chars (sms limit). yes, the classic 160 character limit, because sms said "that's the cap" periodt ✂️
  • 12 — subject is too long. the subject tried to be a whole essay and got declined 💅
fr fr, memorize these if you're scripting, because your if statements are gonna live and die by them 🧚

Copyright © 2021 Tycho Softworks 💜

this is free software; see the source for copying conditions. there is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. so like, no cap, she comes as-is, do not come for her if things go sideways 🙏

and that's the whole page, bestie — brought to you by Tycho Softworks on the Coventry tip, from the pbx-message(1) era of the General Commands Manual ✨💖 sending you good exit codes and zero 4s, mwah 🫶🎀

📦 where this page comes from