Provided by: br2684ctl_2.5.1-5.1build1_amd64 bug

NAME

       br2684ctl - RFC1483/2684 Bridge Daemon

SYNOPSIS

       br2684ctl [ -b ] [[ -c n ] [ -e 0|1 ] [ -p 0|1 ] [ -s sndbuf ] [ -a [itf].vpi.vci ]] ...

PARAMETERS

       -a [itf].vpi.vci
                      ATM PVC number, VPI and VCI.  (Required)

       -b             Puts the process in the background.

       -c n           br2684 interface number such as 0, 1, ... (Required)

       -e 0|1         Encapsulation method:  0=LLC, 1=VC mux (the default is 0 or LLC)

       -p 0|1         Payload method:  0=Routed, 1=Bridged (the default is 1 or Bridged)

       -s sndbuf      Send buffer size. Default is 8192.

DESCRIPTION

       br2684ctl  handles  RFC1483/2684  bridged PDUs.  This is most often used in ADSL scenarios
       where usually the subscribers' ethernet traffic is encapsulated in ATM AAL5  (by  bridging
       ADSL modems) according to RFC2684.  The subscriber-side ADSL modem can be external with an
       ethernet connector or an internal ADSL card in  a  PC.   RFC1483  has  been  obsoleted  by
       RFC2684.

       For  example  it  is  possible  to  set up your Linux box to handle several ATM PVC's with
       bridged-1483 (sometimes referred as SNAP) encapsulation.  The Linux  network  stack  might
       provide  DHCP,  IP  masquerading,  IP firewall services or bridge the Ethernet frames just
       like it had several ethernet interfaces.  In fact it can have several  (logical)  ethernet
       interfaces, where ATM is just used as a carrier.

USAGE

       br2684ctl  creates  a new network interface named nas[n] which is bound to an specific ATM
       PVC. It requires two mandatory arguments:  -c, the interface number, and -a, the ATM  PVC.
       It  should  be noted that the order of the command arguments matter; -c should be followed
       by -a. You can create as many interfaces as necessary in one go, just make a long  command
       line ;)

       For  example,  following  command will create a nas0 interface which uses the ATM PVC with
       VPI=0 and VCI=401. You need to configure the  PVC  connection  0.401  on  the  ATM  switch
       manually.

       % br2684ctl -c 0 -a 0.401

       The  command  will only create a new interface nas0.  Next step is to assign an IP address
       and netmask to the interface nas0 using the ifconfig command. Using ifconfig, you can also
       assign a Ethernet MAC address to the interface nas0, if necessary.

       % ifconfig nas0 192.168.2.1 netmask 255.255.255.0

       Messages are logged to the LOCAL2 syslog facility.

FILES

       /var/run/br2684ctl-<iface>.pid

NOTES

       This man page is based on a tutorial by by Joonbum Byun <jbyun@megaxess.com>

SEE ALSO

       qos(7)

                                            7 Jul 2003                               br2684ctl(8)