Installation guide

display buffers
Chapter 2 Command Descriptions 21
display buffers
Devices
supported
This command is supported in all Digi Connect devices except the Digi
Connect WAN.
Purpose The display buffers command is used to display the contents of a port
buffer, or Transfer the contents of a port buffer to a server running Trivial
File Transfer Protocol (TFTP). Port buffering is enabled by the “set buffer”
command (see "set buffer" on page 55). Contents are displayed in log form.
Required
permissions
To use this command, 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" on page 86 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 will be transferred to the TFTP server.
If the “port” option specifies more than one port, one file will be
transferred for each port. The filename for each port will be
filename_n, where n is the port number.