netusage(1) BSD General Commands Manual netusage(1)
NAME
netusage -- Display traffic usage statistics about the network
SYNOPSIS
netusage [--help]
netusage commands [arguments ...]
DESCRIPTION
The netusage program interfaces with symptomsd to display and manage net-
work traffic usage statistics.
As additional feature of this tool allows for looking up an application
or process name using a Mach-O UUID or a PID.
NETWORK STATISTICS COMMANDS
The following commands are used to provide different representations of
network traffic usage statistics collected on the system.
--all-traffic [-p] [-r] [-n name] [-s sortorder] [-d importfile] [-e
exportfile] [--unitize] [--compact] [--interactive] [--interval
seconds]
Display a table listing the total ingress and egress network
traffic usage for each application or process categorized by
interface. A timestamp of when the first network traffic was
observed is also shown. By default, only applications will be
shown unless the -p flag is provided.
-p Show a list that includes the combination of applica-
tions and processes.
-r Force a database refresh before showing the list.
-n name Only show the application or process matching name.
-s sortorder
Sort the list according the following available sort
orders:
t Sort by total network usage. (default)
c Sort by cellular interface usage.
w Sort by wi-fi interface usage.
i Sort by wired interface usage.
a Sort by awdl interface usage.
e Sort by expensive interface usage.
-d importfile
Show a traffic usage comparison between the current
values and the contents of the file at importfile.
-e exportfile
Save the current traffic usage values into exportfile.
--unitize
Show the table values in unitized format (eg.
KB/MB/GB).
--compact
When showing a traffic usage comparison, only list the
entries whose values have changed.
--interactive
Show a traffic usage table that periodically refresh
and can be viewed interactively. When an update occurs,
the usage value for the application or process that
generated network traffic will appear emphasized. You
can use the following commands to interact with the ta-
ble.
q Quit
p Toggles the values between showing raw bytes
and unitized format
s Change the sort order of the columns
r Redraw the screen
h Show help
Arrow Keys
Scroll the list
--interval seconds
Set the periodic refresh interval to the specified num-
ber of seconds. The minimum value is 5 seconds, and the
default interval is 15 seconds. (Only valid in interac-
tive mode)
MANAGEMENT COMMANDS
These commands are used to manage and reset the collected network traffic
usage statistics.
--reset-entry [-p] [-n name]
Reset the network traffic usage statistics stored for a single
entry. Use the -n flag (and optionally the -p flag) to specify
the name of the entry.
--unitize name
Specify the name of the application to reset the net-
work usage statistics.
-p Specify a process name instead of an application name.
--reset-all
Reset the network traffic usage statistics for all the stored
entries.
OTHER COMMANDS
These are optional utility commands that are available to look up appli-
cations or processes.
--resolve-uuid uuid
Resolve the given mach-O uuid into an application identifier.
--resolve-pid pid
Resolve the given pid into an application identifier.
Darwin February 4, 2017 Darwin
Mac OS X 10.12.3 - Generated Sat Feb 4 18:12:07 CST 2017