internode-quota-check

NAME

internode-quota-check - Usage information for your Internode accounts

USAGE

internode-quota-check

OPTIONS

--man

Print the manual page and exit.

--help

Print a brief help message and exit.

DESCRIPTION

This program retrieves quota usage information for Internode accounts, for example,

    $ internode-quota-check
     mark: 21.583 GB (27.0%) and 5.1 days (16.5%) left of 80 GB, 24 Mb/s plan.
    suter: 35.036 GB (63.7%) and 5.1 days (16.5%) left of 55 GB, 24 Mb/s plan.

CONFIGURATION

$ENV{HOME}/.fetchmailrc and/or $ENV{HOME}/.netrc

Where this program gets the usernames and passwords. This program does nothing else with these files, nor email or ftp for that matter.

If you are using fetchmail for your Internode email, it should work.

If you have multiple accounts defined, then this program will display the quota usage for each account, one per line.

This program understands implicit usernames and using your ~/.netrc file if the details aren't all in the ~/.fetchmailrc.

If you are not using fetchmail for your Internode email, then put a comment into this file, creating it if needed:

    # poll mail.internode.on.net user "example" password "secret"

This program will honour the FETCHMAILHOME environment variable, that is, read $FETCHMAILHOME/fetchmailrc instead of the normal one on your home directory. Refer to the fetchmail man page for more details.

$ENV{HOME}/.internode-quota-check.cache

Where this program stores it's cache. If the data is older than one (1) hour, or the file missing, this program fetches fresh data from Internode and updates this file.

MISSING MODULES

Errors like "Can't locate ModuleName.pm in @INC ..." mean that you need to install extra modules. On Debian and Debian-derived systems (for example, Ubuntu), this command should install all the necessary modules:

 $ sudo aptitude install libreadonly-perl libtime-local-perl libwww-mechanize-perl

For other systems, there should be a similar procedure to take advantage of the local packaging tool, for example, yum or yast.

EXIT STATUS

If this program exits with a zero exit status and the correct output is on standard output. Nothing else is ever printed to standard output.

This program will exit with a non-zero exit status if there was a fatal error. Both fatal and non-fatal errors will cause output on standard error.

THANKS

This tool would not exist without Perl and the CPAN modules written by many authors around the world.

Thanks to Mark Newton at Internode who created the interface to the billing system.

Thanks to Trent W. Buck for improvements making the single line of output more understandable and readily usable.

Thanks to Michael T. Pope for letting me know about the alternative fetchmailrc location.

Thanks to Jan Marecek for tweaks to the parsing of the fetchmailrc file.

Thanks to to Mark Mickan for a much more elegant way to calculate the days in the billing month.

Thanks to Chris Giles for the suggestions on improving the cache handling between versions, some formatting improvements and a bug report about http 500 errors (sub mech_get was improved).

Thanks to Kevin Shanahan for the patch to fix my bug with sort (default sort uses a string comparison).

Thanks to Trent Buck for a patch to use File::Slurp.

Thanks to Chris Bunney for a bug report on the new unlimited plans (dividing by a zero quota gives an illegal division).

SEE ALSO

http://www.internode.on.net/support/tools/usage_meters/

AUTHOR

Mark Suter <suter@zwitterion.org>

LICENSE AND COPYRIGHT

internode-quota-check - Usage information for your Internode accounts Copyright (C) 2004-2017 Mark Suter <suter@zwitterion.org>

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 3 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, see https://www.gnu.org/licenses/.