====== Policing Management ====== {{indexmenu_n>3}} Subscriber management is performed using the utility ''fdpi_ctrl''. We recommend using [[dpi:dpi_components:platform:subscriber_management:subsman_profiles]], which simplifies policing management. ===== Command Syntax ===== The general format of commands: fdpi_ctrl command --policing policing_description_file [IP_list] [LOGIN_list] 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 | A line starting with ''#'' is a comment. ===== Examples ===== - Enable policing policy using a policing description file: fdpi_ctrl load --policing tbf.cfg --ip 192.168.0.1 - Get a list of applied policing: fdpi_ctrl list all --policing - Get information for a specific IP: fdpi_ctrl list --policing --ip 192.168.0.1 - Enable policing policy using a named profile: fdpi_ctrl load --policing --profile.name tariff_10 --login kv_111