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 network 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 applications 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 com-
		       mands to interact with the table.

		       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 number of seconds. The minimum value is 5 seconds, and the default
		       interval is 15 seconds. (Only valid in interactive 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 network 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 applications 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								   May 31, 2019 							    Darwin