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 chapter 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 Network Access System (NAS) devices and general RADIUS listener parameters.
The p3radius command format is p3radius <operation>.
Table 21-1 lists the p3radius operations.
Table 21-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
Interim Aging Time : 0
NASs:
====
name: theNAS
nasId: theNAS
ip: 10.73.233.143
secret: cisco
domain: subscribers
Subscriber ID
=============
Default association
Allow login if policy not found: false
Subscriber IP Address
=====================
IP Configuration:
Default association
Attributes
=====================
IP Configuration:
Default association
Attribute Configuration:
Acct-Session-ID: radius attribute: 44 type: string
Acct-Session-Time: radius attribute: 46 type: integer
Called-Station-ID: radius attribute: 30 type: string
WiMax-Active-Time: VSA Vendor-id: 24757 sub attribute: 39 type: integer
WiMax-BSID: VSA Vendor-id: 24757 sub attribute: 46 type: string
3GPP-Charging-Characteristics: VSA Vendor-id: 10415 sub attribute: 13 type: string
3GPP-Charging-Gateway-Address: VSA Vendor-id: 10415 sub attribute: 4 type: ip_address
3GPP-Charging-ID: VSA Vendor-id: 10415 sub attribute: 2 type: integer
3GPP-GGSN-Address-Code-7: VSA Vendor-id: 10415 sub attribute: 7 type: ip_address
3GPP-GGSN-Address: VSA Vendor-id: 10415 sub attribute: 87 type: ip_address
3GPP-GGSN-MCC-MNC: VSA Vendor-id: 10415 sub attribute: 9 type: string
3GPP-GPRS-Negotiated-QoS-Profile: VSA Vendor-id: 10415 sub attribute: 5 type: integer
3GPP-IMEISV: VSA Vendor-id: 10415 sub attribute: 20 type: string
3GPP-IMSI: VSA Vendor-id: 10415 sub attribute: 1 type: string
3GPP-MS-Timezone: VSA Vendor-id: 10415 sub attribute: 23 type: string
3GPP-NSAPI: VSA Vendor-id: 10415 sub attribute: 10 type: string
3GPP-PDP-Type: VSA Vendor-id: 10415 sub attribute: 3 type: integer
3GPP-RAT-Type: VSA Vendor-id: 10415 sub attribute: 21 type: string
3GPP-Selection-Mode: VSA Vendor-id: 10415 sub attribute: 12 type: string
3GPP-SGSN-Address: VSA Vendor-id: 10415 sub attribute: 128 type: ip_address
3GPP-SGSN-MCC-MNC: VSA Vendor-id: 10415 sub attribute: 18 type: string
3GPP-User-Location-Info: VSA Vendor-id: 10415 sub attribute: 22 type: string
Allow login if policy not found: false
Command terminated successfully
>
The following is an example of the p3radius CLU with the show-statistics operation:
>p3radius --show-statistics
>p3radius --show-statistics
Statistics:
===========
Packets Received: 0
Packets Transmitted: 0
Accounting Request: 0
Accounting Start: 0
Accounting Interim: 0
Accounting Stop: 0
Dropped: 0
Successful logins: 0
Failed logins: 0
Successful logouts: 0
Failed logouts: 0
Successful logins: 0
Successful 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 >