dahdi-tools/doc/dahdi_cfg.8
Tzafrir Cohen cffc5158cc dahdi_cfg: -S has assumtions on system.conf order
dahdi_cfg's -S (apply only to a specific span) uses the array chan2span
to map channel numbers to span numbers.

The problem is that it assumes that channels first appear in system.conf
immediately after the span line of a specific span. Thus the following
configuration breaks it:

span=1,...
span=2,...
clear=1-2,4-5
dchan=3,6

The best fix for that is to require -C to be used when -S is used (which
is already the case in our udev hooks).

Fixes DAHTOOL-69.

Signed-off-by: Tzafrir Cohen <tzafrir.cohen@xorcom.com>
2015-11-16 15:54:23 +02:00

85 lines
1.8 KiB
Groff

.TH "DAHDI_CFG" "8" "16 Jun 2008" "" ""
.SH NAME
dahdi_cfg \- configures DAHDI kernel modules from /etc/dahdi/system.conf
.SH SYNOPSIS
.B dahdi_cfg [\-c \fICFG_FILE\fB] [\-S\fINUM\fB [\-S\fICHANS\fB]] [\-s] [\-f] [\-t] [\-v [\-v ... ] ]
.B dahdi_cfg \-h
.SH DESCRIPTION
.B dahdi_cfg
configures DAHDI interface cards from a config file.
You generally need to run it with a valid configurations
in order for DAHDI modules to work properly.
It must be run to configure every DAHDI span. Normally it is run from
the DAHDI init script.
.SH OPTIONS
.B \-c \fICFG_FILE
.RS
Use an alternative configuration file instead of
.I /etc/dahdi/system.conf
If \fICFG_FILE\fR is '\fB\-\fR', it is read from stdin.
.RE
.B \-C \fICHANNELS
.RS
Only apply changes to channels in the specified range. Only
applicable when \-S is in use.
.RE
.B \-s
.RS
Only shutdown spans.
.RE
.B \-S \fISPAN
.RS
Only apply changes to span no. \fISPAN\fR. You also need to specify the
range of channels in the span explicitly with \-C.
.RE
.B \-f
.RS
Always configure every channel, even if it appears not to have changed.
.RE
.B \-t
.RS
Test mode. Don't do anything, just report what you wanted to do.
.RE
.B \-v
.RS
Be more verbose. Add extra v-s for extra verbosity.
.RE
.B \-h
.RS
Display a brief help message.
.RE
.SH FILES
.I /etc/dahdi/system.conf
.RS
The default location for the configuration file.
.RE
.SH SEE ALSO
dahdi_tool(8), dahdi_monitor(8), asterisk(8).
.SH AUTHOR
This manual page was written by Santiago Ruano Rinc\['o]n
<santiago@unicauca.edu.co> for
the Debian system (but may be used by others). 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.