NAME

NetLog - simple uptime and networt traffic monitor


DESCRIPTION

NetLog is a simple perl program that allows you to monitor the uptime and the network traffic of your computer. Therefor it keeps log of these data in a database. NetLog can show the uptime and network traffic for each day, week or month and in many other different ways. It is also able to generate a summary of the shown data and a prognosis for the current month or week.


SYNOPSIS

netlog [options]


OPTIONS

-h, --help

Print help message and exit.

-v, --version

Print version and exit.

-d, --day day

If --day is set, NetLog considers and displays only days where the day is day. --only-recorded will be set automatically.

See the EXAMPLES section for further information.

-m, --month month

If --month is set, NetLog considers and displays only days where the month is month. --only-recorded will be set automatically.

See the EXAMPLES section for further information.

-y, --year year

If --year is set, NetLog considers and displays only days where the year is year. --only-recorded will be set automatically.

See the EXAMPLES section for further information.

-W, --weekly

If --weekly is set, detailed information for each day won't be shown, but NetLog will sum up data for each week.

-M, --monthly

If --monthly is set, detailed information for each day won't be shown, but NetLog will sum up data for each month.

-a, --average

If --average is set in combination with --weekly or --monthly, NetLog won't show the whole uptime or network traffic for each week, but only the daily average. If --average is used without --weekly or --monthly, it does not take effect.

-r, --only-recorded

Consider only days which have an entry in the database, thus only days on which the computer was running. This option only takes effect in the summary.

Normally NetLog counts all days, even those, which have no entry in the database, to generate the summary. Use this option to omit this behavior.

--only-recorded will be set automatically, if --day, --month or --week is set.

-c, --current [{month, week, day}]

Show only days of the current month, week or the current day. An extra prognosis line in the summary will be shown if month or week is selected. If no argument is given, month will be used by default.

-t, --today

Show the current day. The same as --current day.

-s, --sort {uptime, traffic, rx, tx}

Sort the output by uptime, traffic (the sum of rx and tx), rx (downstream network traffic) or tx (upstream network traffic).

-R, --reverse

Print output in reverse order.

-L, --limit num

Limit the output to num entries. The output will be limited after it has been sorted and reversed if necessary.

-l, --last num

Consider only the last num days in database.

-u, --update interfaces

Update the database for the given interfaces. The uptime database will be updated, too.

The interfaces have to be seperatet by commas. If you want to use a space after the comma, you have to put quotation marks (``'') around the interfaces. It is also possibly to use the -u option multible.

See the EXAMPLES section for further information.

-i, --interface interface

Print data for this interface. You can only view data for one interface at once. NetLog will remember the interface, so that it will use it as default the next time.

--nouptime

Do not show the uptime, but only the network traffic.

--noheadline

Do not show the headline. If --machine-readable is set, --noheadline will be used automatically.

--nosummary

Do not show the summary. If --machine-readable is set, --nosummary will be used automatically.

-H, --machine-readable

Print data in a special format which is better to read for other programs. All columns will be separated by a single tabulator. The network traffic values will be shown in KB. --noheadline and --nosummary will be set automatically if --machine-readable is used.

-p, --dbpath path

Set the database directory to path. By default /var/lib/netlog is used.


EXAMPLES

If you want to see your uptime or network traffic of a specific day, for example the 8th September 2006, type:

netlog -d 8 -m 9 -y 2007

To update the database for the interfaces eth0 and eth1 you can use the following commands:

netlog -u eth0,eth1 netlog -u ``eth0, eth1'' netlog -u eth0 -u eth1

The following won't work:

netlog -u eth0, eth1


AUTHOR

Severin Luest <calvin-gr@web.de>


COPYRIGHT

Copyright (c) 2005 - 2007 by Severin Luest. All rights reserved.


LICENSE

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.