display ip userlog buffer

Function

The display ip userlog buffer command displays control block information and user access information stored in the buffer of user login and logout logs.

This command is supported only on the NetEngine 8000 F1A.

Format

display ip userlog buffer { access | call-status } [ packet-index ] [ record-index ]

Parameters

Parameter	Description	Value
access	Displays information about user login and logout logs.	-
call-status	Displays information about user online result logs.	-
packet-index	Specifies the index of a control block in the buffer.	The value is an integer ranging from 0 to the maximum number of control blocks. The maximum number of control blocks is obtained using the following formula: Maximum number of access users supported x 10/1024.
record-index	Specifies the index of a user access record in the buffer.	The value is an integer: If access is specified, the value ranges from 0 to 6. If call-status is specified, the value ranges from 0 to 6.

Views

All views

Default Level

1: Monitoring level

Task Name and Operations

Task Name	Operations
bras-control	read

Usage Guidelines

Usage Scenario

After the function to generate user login, logout, and online result logs is enabled, logs recording user logins, logouts, and online results will be stored in the local buffer when users go online or offline. To view control block information and information about user login, logout, and online result logs stored in the local buffer, run the display ip userlog buffer access command.

To view information about all control blocks in the buffer, run the display ip userlog buffer access command.
To view packet header information of a specified control block in the buffer, run the display ip userlog buffer access packet-index command.
To view the log record with a specified record index in the control block with a specified block index, run the display ip userlog buffer { access | call-status } [ packet-index ] [ record-index ] command.

Precautions

In VS mode, this command is supported only by the admin VS.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display control block information stored in the buffer of user online result logs.

<HUAWEI> display ip userlog buffer call-status
------------Call-status Buffer Summary Information ---------------
 Total records need to be sent     : 0
 No. of packet being read          : 163
 No. of packet being written       : 163
 No. of current log record         : 1068
 -----------------------------------------------------------------

# Display information about the first user online result log in the first control block in the buffer.

<HUAWEI> display ip userlog buffer call-status 0 0
------------Call-status Buffer Record Information ----------------
 User name                         : R13-07001000100000@huawei
 User IP address                   : 10.7.7.8
 User login time                   : 2012/02/21 19:48:48
 NAS IP address                    : 192.168.4.13
 Interface name                    : GigabitEthernet0/1/1.1
 User MAC address                  : 00e0-fc12-3456
 User is online                    : Yes
 Online fail reason                : NA
 -----------------------------------------------------------------

# Display information about control blocks in the buffer.

<HUAWEI> display ip userlog buffer access
---------------- Buffer Control Information ----------------------
 Type of buffer                    :Access          
 Total records need to be sent     :10              
 No. of packet being read          :10              
 No. of packet being written       :10              
 No. of current log record         :10              
 -----------------------------------------------------------------

# Display packet header information about user online result logs in the first control block in the buffer.

<HUAWEI> display ip userlog buffer call-status 0
 ------------Call-status Buffer Packet Head Information ----------
 Count of records in packet        : 0
 Time of packet created            : 2012/02/21 19:48:48
 Sequence ID                       : 0
 -----------------------------------------------------------------

**Table 1** Description of the **display ip userlog buffer** command output
Item	Description
Buffer Control Information	Control block information in the buffer.
Total records need to be sent	Total number of user login and logout logs in the buffer.
No. of packet being read	Number of the packet being read.
No. of packet being written	Number of the packet being written.
No. of current log record	Number of the current user login or logout log.
User name	User name.
User IP address	IP address of a user.
User MAC address	MAC address of a user.
User login time	Date and time when a user goes online.
User is online	Whether a user goes online successfully.
NAS IP address	IP address of the device.
Interface name	Name of an access interface.
Online fail reason	Login failure reason.
Type of buffer	Buffer type of buffer of logs, which can only be Access or Call-Status in the current version.
Count of records in packet	Number of log records in the packet.
Time of packet created	Time when the packet is generated.
Sequence ID	Sequence number of the packet.