====== BRAS DHCP CLI ======
{{indexmenu_n>1}}

View and management of the internal DHCP-sessions fastdpi BRAS database. 

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

==== DHCP show all ====
Output of the complete database of DHCP-sessions fastdpi:
<code>
fdpi_cli -r <address> dhcp show all
</code>

==== DHCP show ====
Output of sessions by specified keys:
<code>
fdpi_cli -r <address> dhcp show [ip=X | mac=X | login=X]
</code>
You should set one of the keys:
  * ip=X - subscriber's IP-address
  * mac=X - subscriber's MAC-address
  * login-X - output of all DHCP-sessions by the specified login
Examples:
<code>
   fdpi_cli -r 10.10.0.52 dhcp show ip=192.168.52.36
   fdpi_cli -r 10.10.0.52 dhcp show mac=01:02:03:05:06:07
   fdpi_cli -r 10.10.0.52 dhcp show login=john_smith
</code>

==== DHCP show stat ====
Output of current statistics on DHCP-sessions:
<code>
fdpi_cli -r <address> dhcp show stat
</code>

==== DHCP reauth ====
<code>
fdpi_cli -r <address> dhcp reauth [ mac=X | ip=X ]
</code>
Subscriber re-authorization with a specified key.

To reduce the load on the Radius-server, BNG/BRAS caches the DHCP data from the Radius for the address lease duration, and responds to the DHCP Request of the subscriber. Sometimes it is required to indicate to DPI that the next subscriber's request should be sent to Radius without waiting for the lease time to expire. This is what the ''dhcp reauth'' command is for.

You should set one of the keys:
  * ip=X - subscriber's IP-address
  * mac=X - subscriber's MAC-address
Examples:
<code>
   fdpi_cli -r 10.10.0.50 dhcp reauth ip=192.168.52.36
   fdpi_cli -r 10.10.0.50 dhcp reauth mac=01:02:03:05:06:07
</code>