dahdi_scan(8)

💖 dahdi_scan — Print Configuration of DAHDI Spans 💖

okay bestie, so this is a page from the System Manager's Manual (section 8, we love a sysadmin moment) and it's all about dahdi_scan, no cap. grab a strawberry 🍓 and let's get into it.

---

✨ SYNOPSIS ✨

dahdi_scan [spans]

---

🌸 DESCRIPTION 🌸

dahdi_scan prints info about the DAHDI spans on your system, and for the analog spans it also hands you a whole list of channels. it's giving inventory vibes 💅

by default it prints info about all the spans in the system. but if you pass parameters, those get treated as a list of span numbers and it'll only print the info for those ones. selective. main character energy 👑

output goes to standard output, and the format is that of an Asterisk configuration file (basically like an "ini" file), where the name of the section is the number of the span. BUT WAIT — specifically for analog spans, some keys may show up more than once, so you literally cannot use an "ini" parser and assume you've got yourself a dictionary. it's not that kind of party 🙈

---

🎀 EXAMPLES 🎀

printing info for spans 1, 2 and 4:

dahdi_scan 1 2 4

and to print all the spans (the no-arguments slay):

dahdi_scan

info about a certain analog span:

[5]
active=yes
alarms=OK
description=Xorcom XPD #00/10: FXS
name=XBUS-00/XPD-10
manufacturer=Xorcom Inc.
devicetype=Astribank: Unit 1 Subunit 0: FXS
location=usb-0000:00:03.3-4
basechan=125
totchans=8
irq=0
type=analog
port=125,FXS
port=126,FXS
port=127,FXS
port=128,FXS
port=129,FXS
port=130,FXS
port=131,FXS
port=132,FXS

and an example of a digital span:

[1]
active=yes
alarms=RED
description=T2XXP (PCI) Card 0 Span 1
name=TE2/0/1
manufacturer=Digium
devicetype=Wildcard TE205P (4th Gen)
location=Board ID Switch 0
basechan=1
totchans=24
irq=193
type=digital-T1
syncsrc=0
lbo=0 db (CSU)/0-133 feet (DSX-1)
coding_opts=B8ZS,AMI
framing_opts=ESF,D4
coding=B8ZS
framing=ESF

the "type" field may contain: "analog", "digital-T1", "digital-E1", "digital-J1" or "digital-BRI". that's the whole menu bestie 🦋

---

🦋 FILES 🦋

requires read access to /dev/dahdi/ctl . like, it needs to be able to read it. no read, no scan, it's that simple 💀

---

🌈 SEE ALSO 🌈

dahdi_cfg(8), asterisk(8).

---

💀 BUGS 💀

the program still does not do everything described in the man page. yeah. we said what we said. 😭

it also assumes that spans don't skip channel numbers, and that their channel numbers are "running". this is anyway almost always the case. and always the case in a normal boot process. so like, lowkey fine, but now you know 🫶

---

👑 AUTHOR 👑

this manual page was written by Tzafrir Cohen <tzafrir.cohen@xorcom.com>

permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 2 any later version published by the Free Software Foundation.

on Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL.

---

and that's the whole page bestie!! this one came from the System Manager's Manual, dated 2008-03-18, and it lives at section 8 as dahdi_scan(8). go scan some spans, you absolute icon ⭐🧚💜