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  be‐
       low.

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

       -a period
              Sets the length in seconds of the time window for average calculation.  The default
              is 300.

       -i max_scaling
              Specifies the 100% mark in kBit/s of the graph indicating  the  incoming  bandwidth
              usage.   Ignored  if  max_scaling is 0 or the switch -m is given. The default value
              for max_scaling is 10240.

       -m     Show multiple devices at a time; do not show the traffic graphs.

       -o max_scaling
              Same as -i but for the graph indicating the outgoing bandwidth usage.

       -t interval
              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 measure‐
              ments, but this may not always succeed.

       -u h|H|b|B|k|K|m|M|g|G
              Sets the type of unit used for the display of traffic numbers.  h means human read‐
              able (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.

       -U h|H|b|B|k|K|m|M|g|G
              Same as -u, but for an amount of data, e.g. Bit, kByte, GBit etc.  (without  "/s").
              The default is M.

       devices
              Network  devices  to use. The default is "all", which means to display all auto-de‐
              tected devices.

       -h, --help
              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 avail‐
       able 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.

FILES
       /etc/nload.conf
              System-wide configuration file.

       $(HOME)/.nload
              User-specific configuration file (overrides system-wide settings).

       /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/

HELP
       If you need help, either contact me directly (see below) or write to the nload-user  mail‐
       ing list at
       nload-user@lists.sourceforge.net
       after having subscribed at
       https://lists.sourceforge.net/lists/listinfo/nload-user.

AUTHOR
       Copyright (C) 2001 - 2012 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  ver‐
       sion 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.

nload                                   February 06, 2012                                nload(1)

nload version 0.7.4
Copyright (C) 2001 - 2012 by Roland Riegel <feedback@roland-riegel.de>
nload comes with ABSOLUTELY NO WARRANTY. This is free software, and you are
welcome to redistribute it under certain conditions. For more details see the
GNU General Public License Version 2 (http://www.gnu.org/copyleft/gpl.html).

Command line syntax:
nload [options] [devices]
nload --help|-h

Options:
-a period       Sets the length in seconds of the time window for average
                calculation.
                Default is 300.
-i max_scaling  Specifies the 100% mark in kBit/s of the graph indicating the
                incoming bandwidth usage. Ignored if max_scaling is 0 or the
                switch -m is given.
                Default is 10240.
-m              Show multiple devices at a time; no traffic graphs.
-o max_scaling  Same as -i but for the graph indicating the outgoing bandwidth
                usage.
                Default is 10240.
-t interval     Determines the refresh interval of the display in milliseconds.
                Default is 500.
-u h|b|k|m|g    Sets the type of unit used for the display of traffic numbers.
   H|B|K|M|G    h: auto, b: Bit/s, k: kBit/s, m: MBit/s etc.
                H: auto, B: Byte/s, K: kByte/s, M: MByte/s etc.
                Default is h.
-U h|b|k|m|g    Same as -u, but for a total amount of data (without "/s").
   H|B|K|M|G    Default is H.
devices         Network devices to use.
                Default is to use all auto-detected devices.
--help
-h              Print this help.

example: nload -t 200 -i 1024 -o 128 -U M

The options above can also be changed at run time by pressing the 'F2' key.