NAME

       dahdi_genconf - Generate configuration for Dahdi channels.

SYNOPSIS

       dahdi_genconf [options] [generator...]

DESCRIPTION

       This script generate configuration files for Dahdi hardware.  It uses two information sources:

       Hardware
            The actual Dahdi hardware is automatically detected on the host.

       /etc/dahdi/genconf_parameters
           A configuration file that supplements the hardware information.  Its location may be overridden via
           the "GENCONF_PARAMETERS" environment variable.

       The dahdi_genconf script can generate various kinds of configuration files as specified by the generator
       arguments.  Each generator is a perl class in Dahdi::Config::Gen namespace.  The generator names on the
       command line are the class names in lowercase.

       The following generators are currently implemented: system, modules, spantypes, assignedspans, chandahdi,
       unicall, users.

       For further documentation on each, please user perldoc on the relevant class. E.g: "perldoc
       Dahdi::Config::Gen::Chandahdi"

       Each generator on the command line may be passed custom options by assigning a comma separated list of
       options to the generator name. E.g:

        dahdi_genconf system chandahdi=verbose unicall

   Global options:
       -V --version
           Version -- print version string and exit.

       -v --verbose
           Verbose -- sets the 'verbose' option for all generators.

       -F --freepbx
           Freepbx -- sets the 'freepbx' option for all generators.  Currently, chandahdi is affected.

       --line-mode=mode
           mode may be E1, J1 or T1.

           Enables the generator spantypes and the option line-mode to it.  (Equivalent to the option
           "--line-mode" to "dahdi_span_types"). This will generate a "span-types.conf" file with a single
           wildcard line setting the line mode to mode.

   Implementation notes:
       •   genconf_parameters parsing is done via "Dahdi::Config::Params".  An object representing the parsed
           data is instantiated by: "Dahdi::Config::Params->new()".  The item() method of this object contains
           all the hard coded defaults of the configuration directives.

       •   A configuration object is instantiated by "Dahdi::Config::Gen->new($params)".  The mapping of
           configuration directives into semantic configuration is done in the constructor.

       •   A single generator is run via the the run_generator() method of the configuration object.