{
    "mode": "man",
    "parameter": "iptraf-ng",
    "section": "8",
    "url": "https://www.chedong.com/phpMan.php/man/iptraf-ng/8/json",
    "generated": "2026-06-14T05:55:16Z",
    "synopsis": "iptraf-ng { [ -f ] [ { -i iface | -g | -d iface | -s iface | -z iface | -l iface } [ -t time‐\nout ] [ -B [ -L logfile ] ] ] | [ -h ] }",
    "sections": {
        "NAME": {
            "content": "iptraf - Interactive Colorful IP LAN Monitor\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "iptraf-ng { [ -f ] [ { -i iface | -g | -d iface | -s iface | -z iface | -l iface } [ -t time‐\nout ] [ -B [ -L logfile ] ] ] | [ -h ] }\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "iptraf-ng is an ncurses-based IP LAN monitor that generates various  network  statistics  in‐\ncluding  TCP  info, UDP counts, ICMP and OSPF information, Ethernet load info, node stats, IP\nchecksum errors, and others.\n\nIf the iptraf-ng command is issued without any command-line options, the program comes up  in\ninteractive mode, with the various facilities accessed through the main menu.\n\n",
            "subsections": []
        },
        "OPTIONS": {
            "content": "These options can also be supplied to the command:\n",
            "subsections": [
                {
                    "name": "-i",
                    "content": "immediately start the IP traffic monitor on the specified interface, or all interfaces\nif \"-i all\" is specified\n",
                    "flag": "-i"
                },
                {
                    "name": "-g",
                    "content": "",
                    "flag": "-g"
                },
                {
                    "name": "-d",
                    "content": "allows you to immediately start the detailed on the indicated interface (iface)\n",
                    "flag": "-d"
                },
                {
                    "name": "-s",
                    "content": "allows you to immediately monitor TCP and  UDP  traffic  on  the  specified  interface\n(iface)\n",
                    "flag": "-s"
                },
                {
                    "name": "-z",
                    "content": "shows packet counts by size on the specified interface\n",
                    "flag": "-z"
                },
                {
                    "name": "-l",
                    "content": "start the LAN station monitor on the specified interface, or all LAN interfaces if \"-l\nall\" is specified\n",
                    "flag": "-l"
                },
                {
                    "name": "-t",
                    "content": "tells IPTraf-ng to run the specified facility for only timeout minutes.   This  option\nis used only with one of the above parameters.\n",
                    "flag": "-t"
                },
                {
                    "name": "-B",
                    "content": "into the background.  Can be used only with one of the facility invocation  parameters\nabove.  Send the backgrounded process a USR2 signal to terminate.\n",
                    "flag": "-B"
                },
                {
                    "name": "-L logfile",
                    "content": "allows  you to specify an alternate log file name.  The default log file name is based\non either the interface selected (detailed interface statistics, TCP/UDP service  sta‐\ntistics,  packet size breakdown), or the instance of the facility (IP traffic monitor,\nLAN station monitor).  If a  path  is  not  specified,  the  log  file  is  placed  in\n/var/log/iptraf-ng\n",
                    "flag": "-L"
                },
                {
                    "name": "-f",
                    "content": "first one running.  This should only be used to recover from an  abnormal  termination\nor system crash.\n",
                    "flag": "-f"
                },
                {
                    "name": "-h",
                    "content": "",
                    "flag": "-h"
                }
            ]
        },
        "SIGNALS": {
            "content": "SIGUSR1 - rotates log files while program is running\nSIGUSR2 - terminates an IPTraf-ng process running in the background.\n\n",
            "subsections": []
        },
        "FILES": {
            "content": "/var/log/iptraf-ng/*.log - log file\n/var/lib/iptraf-ng/* - important IPTraf-ng data files\n\n",
            "subsections": []
        },
        "SEE ALSO": {
            "content": "Documentation/* - complete documentation written by the author\n\n",
            "subsections": []
        },
        "AUTHOR": {
            "content": "Gerard Paul Java (riker@mozcom.com)\n\n",
            "subsections": []
        },
        "MANUAL AUTHOR": {
            "content": "Frederic Peters (fpeters@debian.org), using iptraf-ng -h General manual page modifications by\nGerard Paul Java (riker@mozcom.com), Phil Cameron (pcameron@redhat.com)\n\n\n\n\nIPTraf-ng Help Page                            IPTRAF-NG(8)",
            "subsections": []
        }
    },
    "summary": "iptraf - Interactive Colorful IP LAN Monitor",
    "flags": [
        {
            "flag": "-i",
            "long": null,
            "arg": null,
            "description": "immediately start the IP traffic monitor on the specified interface, or all interfaces if \"-i all\" is specified"
        },
        {
            "flag": "-g",
            "long": null,
            "arg": null,
            "description": ""
        },
        {
            "flag": "-d",
            "long": null,
            "arg": null,
            "description": "allows you to immediately start the detailed on the indicated interface (iface)"
        },
        {
            "flag": "-s",
            "long": null,
            "arg": null,
            "description": "allows you to immediately monitor TCP and UDP traffic on the specified interface (iface)"
        },
        {
            "flag": "-z",
            "long": null,
            "arg": null,
            "description": "shows packet counts by size on the specified interface"
        },
        {
            "flag": "-l",
            "long": null,
            "arg": null,
            "description": "start the LAN station monitor on the specified interface, or all LAN interfaces if \"-l all\" is specified"
        },
        {
            "flag": "-t",
            "long": null,
            "arg": null,
            "description": "tells IPTraf-ng to run the specified facility for only timeout minutes. This option is used only with one of the above parameters."
        },
        {
            "flag": "-B",
            "long": null,
            "arg": null,
            "description": "into the background. Can be used only with one of the facility invocation parameters above. Send the backgrounded process a USR2 signal to terminate."
        },
        {
            "flag": "-L",
            "long": null,
            "arg": null,
            "description": "allows you to specify an alternate log file name. The default log file name is based on either the interface selected (detailed interface statistics, TCP/UDP service sta‐ tistics, packet size breakdown), or the instance of the facility (IP traffic monitor, LAN station monitor). If a path is not specified, the log file is placed in /var/log/iptraf-ng"
        },
        {
            "flag": "-f",
            "long": null,
            "arg": null,
            "description": "first one running. This should only be used to recover from an abnormal termination or system crash."
        },
        {
            "flag": "-h",
            "long": null,
            "arg": null,
            "description": ""
        }
    ],
    "examples": [],
    "see_also": []
}