br2684ctl(8)

1br2684ctl(8)                System Manager's Manual               br2684ctl(8)
2
3
4

NAME

6       br2684ctl - RFC1483/2684 Bridge Daemon
7

SYNOPSIS

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

PARAMETERS

13       -a [itf].vpi.vci
14                      ATM PVC number, VPI and VCI.  (Required)
15
16       -b             Puts the process in the background.
17
18       -c n           br2684 interface number such as 0, 1, ... (Required)
19
20       -e 0|1         Encapsulation method:  0=LLC, 1=VC mux (the default is 0
21                      or LLC)
22
23       -p 0|1         Payload  method:   0=Routed, 1=Bridged (the default is 1
24                      or Bridged)
25
26       -s sndbuf      Send buffer size. Default is 8192.
27

DESCRIPTION

29       br2684ctl handles RFC1483/2684 bridged PDUs.  This is most  often  used
30       in  ADSL  scenarios  where usually the subscribers' ethernet traffic is
31       encapsulated in  ATM  AAL5  (by  bridging  ADSL  modems)  according  to
32       RFC2684.  The subscriber-side ADSL modem can be external with an ether‐
33       net connector or an internal ADSL card in a PC.  RFC1483 has been obso‐
34       leted by RFC2684.
35
36       For  example  it is possible to set up your Linux box to handle several
37       ATM PVC's with bridged-1483 (sometimes referred as SNAP) encapsulation.
38       The  Linux  network stack might provide DHCP, IP masquerading, IP fire‐
39       wall services or bridge the Ethernet frames just like  it  had  several
40       ethernet  interfaces.   In  fact it can have several (logical) ethernet
41       interfaces, where ATM is just used as a carrier.
42

USAGE

44       br2684ctl creates a new network interface named nas[n] which  is  bound
45       to  an  specific ATM PVC. It requires two mandatory arguments:  -c, the
46       interface number, and -a, the ATM PVC. It  should  be  noted  that  the
47       order of the command arguments matter; -c should be followed by -a. You
48       can create as many interfaces as necessary in one go, just make a  long
49       command line ;)
50
51       For  example, following command will create a nas0 interface which uses
52       the ATM PVC with VPI=0 and VCI=401. You need to configure the PVC  con‐
53       nection 0.401 on the ATM switch manually.
54
55       % br2684ctl -c 0 -a 0.401
56
57       The  command  will  only  create a new interface nas0.  Next step is to
58       assign an IP address and netmask to the interface nas0 using the ifcon‐
59       fig command. Using ifconfig, you can also assign a Ethernet MAC address
60       to the interface nas0, if necessary.
61
62       % ifconfig nas0 192.168.2.1 netmask 255.255.255.0
63
64       Messages are logged to the LOCAL2 syslog facility.
65

FILES

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

NOTES

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