Provided by: dahdi_2.10.2-2ubuntu1_i386 bug

NAME

       dahdi_span_types - set line modes of DAHDI spans before assignment

SYNOPSIS

       dahdi_span_types [options] <list|dumpconfig|set> [devpath ...]

DESCRIPTION

       The  span  type  (the line mode: E1/T1/J1) must be set to a span before
       DAHDI assigns it  a  span  number,  as  E1  spans  use  more  channels.
       dahdi_span_types  applies the span type configuration to an un-assigned
       span.

       Using  it  only  makes  sense  when   the   kernel   module   parameter
       dahdi.auto_assign_span  is  unset, otherwise DAHDI automatically assign
       span numbers during device registration.

       dahdi_span_types takes a command and an optional list of devices. If no
       device is given, the command is applied to all devices.

       The device is marked as a path in the SysFS tree.

OPTIONS

       -h|--help
              Output usage message and exit

       -n|--dry-run
              During  "set"  operation,  only show what would be done, without
              actually changing anything.

       -v|--verbose
              During  "set"  operation,  show  the  actions  that  are   being
              performed.

       --line-mode=<E1|T1|J1>
              During "dumpconfig" operation, force special generation mode:

              ·  First, generates a "wildcard" entry with the fiven line-mode.

              ·  Comment  out  all  span entries. Each of them may be manually
                 un-commented to override the "wildcard".

SUB-COMMANDS

       set
              Reads settings from span-types.conf  and  applies  them  to  the
              device(s) specified in the command line (or all devices, if none
              specified).

       list
              List line modes for all spans in the system  which  may  be  set
              with dahdi_span_types (E1/T1/J1 spans).

       dumpconfig
              List  types  for  the  spans  in  a  format  fit  to  be used in
              span-types.conf. Use this to generate a configuration file after
              you have (perhaps manually) set all existing spans.

              dahdi_genconf spantypes uses this command internally.

CONFIGURATION

   General structure
       span-types.conf is a file with lines specifying line modes of spans.

       Empty lines or lines beginning with '#' are ignored.

       Each line is in the format of:

       ID        spanspec ...

       The  ID  field  specifies the DAHDI device and the spanspecs define the
       line modes of its spans. A line may have multiple spanspecs in a single
       line (though dumpconfig generates a configuration with one per line).

   Span Identifier
       A  DAHDI  device  may  be  specified either by a hardware identifier (a
       software readable serial number or whatever) or the location  in  which
       it  is  installed  on the system. The former makes it simpler to change
       connector / slot whereas the latter makes it simpler to replace a unit.

       The value in this field is matched (when the command set  is  used)  to
       the following values:

        hwid
        @location
        devpath

       See   above  for  their  descriptions.  The  value  may  include  shell
       wildcards: *, ? and [], which are used in the match. The values  to  be
       matched  are  first  cleaned  up:  '!'  is  replaced  with  '/' and any
       character not in "a-zA-Z0-9/:.-" is replaced by "_".

       Note  that  while   span-types.conf   allows   an   arbitrarily-complex
       combination  of  E1,  J1  and  T1  ports, it would normally have just a
       single wildcard line setting the line  mode  (the  first  line  in  the
       example below).

   Span Specification
       Each  line  should  have  one  or more span specifications: this is the
       value used to set span type  with  DAHDI  in  the  SysFS  interface.  A
       specification has two colon-separated fields:

       rel_span_no:span_type

       for  instance, the following are four span specifications specify ports
       1 and 2 as E1 and ports 3 and 4 as T1: [12]:E1 [34]:T1 .

       rel_span_no
              The relative number of  the  span  in  the  device.  E.g.:  port
              number.  This field may contain shell wildcards (*, ? and [])

       span_type
              E1/T1/J1

   Multiple matches
       During   set  operation,  the  dahdi_span_types  applies  all  matching
       settings to a span.  This  is  done  in  the  order  of  lines  in  the
       configuration files.

       Thus,  if  there  are multiple matches to a span -- the last match will
       win (all will be applied to the kernel in order. The last  one  in  the
       file will be applied last).

       Example:
       *             *:T1      # All spans on all devices will be T1
       usb:X1234567  [34]:E1   # Except spans 3,4 on the device which will be E1

ENVIRONMENT

       DAHDICONFDIR
              The  directory  in  which span-types.conf resides. /etc/dahdi if
              not overridden from the environment.

       DAHDISPANTYPESCONF
              The path to span-types.conf resides.  /etc/dahdi/span-types.conf
              if not overridden from the environment.

FILES

       /etc/dahdi/span-types.conf
              The default location for the configuration file.

       /sys/bus/dahdi_devices/devices/device
              SysFS  node  for  the  device.  In  this  directory  reside  the
              following files, among others:

              spantype
                     read/write  file.  Reading  from   it   returns   current
                     configuration    for   spans   of   the   device.   Span-
                     specifications can be written to it to change line  modes
                     (but only for a span that is not assigned yet).

SEE ALSO

       dahdi_span_assignments(8), dahdi_genconf(8), dahdi_cfg(8)

AUTHOR

       dahdi_span_types  was  written  by  Oron  Peled.   This manual page was
       written by Tzafrir Cohen. 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.

                                  23 Jan 2014              DAHDI_SPAN_TYPES(8)