DAHDI_GENCONF(8)

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.