The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
This module describes the command-line utility (CLU) commands when the software is installed on the Subscriber Manager (SM).
The p3radius utility displays the RADIUS Listener configurations, status, and statistics. It also provides utilities to test RADIUS configuration and regular expression manipulation. The RADIUS Listener configuration includes all configured NAS devices and general RADIUS Listener parameters.
The p3radius command format is p3radius <operation>.
Table 18-1 lists the p3radius operations.
Table 18-2 lists the p3radius options.
The following is an example using the p3radius CLU with the show operation:
>p3radius --show RADIUS Listener information ============================ running: true accounting port: 1813 packet types : accounting-start, accounting-interim, accounting-stop NASs: none Subscriber ID ============= user_name: radius attribute: 1 type: string vpn: VSA Vendor-id: 1 sub attribute: 2 type: string Separator configuration rule: Separator=user_namevpn Subscriber IP Address ===================== IP Configuration: filter-id: radius attribute: 2 type: integer VPN Configuration: vpn: radius attribute: 26 type: integer Properties ========== property name: packageId ------------------------ vpn: VSA Vendor-id: 1 sub attribute: 2 type: string user_name: radius attribute: 1 type: string Reduction configuration rules: Field=vpn; Pattern=.* Field=user_name; Pattern=.* Matching configuration rules: Matching Pattern=.*; Matching Value=2 Matching Pattern=123; Matching Value=3 property name: monitor ---------------------- filter-id: radius attribute: 2 type: integer Matching configuration rules: Matching Pattern=^$; Matching Value=1 property name: upVlinkId ------------------------ property name: downVlinkId -------------------------- Command terminated successfully >
The following is an example of the p3radius CLU with the show-statistics operation:
>p3radius --show-statistics Statistics: =========== Packets Received: 0 Packets Transmitted: 0 Accounting Request: 0 Accounting Start: 0 Accounting Interim: 0 Accounting Stop: 0 Accounting Response: 0 Dropped: 0 Successful logins: 0 Failed logins: 0 Successful logouts: 0 Failed logouts: 0 Command terminated successfully >
The following is an example of the p3radius CLU with the test-manipulation operation:
p3radius --test-manipulation -f regExpTest.cfg --section="Radius.Subscriber ID" --fields=user_name=,vsa=cisco.LTD.sanjose,filter-id=172.16.1.1 The following fields parameter were being extracted: field_name=user_name, field_data= field_name=vsa, field_data=cisco.LTD.sanjose field_name=filter-id, field_data=172.16.1.1 reduction rules: user_name pattern: (.*)@.* vsa pattern: (.*).LTD(.*) filter-id pattern: .* separator: user_name-vsa@filter-id Reduction iteration [0]: field data=, RegExp Pattern=(.*)@.*, concatenated string (with separator)=- Reduction iteration [1]: field data=cisco.LTD.sanjose, RegExp Pattern=(.*).LTD(.*), concatenated string (with separator)=-cisco.sanjose@ Reduction iteration [2]: field data=172.16.1.1, RegExp Pattern=.*, concatenated string (with separator)=-cisco.sanjose@ Manipulation result:-cisco.sanjose@ Command terminated successfully >
The following is an example of the p3radius CLU with the test-reduction-rule operation:
p3radius --test-reduction-rule --reg-exp=(.*)@.* --input=user@cisco.com --performance Pattern: '(.*)@.*'; String to reduce: 'user@cisco.com'; Reduction result: 'user' Regular Expression operation time is 0.112 ms Command terminated successfully >
The following are examples of the p3radius CLU with the test-matching-rule operation:
p3radius --test-matching-rule --reg-exp=^user$ --input=user@cisco.com --performance Pattern: '^user$'; String to match: 'user@cisco.com'; Matching not found Regular Expression operation time is 0.0 ms. p3radius --test-matching-rule --reg-exp=user --input=user@cisco.com --performance Pattern: 'user'; String to match: 'user@cisco.com'; Match found Regular Expression operation time is 0.045 ms. p3radius --test-matching-rule --reg-exp=users --input=user@cisco.com --performance Pattern: 'users'; String to match: 'user@cisco.com'; Matching not found Regular Expression operation time is 0.045 ms. Command terminated successfully >