sip-options(1)

📦
version 1.12.11+20110422.1+1e14eea · 4 versions
, in ubuntu noble, ubuntu questing

okay bestie, sit down, hydrate, because we're talking about sip-options — the little tool from the General Commands Manual section that pokes a SIP server and tells you what it says back. 💅

🎀 NAME 🎀

sip-options — Query SIP OPTIONS

🌸 Synopsis 🌸

sip-options [OPTIONS] target-uri

✨ Description ✨

So like. The sip-options utility sends a SIP OPTIONS request to a SIP server. And not just OPTIONS, bestie — it can send any other SIP request too. It's giving versatile. 👑

Then it prints out the status line and the interesting headers from the response. And when I say interesting, I mean it's literally skipping From, Via, Call-ID, and CSeq — those are not invited to the group chat by default. 🙈

The message body also gets printed. So you get the receipts AND the content. periodt.

💖 Command Line Options 💖

The options utility accepts following command line options:

  • -m url | --contact=url | --bind=url — Specifies the SIP URL to which the options utility binds. That's the address it's sitting at, its little home. 🏠
  • --1XX | -1 — Print also preliminary responses. And listen: if this option is not present, preliminary responses are silently discarded. Gone. Not even a text back. 😭
  • --all | -a — All SIP headers will be printed. If the --all option is given, the options utility also prints From, Via, Call-ID or CSeq headers. The full tea, no filtering. 🔥
  • --from=url — Specifies the From header. Unless this option is used or the environment variable SIPADDRESS is set, the local Contact URL is used as the From header as well. So it's out here pretending to be you if you don't say otherwise. 💀
  • --mf=n — Specify the initial Max-Forwards count. It defaults to 70, which is the stack default. Iconic number, no notes. ⭐
  • --method=s — Specify the request method. It defaults to OPTIONS. Change it up, main character energy. 🦋
  • --extra | -x/dt> — Read extra headers (and optionally a message body) from the standard input. (yep, we are keeping that exactly as written, character for character, no cap 🫶)

👑 Return Codes 👑

  • 0 — when successful (a 2XX-series response is received)
  • 1 — when unsuccessful (a 3XX..6XX-series response is received)
  • 2 — initialization failure

🌈 Examples 🌈

Say you want to query supported features of sip:essip00net.nokia.com. Bestie, you just:

$ options sip:essip00net.nokia.com

ate. 🍓

🧚 Environment 🧚

#SIPADDRESS, #sip_proxy, #NTA_DEBUG, #TPORT_DEBUG, #TPORT_LOG.

💜 Reporting Bugs 💜

Report bugs to sofia-sip-devel@lists.sourceforge.net. Tell them everything, they want to know. 🫶

🌟 Author 🌟

Written by Pekka Pessi <pekka -dot pessi -at- nokia -dot com>

Copyright (C) 2005 Nokia Corporation.

This program is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

not me reading the warranty clause, it's giving "we are not liable" and honestly, valid. 😭

and that's the whole page, bestie — from sofia-sip-utils, Version 1.12.11devel, all about sip-options(1). go forth and query. 💖✨

📦 where this page comes from