display buffers

Purpose

Displays the contents of a port buffer, or transfers the contents of a port buffer to a server running Trivial File Transfer Protocol (TFTP). Enable port buffering using the set buffer command (see set buffer). Contents display in log form.

Required permissions

For Digi products with two or more users, permissions must be set to one of the following:

• For a user to display the contents of a port buffer for the line on which they are logged in: set permissions buffers=r-self or higher.
• For a user to display the contents of a port buffer for any line: set permissions buffers=read or higher.

See set permissions for details on setting user permissions for commands.

Syntax

display buffers [port=range] {[screen] [lines=number] 
   [tail=number]   | tftp=server:filename}

Options

port=range

The port or ports to which the command applies. Optional on a single-port device.

screen

Displays the port buffer contents on the screen when screen is specified.

lines=number

The number of lines of data to display at a time when the screen option is specified. Use 0 to indicate continuous flow.

tail=number

The total number of lines in the buffer to be displayed. The number is calculated from the end of the buffer counting back.

tftp=server:filename

server

The IP address or DNS name of a server running TFTP to which buffer information should be transferred.

filename

The name to use for the file that transferrs to the TFTP server. If the port option specifies more than one port, one file transferrs for each port. The filename for each port will be filename_n, where n is the port number.

Examples

Display port buffering information on the screen

#> display buffers port=2 screen lines=32 tail=30

Output buffering information to a TFTP server

#> display buffers port=2 tftp=192.168.1.1:port_ouput

Output multi-\port buffering information to a TFTP server

#> displady buffers port=2-3 tftp=192.168.1.1:port_ouput

Note Port 2 buffering information goes to file port_output_2 and port 3 buffering information goes to file port_output_3.

See also

set buffer