Scroll to navigation

nload(1) Network monitoring tools nload(1)

NAME

nload - displays the current network usage

SYNOPSIS

nload [-a period] [-i max_scaling] [-m] [-o max_scaling] [-t interval] [-u h|H|b|B|k|K|m|M|g|G] [-U h|H|b|B|k|K|m|M|g|G] [devices]

nload --help|-h

DESCRIPTION

nload is a console application which monitors network traffic and bandwidth usage in real time. It visualizes the in- and outgoing traffic using two graphs and provides additional info like the total amount of transferred data and min/max network usage.

USAGE

When running nload, you can switch between the devices (which you gave nload either on the command line or which were auto-detected) by pressing the left and right arrow keys. If the -m command line parameter is given, the arrow keys switch as many devices back and forth as there are shown on the screen. If you want to quit, do so by pressing 'q' or 'Ctrl+C'.

For further key shortcuts, have a look at the sections MAIN WINDOW and OPTION WINDOW below.

OPTIONS

A summary of the options supported by nload is included below.

Sets the length in seconds of the time window for average calculation. The default is 300.
Specifies the 100% mark in kBit/s of the graph indicating the incoming bandwidth usage. Use 0 for automatic scaling. Ignored if the switch -m is given. The default value for max_scaling is 0 (automatic).
Show multiple devices at a time; do not show the traffic graphs.
Same as -i but for the graph indicating the outgoing bandwidth usage.
Determines the refresh interval of the display in milliseconds. The default value of interval is 500.

PLEASE NOTE: Specifying refresh intervals shorter than about 100 milliseconds makes traffic calculation very unprecise. Also the display may flicker using such short refresh intervals. nload tries to balance this out by doing extra time measurements, but this may not always succeed.

Sets the type of unit used for the display of traffic numbers. h means human readable (auto), b Bit/s, k kBit/s, m MBit/s and g GBit/s. The upper case letters mean the corresponding units in Bytes (instead of Bits). The default is k.
Same as -u, but for an amount of data, e.g. Bit, kByte, GBit etc. (without "/s"). The default is M.
Appends traffic data to the named file. See the section TRAFFIC LOGGING FORMAT below for an explanation of the logged information.
Network devices to use. The default is "all", which means to display all auto-detected devices.
Show a short summary of these command line options.

MAIN WINDOW

After starting, nload begins to monitor the network devices given on the command line, or, if none where specified, the default device. In this mode, the following key shortcuts are available.

'ArrowRight', 'ArrowDown', 'PageDown', 'Enter', 'Tab'
Switch the display to the next network device, or, when started with the -m flag, to the next page of devices.

'ArrowLeft', 'ArrowUp', 'PageUp'
Switch the display to the previous network device, or, when started with the -m flag, to the previous page of devices.

'F2'
Show the option window (see section OPTION WINDOW below).

'F5'
Save current settings to the user's config file.

'F6'
Reload settings from the config files.

'q', 'Ctrl+C'
Quit nload.

OPTION WINDOW

The parameters given to nload on the command line can be adjusted during run time by pressing the 'F2' key. A small window appears on the top of the screen, listing the available settings.

'F2'
Show/hide the option window.

'ArrowLeft', 'ArrowRight', 'Home', 'End'
Navigate within the edit fields.

'ArrowUp', 'ArrowDown', 'Enter'
Navigate between the settings.

'PageUp', 'PageDown', 'Tab'
Toggle between the different values possible for the current field.

'+' / '-'
Switch to the next / previous page of settings.

TRAFFIC LOGGING FORMAT

Traffic is logged as a simple text table, with each line describing the traffic status of a single network device at a specific time. The first line of output serves as a table header naming each column of data. Columns are separated by a single space character. The meaning of each column is described below.

The date of the log entry in YYYY-MM-DD format, where YYYY is the four-digit year, MM the two-digit month (01-12) and DD the two-digit day (01-31).

The time of the log entry in HH:MM:SS format, where HH, MM and SS are the two-digit hours (00-23), minutes (00-59) and seconds (00-60).

The name of the network device for which this log entry applies.

The number of bytes received since boot.

The number of bytes transmitted since boot.

The number of bytes currently being received per second.

The number of bytes currently being transmitted per second.

The number of bytes being received in average, calculated by using the time interval specified with the -a parameter or configured in the configuration file.

The number of bytes being transmitted in average, calculated by using the time interval specified with the -a parameter or configured in the configuration file.

The absolute minimum number of bytes received per second, calculated since starting nload.

The absolute minimum number of bytes transmitted per second, calculated since starting nload.

The absolute maximum number of bytes received per second, calculated since starting nload.

The absolute maximum number of bytes transmitted per second, calculated since starting nload.

The date and time of the log entry as seconds since the Unix Epoch, 1970-01-01 00:00:00 +0000 (UTC).

The microseconds part of the date and time in TimeSeconds.

FILES

$(HOME)/.nload
User-specific configuration file (overrides system-wide settings). Press 'F5' from within nload to save the current settings to this file.

/etc/nload.conf
System-wide configuration file. It uses the same syntax as the user-specific configuration file.

/sys/class/net/*/* /proc/net/dev
are read by nload when running on Linux to get the network traffic data.

VERSION

This manual page describes version 0.7.4 of nload.

For updates, look at the nload homepage:
http://www.roland-riegel.de/nload/

AUTHOR

Copyright (C) 2001 - 2018 Roland Riegel <feedback@roland-riegel.de>

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.

February 6, 2012 nload