====== Policing Management ======
{{indexmenu_n>3}}
Subscriber management is performed using the utility ''fdpi_ctrl''.
<note important>We recommend using [[dpi:dpi_components:platform:subscriber_management:subsman_profiles]], which simplifies policing management.</note>

===== Command Syntax =====
The general format of commands:
<code bash>fdpi_ctrl command --policing policing_description_file [IP_list] [LOGIN_list]</code>

Explanation of command parameters:
^ Parameter                    ^ Description, possible values, and format                                                                                                                                                                                                                                                                   ^ Note                                                                                                                                                                                                                                        ^
| ''command''                  | Values:\\ 1. ''load'' — load data\\ 2. ''del'' — delete. For ''--service'', you need to specify the ''service_identifier''\\ 3. ''list'' — display information for the specified ''IP_list'' or all information if the ''all'' argument is provided.                                                      | In ''list'' and ''del'' commands, instead of an IP/LOGIN list, you can specify ''all'', meaning the command will apply to all.                                                                                                             |
| ''policing_description_file''| A file in ''cfg'' format, e.g., ''tbf.cfg''                                                                                                                                                                                                                                                              |                                                                                                                                                                                                                                             |
| ''IP_list''                  | Values:\\ 1. ''--file'' — file with a list of IPs\\ 2. ''--ip'' — single IP, format: ''192.168.0.1''\\ 3. ''--ip_range'' — IP range (inclusive), format: ''192.168.0.1-192.168.0.5''\\ 4. ''--cidr'' — IP with port, format: ''192.168.0.0/30, 5.200.43.0/24~'' (CIDR format with excluded boundary addresses) | Boundary addresses can be excluded from a CIDR range (following the classless addressing agreement — gateway and broadcast addresses) by adding the ''~'' symbol at the end of the CIDR definition, e.g., ''--cidr 5.200.43.0/24~''.        |
| ''LOGIN_list''               | Values:\\ 1. ''--file'' — file with a list of logins\\ 2. ''--login'' — single login, format: USER1, "FIRST_NAME LAST_NAME" (alternative for specifying a login with escaped special characters)                                                                  | "USER1" — option for specifying login in double quotes\\ 'USER2' — option for specifying login in single quotes                                                                                                                           |
<note>A line starting with ''#'' is a comment.</note>

===== Examples =====
  - Enable policing policy using a policing description file: <code bash>fdpi_ctrl load --policing tbf.cfg --ip 192.168.0.1</code>
  - Get a list of applied policing: <code bash>fdpi_ctrl list all --policing</code>
  - Get information for a specific IP: <code bash>fdpi_ctrl list --policing --ip 192.168.0.1</code>
  - Enable policing policy using a named profile: <code bash>fdpi_ctrl load --policing --profile.name tariff_10 --login kv_111</code>