====== BRAS PPPoE CLI ======
{{indexmenu_n>3}}

BNG/BRAS PPPoE-sessions management

This is a fastdpi command, so you have to specify the fastdpi address in the -r argument of the utility.

==== pppoe show all ====
Output of all PPPoE-sessions
<code>
fdpi_cli -r <address> pppoe show all
# Synonym for the command:
fdpi_cli -r <address> pppoe show sessions
</code>

==== pppoe show session ====
Output of a specific PPPoE-session by a specified key:
<code>
fdpi_cli -r <address> pppoe show session [ip=X | mac=X | login=X]
</code>
The key is specified by one of the parameters:
  * ''ip'' - subscriber's IPv4- or IPv6-address
  * ''mac'' - subscriber's MAC-address
  * ''login'' - subscriber's login
Examples:
<code>
fdpi_cli -r 192.168.0.1 pppoe show session ip=10.56.79.7
fdpi_cli -r 192.168.0.1 pppoe show session ip=2001:89:7896:5::
fdpi_cli -r 192.168.0.1 pppoe show session mac=00:1b:21:bc:a3:0c
fdpi_cli -r 192.168.0.1 pppoe show session login=piter_smith
</code>

==== pppoe show stat ====
Output of PPPoE-sessions internal statistics
<code>
fdpi_cli -r <address> pppoe show stat
</code>

==== pppoe term ====
Session termination. 
<code>
fdpi_cli -r <address> pppoe term [hard] [ip=X | mac=X | login=X]
</code>
The command ''pppoe term'' is a soft reset: which sends LCP Termination Request to subscriber and expects Term Ack response. If there is no response from the subscriber, Term Req is repeated. If the subscriber does not respond after all attempts (set by fastdpi.conf-parameter ''bras_ppp_max_terminate''), the session is completely terminated.

The command ''pppoe term hard'' sends a PPPoE PADT packet to the subscriber and terminates the session without requiring confirmation.

The subscriber is specified by one of the parameters:
  * ''mac=XX:XX:XX:XX:XX:XX'' - subscriber's MAC-address;
  * ''ip=X.X.X.X'' - subscriber's IP-address (IPv4 or IPv6);
  * ''login=xxx'' - subscriber's login;

It should be noted that the MAC-address is the primary unique key of a PPP-session. All other keys are secondary and not unique, that is, when the session ends by IP or by login, it is possible to terminate several sessions.

Examples:
<code>
fdpi_cli -r 127.0.0.1 pppoe term mac=01:02:03:60:70:99
fdpi_cli -r 127.0.0.1 pppoe term hard ip=10.0.0.50
</code>

==== pppoe renew pool ====
{{anchor:renew_pool}}
Forced DHCP Renew for the addresses, allocated from a [[dpi:bras_bng:ip_pool|pool]]
<code bash>
  # General command format
fdpi_cli -r 127.0.0.1 pppoe renew pool [ip=X | mac=X | login=X]
</code>

The subscriber is specified by one of the parameters:
  * ''mac=XX:XX:XX:XX:XX:XX'' - subscriber's MAC-address;
  * ''ip=X.X.X.X'' - subscriber's IP-address (IPv4 or IPv6);
  * ''login=xxx'' - subscriber's login;
Examples:
<code bash>  
fdpi_cli -r 127.0.0.1 pppoe renew pool ip=10.56.79.7
fdpi_cli -r 127.0.0.1 pppoe renew pool ip=2001:89:7896:5/64
fdpi_cli -r 127.0.0.1 pppoe renew pool mac=00:1b:21:bc:a3:0c
fdpi_cli -r 127.0.0.1 pppoe renew pool login=piter_smith
</code>