show dhcp
Displays counter information pertaining to Dynamic Host Configuration Protocol IPv4 (DHCP) functionality based on specific criteria.
Product
GGSN
ASN-GW
P-GW
SAEGW
Privilege
Security Administrator, Administrator, Operator, Inspector
Mode
Exec
The following prompt is displayed in the Exec mode:
[local]host_name#
Syntax
show dhcp [ counters | full | summary ] [ all | apn apn_name | callid id | chaddr mac_address | dhcp-service svc_name | imsi imsi | msid msid | server server_address | statistics [ dhcp-service svc_name | server server_address ] | status [ dhcp-service svc_name | server server_address ] | user-address address | username name ] [wf1] [ | { grep grep_options | more } ]
counters
Displays DHCP counter information.
full
Displays all available information pertaining to the criteria specified.
summary
Displays a summary of the DHCP statistics.
all
Displays counter information for each active PDP context.
apn apn_name
Displays information based on an existing Access Point Name (APN) specified as an alphanumeric string of 1 through 63 characters that is case sensitive.
callid id
Displays information for an existing call identification number specified as a 4-digit hexadecimal number.
chaddr mac_address
Displays information for a mobile node specified by its MAC address.
dhcp-service svc_name
Displays information for an existing DHCP service specified as an alphanumeric string of 1 through 63 characters that is case sensitive.
imsi imsi
Displays information for an International Mobile Subscriber Identity (IMSI) specified as a string of 1 to 15 digits.
msid msid
Displays information for a Mobile Subscriber Identity (MSID) specified as a string of 1 to 15 digits.
server server_address
Displays information for a DHCP server specified by its IP address in IPv4 dotted-decimal notation.
statistics [ dhcp-service svc_name | server server_address
Displays DHCP statistics for either a specific or for all DHCP services and servers configured.
dhcp-service svc_name : Displays statistics for a DHCP service specified as an alphanumeric string of 1 through 63 characters that is case sensitive.
server server_address : Displays statistics for a DHCP server specified by its IP address in IPv4 dotted-decimal notation.
status [ dhcp-service svc_name | server server_address
Displays configuration information for either a specific or for all DHCP services and servers configured.
dhcp-service svc_name : Displays statistics for a DHCP service specified as an alphanumeric string of 1 through 63 characters that is case sensitive.
server server_address : Displays statistics for a DHCP server specified by its IP address in IPv4 dotted-decimal notation.
user-address address
Displays information for a DHCP-assigned user IP address specified in IPv4 dotted-decimal notation.
username name
Displays information for a subscriber specified as an alphanumeric string of 1 through 127 characters (including wildcards "$" and "*") that is case sensitive.
wf1
Displays all available information for associated filter keyword in wide-format number 1.
| { grep grep_options | more }
Pipes (sends) the output of this command to a specified command. You must specify a command to which the output of this command will be sent.
For details on the usage of grep and more , refer to the Regulating a Command's Output section of the Command Line Interface Overview chapter in the Command Line Interface Reference.
Usage Guidelines
Counters pertaining to DHCP functionality can be displayed as cumulative values or for specific APNs, PDP contexts, servers, or DHCP services.
Example
show dhcp dhcp-service DHCP-Gi
show dhcp call-id DHCP-Gi
show dhcp chaddr 00:05:47:00:37:44
Important |
Output descriptions for commands are available in the Statistics and Counters Reference. |