Added scripts for updating Linux Counter.

1 files changed, 1117 insertions, 0 deletions

diff --git a/machine-update-beta b/machine-update-beta
new file mode 100755
index 0000000..6a4db3e
--- /dev/null
+++ b/machine-update-beta
@@ -0,0 +1,1117 @@
+#!/usr/bin/perl -w
+# For Emacs: -*- mode:cperl; mode:folding; -*-
+#
+# Get a machine's critical features, And mail/http them to the Linux Counter
+#
+# (c) 1999 - Harald Tveit Alvestrand, the Linux Counter Project
+#     2003 - PetaMem Group (www.petamem.com)
+# License:   GNU Copyleft - see bottom of file.
+# Changelog: see even more bottom of the file
+#
+# As a matter of courtesy, if you change this file on your own,
+# make sure it does NOT mail to the counter!
+#
+use strict;
+use POSIX;
+
+our $VERSION     = '0.20';
+our $CVS_VERSION = '$Revision: 1.1 $ $Date: 2005-03-11 16:57:22 $ $Author: jonas $';
+our $IsInTestHarness;
+use vars qw(%values %oldvalues $errordata $debugdata); # data that is sent
+use vars qw($progname %option);
+use vars qw(%is_sys_account %is_user %is_account);
+
+# Some variables are for internal use, and never prompted for in
+# the loop of askquestions
+our %dontask = ('uniqueid' => 1,	# Internal use
+		'manual'   => 1,
+		'method'   => 1,
+		'owner'    => 1,	# These 2 are always prompted for
+		'key'      => 1,
+		'uptime'   => 1,	# We think we know how to get these
+	       );
+
+# stuff that controls defaults for passwdscan & accounts subroutines
+my ($UID_MIN, $UID_MAX, $got_defs) = (100, 65533, '');
+
+# Make sure nothing happens, so that the script's routines
+# can be debugged from another file
+return 1 if($IsInTestHarness);
+
+&preparation;
+&options;
+
+&readfile;
+&checkconfig;
+
+if ($option{ask}) {
+  &askquestions;
+} else {
+  &copymanuals;
+}
+
+&writefile;
+&sendfile;
+
+# {{{ preparation
+
+#
+sub preparation {
+  die "No HOME environment variable\n" if (!$ENV{HOME});
+  die "No home diretory\n" if ! -d $ENV{HOME};
+  my $infodir = "$ENV{HOME}/.linuxcounter";
+  if (! -d $infodir) {
+    mkdir($infodir, 0766) || die "Unable to make $infodir\n";
+  }
+  # Keep track of where I am; need it to install crontab entry
+  # progname is a global.
+  $progname = $0;
+  if ($progname !~ /^\//) {
+    my $progdir = `pwd`;
+    chop $progdir;
+    $progname = "$progdir/$progname";
+    $progname =~ s!/./!/!;
+  }
+  chdir($infodir) || die "Unable to change to $infodir\n";
+  my ($sysname, $nodename, $release, $version, $machine ) = POSIX::uname();
+  if (! -f $nodename) {
+    print STDERR "Machine-update $VERSION. Use $0 -l to display license.\n";
+    print STDERR "Creating the infofile for your computer.\n";
+    # Create the infodir
+    open(INFO, ">$nodename");
+    print INFO "uniqueid: ", randomnumber(), "\n";
+    close INFO;
+  }
+
+  srand time % $$;            # do some seed "randomization"
+}
+
+# }}}
+# {{{ options
+
+#
+sub options {
+  my $opt;
+
+  while (defined($ARGV[0]) && $ARGV[0] =~ /^-/) {
+    $opt = shift @ARGV;
+    $opt =~ /c/ && &installcrontab;
+    $opt =~ /d/ && $option{DEBUG}++ && print STDERR "Debug is $option{DEBUG}\n";
+    $opt =~ /h/	&& &help;
+    $opt =~ /i/ && ($option{ask}  = 1);
+    $opt =~ /l/ && &license;
+    $opt =~ /m/ && ($option{mail} = 1);
+    $opt =~ /t/ && ($option{mail} = 0);
+    $opt =~ /u/ && &uninstallcrontab;
+    $opt =~ /v/ && die "\n\t Linux Counter machine-update version $VERSION\n"
+      . "\tCVS version $CVS_VERSION\n";
+    $opt =~ /x/ && ($option{info} = 1);
+  }
+}
+
+# }}}
+
+# {{{ askquestions
+
+#
+sub askquestions {
+  return if ! -t STDIN || ! -t STDOUT;
+  $| = 1;
+  print "Here you can specify some info that the script can't know for itself\n";
+  $values{owner} = askone("Your Linux Counter reg#, if any", $values{owner});
+  $values{key}   = askone("Your machine's counter reg#, if any", $values{key});
+  print "Here is what the program has found:\n";
+  for my $key (keys(%values)) {
+    if (!$dontask{$key}) {
+      printf "%-10s%1s: %s\n", $key, $dontask{$key}?"*":" ", $values{$key};
+    }
+  }
+  my $domore = &askone('Do you want to override some of the found values?', 'no');
+  if ($domore =~ /^Y/i) {
+    my $manual;
+    for my $key (keys(%values)) {
+      next if $dontask{$key};
+      my $value = &askone($key, $oldvalues{$key}, $values{$key});
+      if ($values{$key} eq $value) {         # go to automatic
+	&Debug("auto value: $key\n");
+      } else {
+	&Debug("still manual value: $key\n");
+	$manual .= " $key";
+      }
+      $values{$key} = $value;
+    }
+    $values{manual} = $manual;
+  } else {
+    delete $values{manual};
+  }
+}
+
+# }}}
+# {{{ askone
+#
+sub askone {
+  my $prompt  = shift;
+  my $default = shift;
+  my $probed  = shift;
+
+  print $prompt;
+  if (!defined($default) && defined($probed)) {
+    $default = $probed;
+  }
+  if (defined($default)) {
+    print " [$default]";
+  }
+  if (defined($probed) && $probed ne $default) {
+    print "(program found $probed)";
+  }
+  print ':';
+
+  my $ans = <STDIN>;
+
+  chop $ans;
+  &Debug("Answer was $ans\n");
+  $ans = $default if (!length($ans));
+
+  return $ans;
+}
+# }}}
+
+# {{{ copymanuals
+#
+sub copymanuals {
+  my %keeps;
+  if ($values{manual}) {
+    %keeps = map {$_ => 1} split(' ', $values{manual});
+  }
+
+  &Debug('Keeping '.join(' ', keys(%keeps))."\n");
+  for my $key (keys(%keeps)) {
+    $values{$key} = $oldvalues{$key};
+  }
+}
+# }}}
+
+# {{{ readfile
+
+#
+sub readfile {
+  my ($sysname, $nodename, $release, $version, $machine ) = POSIX::uname();
+  open(INFO, $nodename) || die "Did not find infofile $nodename\n";
+  while (<INFO>) {
+    chop;
+    s/#.*//;
+    if (/^(\S+): *(.+)/) {
+      &Debug("Read $1: $2\n");
+      $values{$1} = $2;
+    } else {
+      print STDERR "Unparsed info line: $_ - discarded\n";
+    }
+  }
+  close INFO;
+  %oldvalues = %values;
+}
+
+# }}}
+# {{{ writefile
+
+#
+sub writefile {
+  my ($sysname, $nodename, $release, $version, $machine ) = POSIX::uname();
+
+  open(INFO, ">$nodename.new");
+  for my $val (sort keys(%values)) {
+    &Debug("Saving $val: $values{$val}\n");
+    print INFO "$val: $values{$val}\n";
+  }
+  close INFO;
+  rename("$nodename.new", $nodename) || die "Rename failed\n";
+}
+
+# }}}
+# {{{ sendfile
+
+#
+sub sendfile {
+  if ($option{mail}) {
+    open(MAIL, "|/usr/lib/sendmail machine-registration\@counter.li.org")
+      || die "Unable to open sendmail\n";
+  } else {
+    warn "--------------------------------------------------------\n";
+    warn "This is what will be sent to the Linux Counter if you\n";
+    warn "run the program with the -m switch. Now, NOTHING IS SENT\n";
+    warn "--------------------------------------------------------\n";
+    open(MAIL, ">&STDOUT");
+  }
+  # note that $ENV{USER} isn't (always) set in a cron job...
+  my $user = (getpwuid($<))[0];
+  $user = "unknown-id-$<" if !$user;
+  print MAIL <<EOF
+From: $user
+To: machine-registration\@counter.li.org
+Subject: machine-update for $values{name}
+
+//MACHINE
+EOF
+    ;
+  for my $val (sort keys(%values)) {
+    print MAIL "$val: $values{$val}\n"
+      if length($values{$val}) > 0;
+  }
+  print MAIL "//END\n";
+  # Attach possible other info
+  if ($errordata) {
+    print MAIL "----- Problem info gathered during probing -----\n";
+    print MAIL $errordata;
+  }
+  $option{info} && do {
+    print MAIL "----- Debug data for the script maintainer's aid -----\n";
+    print MAIL $debugdata;
+  };
+  close MAIL;
+}
+
+# }}}
+
+# {{{ randomnumber
+#
+sub randomnumber {
+  return int(rand(1_000_000_000));
+}
+# }}}
+
+# {{{ checkconfig
+
+#
+sub checkconfig {
+  my ($sysname, $nodename, $release, $version, $machine ) = POSIX::uname();
+
+  warn "This is not Linux, but $sysname!\n" if($sysname ne 'Linux');
+  $values{method}    = "machine-update version $VERSION";
+  $values{os}        = $sysname;
+  $values{kernel}    = $release;
+  $values{cpu_uname} = $machine;
+  $values{name}      = $nodename;	# First order guess
+
+  # Credit for some of the code below goes to
+  # Denis Havlik: <havlik@ap.univie.ac.at>
+  # Blame is, of course, all mine - HTA -
+  # Note - there are numerous problems with df, including:
+  # - early versions don't support the -l option
+  # - at least some include SAMBA filesystems in the -l option
+  open (TMP,"df -l -x shm |");   # exclude shmfs, its 50% of RAM (mostly)
+  my $HD = 0;
+  while (<TMP>) {
+    my @line = split(/\s+/);
+    ($line[0] =~ /\/dev/) && ($HD += $line[1]);
+  }
+  &Debug("$HD kbytes of disk found\n");
+  $HD /= 1024;
+  $values{disk}     = sprintf("%d", $HD);
+  $values{accounts} = &accounts;
+  $values{users}    = &active_users;
+
+  my $uptime = &xbin('uptime');
+  if($uptime) {
+    $uptime = `$uptime`;
+    # get the uptime string here (could be more elegant, but so it is
+    # robust against various localizations)
+    if ($uptime =~ /^\s+[^\s]+\s+[^\s]+\s+([^,]+), /) {
+      $values{uptime} = $1;
+    } else {
+      &ErrorInfo("Can't parse uptime output: $uptime\n");
+    }
+    if ($option{info}) {
+      &DebugInfo("***** Uptime output *****\n$uptime");
+    }
+  }
+  # Not sure this is a Right Thing...so not saving it for the moment
+  # This section based on a patch from Mark-Jason Dominus <mjd@plover.com>
+  # try to guess mailer based on content of /usr/lib/sendmail link
+  if (-l '/usr/lib/sendmail') {
+    my $realsendmail = readlink('/usr/lib/sendmail');
+    if ($realsendmail eq '../sbin/sendmail') {
+      $realsendmail = '/usr/sbin/sendmail';
+      if (-l $realsendmail) {
+	$realsendmail = readlink($realsendmail);
+      }
+    }
+    if ($realsendmail =~ m{^/var/qmail}) {
+      $values{mailer} = "qmail";
+    } else {
+      &DebugInfo("Found sendmail as a link to $realsendmail\n");
+    }
+  }
+  # Link method did not work. Try to guess based on presence of
+  # config files. (this is more susceptible to the old-junk problem)
+  if (!$values{mailer}) {
+    if ( -d '/var/qmail') {
+      $values{mailer} = 'qmail';
+    } elsif ( -f '/etc/sendmail.cf') {
+      $values{mailer} = 'sendmail';
+    } elsif ( -d '/etc/postfix') {
+      $values{mailer} = 'postfix';
+    }
+  }
+
+  # forget about /proc/kcore: It's not reliable above 960MB. It also doesn't show
+  #                           real memory, because some may be eaten by graphics
+  # forget also about the "free" command: We don't want to be dependant on that
+  $values{memory} = int(&getval_from_file('/proc/meminfo',1,1) / (1024*1024));
+  # But actually: Shouldn't we return the total of virtual memory here? Seems to
+  # be relevant to me - RJ -
+
+  &cpuinfo;
+}
+
+# }}}
+
+# {{{ cpuinfo
+
+#
+sub cpuinfo {
+  my $cpufile   = '/proc/cpuinfo';           # Linux: Place to get info on CPU
+  my %interesting = (# 2.0 and 2.2 kernels
+		     'bogomips'  => '+bogomips',
+		     'processor' => '1+processors',
+		     'vendor_id' => 'cpu_vendor',
+		     # 2.0 kernels
+		     'cpu'        => 'cpu_only',
+		     'model'      => 'cpu_model',
+		     'model name' => 'cpu_model_name',
+		     # 2.2 kernels
+		     'cpu MHz'    => 'cpu_mhz',
+		     'cpu family' => 'cpu_family',
+		     # from an Alpha processor
+		     'cycle frequency [Hz]' => 'cpu_hz',
+		     'BogoMIPS'             => '+bogomips',
+		     'cpu model'            => 'cpu_model',
+		     'system type'          => 'cpu_system_type',
+		     'cpus detected'        => 'processors',
+		     # from a PowerMAC
+		     'machine'     => 'cpu_machine',
+		     'clock'       => 'cpu_clock',
+		     'motherboard' => 'cpu_motherboard',
+		     # from an UltraSparc
+		     'BogoMips'     => '+bogomips',
+		     'ncpus active' => 'processors',
+		    );
+
+  # Zero out the accumulative values
+  $values{bogomips}   = 0;
+  $values{processors} = 0;
+  if (open (TMP,"<$cpufile")) {
+    &DebugInfo("**** Contents of $cpufile ****\n");
+    while (<TMP>) {
+      &DebugInfo($_);            # Save /proc/cpuinfo to debugdata if -d
+      chop;
+      # A bizarre selection of names are "interesting".
+      # Make a data-driven pick routine
+      if (/^(\S+[^:]+\S)\s+: /) {
+	my $name  = $1;
+	my $value = $';
+	if ($interesting{$name}) {
+	  if ($interesting{$name} =~ /^\+/) {
+	    $values{$'} += $value;
+	  } elsif ($interesting{$name} =~ /^1\+/) {
+	    $values{$'}++;
+	  } else {
+	    $values{$interesting{$name}} = $value;
+	  }
+	}
+      }
+    }
+  } else {
+    &ErrorInfo("Could not open $cpufile\n");
+  }
+}
+
+# }}}
+
+# {{{ accounts
+
+#
+sub accounts {
+  my $s;
+  my $niss;
+  my $ypcatbin;                # will hold path to the ypcat binary (if any)
+
+  open (TMP,"</etc/passwd");
+  $s += &passwdscan;
+  &DebugErr("Found $s accounts total\n");
+  &Debug("Switching to NIS passwords\n");
+
+  $ypcatbin = &xbin('ypcat');  # get path to ypcat binary (empty if none)
+  if($ypcatbin) {              # test whether ypcat was found
+    open TMP, "$ypcatbin passwd 2> /dev/null|"
+      || ($errordata .= "ypcat failed: $!\n");
+    $niss = &passwdscan;
+    $s   += $niss;
+    close TMP;
+    &Debug("Status of ypcat: $?\n");
+    &DebugErr("Found $niss accounts in ypcat passwd\n");
+  }
+
+  &DebugErr('Sysaccounts: ', join(' ', keys(%is_sys_account)), "\n");
+  &DebugErr("Found $s accounts total\n");
+
+  return $s;
+}
+
+# }}}
+# {{{ passwdscan
+
+#
+sub passwdscan {
+  # Code for reading login.defs courtesy of Vassilii Khachaturov
+  # <vassilii@tarunz.org>
+  local (*DEFS);
+  # Try importing UID_MIN and UID_MAX from /etc/login.defs, if possible
+  # else just assume the above defaults for min and max non-system UID
+  if (!$got_defs && open (DEFS, '/etc/login.defs')) {
+    while (<DEFS>) {
+      if (/^\s*(UID_(?:MIN|MAX))\s+(\d+)/) {
+	# elegant, but not compatible with "strict refs":
+	#${ $1 } = $2;
+	if ($1 eq "UID_MIN") {
+	  $UID_MIN = $2;
+	} else {
+	  $UID_MAX = $2;
+	}
+	&Debug("DEFS match: $1 = $2\n");
+      }
+    }
+    close (DEFS);
+    $got_defs = 1;
+  }
+  &Debug("UID_MIN = $UID_MIN, UID_MAX = $UID_MAX\n");
+  # I suppose this is as good as it gets - 
+  #   Usually user accounts have UID > 100 and 
+  #   "system accounts" have UID < 100, but there is no guarantee   
+  # that 
+  #   this will hold for pseudo-users like "postgress" etc.
+  # Also nobody is usually 99 on linux, but -1 on "standard" unices.
+  # RedHat places the dividing line at 500. Others use 400...
+  my @line;
+  my $s = 0;
+
+  while (<TMP>) {
+    @line = split ':';
+    if ($line[2] >= $UID_MIN && $line[2] <= $UID_MAX
+	&& !($line[0] eq 'nobody')) {
+      $s++;
+      $is_account{$line[0]} = 1;
+    } else {
+      $is_sys_account{$line[0]} = 1;
+    }
+  }
+
+  return $s;
+}
+
+# }}}
+# {{{ active_users
+
+#
+# This is kind of alpha, but please test it.
+# It calculates the number of "active" users based on the "wtmp" entries
+# unfortunately at least Mandrake 8 and 9 ship with non-world-read wtmp
+# and non-set-uid last, so this does not work any more...
+#
+# RJ: Actually I think the best thing to do is to bury this code and be silent about it.
+#
+sub active_users {
+  my $userslisted;
+
+  for (qw(reboot wtmp runlevel)) {  # This sysaccounts shouldn't be counted. Who else?
+    $is_sys_account{$_} = 1;
+  }
+  open( TMP, "/usr/bin/last 2>&1|");
+  while (<TMP>) {
+    chop;
+    if (m!/var/log/wtmp: Permission denied!) { # RJ: ***Boom*** on every non-EN system
+      &ErrorInfo("/usr/bin/last failed because /var/log/wtmp isn't readable\n");
+      last;
+    }
+    last if(!$_);                            # RJ: quick hack to safe bad code from harm
+    my @tmp  = split;
+    my $name = $tmp[0];
+    if ($is_sys_account{$name}) {
+      # do nothing
+    } elsif (defined $is_account{$name}) {
+      $is_user{$name} = 1;
+    } elsif (/^\s*$/) {                      # blank line - do nothing
+    } elsif ($#tmp == 9) {                   # OK line, but unknown user
+      $option{DEBUG} && do {
+	if (!$userslisted) {
+	  print STDERR 'Know users are: ',
+	    join(' ', keys(%is_account)), "\n";
+	  $userslisted = 1;
+	}
+	print STDERR "Unknown user: $name\n";
+      }
+    } else {
+      &DebugErr("Strange line: $_\n");
+    }
+  }
+  close TMP;
+  my $i = 0;
+  for (sort keys %is_user) {
+    $option{DEBUG} && printf "Active user %3d: %s\n", ++$i, $_;
+  }
+  &Debug("$i active users found.\n");
+
+  return $i;
+}
+
+# }}}
+
+# {{{ installcrontab
+
+#
+sub installcrontab {
+  my $hour = int(rand(24));
+  my $min  = int(rand(60));
+  my $day  = int(rand(7));	# Weekday. This version runs once a week.
+  my $cron;
+
+  warn "Installing start of script into your crontab\n";
+  if (open(CRON, "crontab -l |")) {
+    &Debug("Checking crontab for machine-update\n");
+    &Debug("Want to install as $progname\n");
+    while (<CRON>) {
+      if (/^#/ && $. <= 3) {	# initial comment
+	&Debug("Skipping comment: $_");
+	next;
+      }
+      if (/machine-update/) {
+	if (/ $progname -m/) {
+	  die "Crontab entry already installed: $_\n";
+	} else {
+	  die "Another entry with machine-update: $_\n";
+	}
+      }
+      $cron .= $_;
+    }
+    close CRON;
+    &Debug("Result from crontab -l: ", $? / 256, "\n");
+    if ($? == 0) {
+      &Debug("Crontab successfully read\n");
+    } elsif ($? == 256) {
+      warn "You don't seem to have a crontab. I will create one.\n";
+    } else {
+      die "Failed to read your crontab. Please report this as a bug: $?\n";
+    }
+  } else {
+    &Debug("Result from crontab open(): $?\n");
+    die "Unable to execute crontab command. Please check your system\n";
+  }
+  open(CRON, "|crontab -");
+  print CRON $cron;
+  print CRON "$min $hour * * $day $progname -m\n";
+  close CRON;
+  &Debug("Result from crontab: $?\n");
+  if ($?) {
+    die(<<EoF);
+Installing new crontab failed.
+YOUR CRONTAB MAY BE DAMAGED - use crontab -l to check it.
+Here's its former content (if any):
+
+$cron
+
+EoF
+  }
+  print "Crontab entry successfully installed.\nWill run on day $day of every week, at $hour:$min\n";
+
+  exit 0;
+}
+
+# }}}
+# {{{ uninstallcrontab
+
+#
+sub uninstallcrontab {
+  my $found = 0;
+  my $cron;
+
+  print STDERR "Removing $progname from your crontab\n";
+  open(CRON, "crontab -l |");
+  &Debug("Checking crontab for machine-update\n");
+  &Debug("Want to uninstall as $progname\n");
+  while (<CRON>) {
+    if (/^#/ && $. <= 3) {	# initial comment
+      &Debug("Skipping comment: $_");
+      next;
+    }
+    if (/machine-update/) {
+      if (/ $progname -m/) {
+	print STDERR "Crontab entry found and removed\n";
+	$found = 1;
+	next;			# skip stuff at end....
+      } else {
+	die "Another entry with machine-update: $_\nUninstall manually?\n";
+      }
+    }
+    $cron .= $_;
+  }
+  close CRON;
+  &Debug("Result from crontab -l: $?\n");
+  if ($?) {
+    die "Failed to read your crontab. You may not have one?\n";
+  }
+  if ($found) {
+    open(CRON, "|crontab -");
+    print CRON $cron;
+    close CRON;
+    &Debug("Result from crontab: $?\n");
+    if ($?) {
+      die(<<EoF);
+Installing new crontab failed.
+YOUR CRONTAB MAY BE DAMAGED - use crontab -l to check it.
+Here's its former content (if any):
+
+$cron
+
+EoF
+    }
+  } else {
+    print STDERR "No instance of $progname found in your crontab\n";
+  }
+
+  exit 0;
+}
+
+# }}}
+
+# {{{ xbin                       execute a linux binary
+
+#
+# This sub is to execute a linux binary robustly. i.e. testing
+# whether it is present, where it is present, whether it is executable
+#
+sub xbin {
+  my $bin = shift;             # get name of binary to execute
+
+  $bin = `which $bin`;         # determine binarys full path
+  chomp $bin;
+  return $bin if(-x $bin);     # if there and executable: all is well - return it
+
+  if(!$bin) {                  # if not there
+    &Debug("No $bin found\n"); # state so
+  } else {                     # there but not executable
+    &Debug("$bin found, but not executable\n");
+  }
+
+  return '';                   # so return an empty string (binary will not exec)
+}
+
+# }}}
+# {{{ getval_from_file           get value from system file @ row,col
+
+#
+sub getval_from_file {
+  my $file = shift;
+  my $row  = shift;
+  my $col  = shift;
+  my @file;
+  my @cols;
+
+  if (!(-r $file)) {
+    &DebugErr("File $file not readable\n");
+    return '';
+  }
+  sysopen(FH,$file, O_RDONLY);
+  @file = <FH>;                     # read whole file to array
+  close FH;
+
+  @cols = split /\s+/, $file[$row]; # get the right row
+
+  return $cols[$col];               # return the right column
+}
+
+# }}}
+
+# {{{ Debug                      print debug information if flag is set
+
+#
+sub Debug {
+  $option{DEBUG} && print @_;
+}
+
+# }}}
+# {{{ DebugErr                   print debug on STDERR if flag is set
+
+#
+sub DebugErr {
+  $option{DEBUG} && print STDERR @_;
+}
+
+# }}}
+# {{{ ErrorInfo
+sub ErrorInfo {
+  $errordata .= join('', @_);
+}
+# }}}
+# {{{ DebugInfo
+
+sub DebugInfo {
+  $option{info} && ($debugdata .= join('', @_));
+}
+
+# }}}
+
+# {{{ help                       print help & exit
+
+#
+sub help {
+  my $host = `uname -n`;
+
+  print <<EoF;
+machine-update version $VERSION
+Send machine information to the Linux Counter
+
+USE: machine-update [-i] [-(t|d|l|m|v|x|c|u|h)]
+
+SWITCHES:
+ -i = interactive
+ -t = test (do not send e-mail, just print it ot STDOUT - default)
+ -d = debug (test, and print additional debug informations)
+ -l = display license
+ -m = mail results to linux-counter
+ -v = print version and exit
+ -x = send extra info to server (Debug)
+ -c = install crontab entry
+ -u = uninstall crontab entry
+ -h = print usage information and exit
+If called interactively, will ask some questions and store the
+answers in $ENV{HOME}/.linuxcounter/$host
+
+EoF
+
+exit 0;
+}
+
+# }}}
+# {{{ license                    print license & exit
+
+#
+sub license {
+  print <<EoF;
+
+    Linux Counter Machine Update version $VERSION
+
+    Copyright (C) 1999 Harald Tveit Alvestrand
+                  2003 PetaMem Group (www.petamem.com)
+
+    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.
+
+    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 below for more details.
+
+
+		    GNU GENERAL PUBLIC LICENSE
+		       Version 2, June 1991
+
+ Copyright (C) 1989, 1991 Free Software Foundation, Inc.
+                          675 Mass Ave, Cambridge, MA 02139, USA
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+			    Preamble
+
+  The licenses for most software are designed to take away your
+freedom to share and change it.  By contrast, the GNU General Public
+License is intended to guarantee your freedom to share and change free
+software--to make sure the software is free for all its users.  This
+General Public License applies to most of the Free Software
+Foundation's software and to any other program whose authors commit to
+using it.  (Some other Free Software Foundation software is covered by
+the GNU Library General Public License instead.)  You can apply it to
+your programs, too.
+
+  When we speak of free software, we are referring to freedom, not
+price.  Our General Public Licenses are designed to make sure that you
+have the freedom to distribute copies of free software (and charge for
+this service if you wish), that you receive source code or can get it
+if you want it, that you can change the software or use pieces of it
+in new free programs; and that you know you can do these things.
+
+  To protect your rights, we need to make restrictions that forbid
+anyone to deny you these rights or to ask you to surrender the rights.
+These restrictions translate to certain responsibilities for you if you
+distribute copies of the software, or if you modify it.
+
+  For example, if you distribute copies of such a program, whether
+gratis or for a fee, you must give the recipients all the rights that
+you have.  You must make sure that they, too, receive or can get the
+source code.  And you must show them these terms so they know their
+rights.
+
+  We protect your rights with two steps: (1) copyright the software, and
+(2) offer you this license which gives you legal permission to copy,
+distribute and/or modify the software.
+
+  Also, for each author's protection and ours, we want to make certain
+that everyone understands that there is no warranty for this free
+software.  If the software is modified by someone else and passed on, we
+want its recipients to know that what they have is not the original, so
+that any problems introduced by others will not reflect on the original
+authors' reputations.
+
+  Finally, any free program is threatened constantly by software
+patents.  We wish to avoid the danger that redistributors of a free
+program will individually obtain patent licenses, in effect making the
+program proprietary.  To prevent this, we have made it clear that any
+patent must be licensed for everyone's free use or not licensed at all.
+
+  The precise terms and conditions for copying, distribution and
+modification follow.
+
+		    GNU GENERAL PUBLIC LICENSE
+   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+
+  0. This License applies to any program or other work which contains
+a notice placed by the copyright holder saying it may be distributed
+under the terms of this General Public License.  The "Program", below,
+refers to any such program or work, and a "work based on the Program"
+means either the Program or any derivative work under copyright law:
+that is to say, a work containing the Program or a portion of it,
+either verbatim or with modifications and/or translated into another
+language.  (Hereinafter, translation is included without limitation in
+the term "modification".)  Each licensee is addressed as "you".
+
+Activities other than copying, distribution and modification are not
+covered by this License; they are outside its scope.  The act of
+running the Program is not restricted, and the output from the Program
+is covered only if its contents constitute a work based on the
+Program (independent of having been made by running the Program).
+Whether that is true depends on what the Program does.
+
+  1. You may copy and distribute verbatim copies of the Program's
+source code as you receive it, in any medium, provided that you
+conspicuously and appropriately publish on each copy an appropriate
+copyright notice and disclaimer of warranty; keep intact all the
+notices that refer to this License and to the absence of any warranty;
+and give any other recipients of the Program a copy of this License
+along with the Program.
+
+You may charge a fee for the physical act of transferring a copy, and
+you may at your option offer warranty protection in exchange for a fee.
+
+  2. You may modify your copy or copies of the Program or any portion
+of it, thus forming a work based on the Program, and copy and
+distribute such modifications or work under the terms of Section 1
+above, provided that you also meet all of these conditions:
+
+    a) You must cause the modified files to carry prominent notices
+    stating that you changed the files and the date of any change.
+
+    b) You must cause any work that you distribute or publish, that in
+    whole or in part contains or is derived from the Program or any
+    part thereof, to be licensed as a whole at no charge to all third
+    parties under the terms of this License.
+
+    c) If the modified program normally reads commands interactively
+    when run, you must cause it, when started running for such
+    interactive use in the most ordinary way, to print or display an
+    announcement including an appropriate copyright notice and a
+    notice that there is no warranty (or else, saying that you provide
+    a warranty) and that users may redistribute the program under
+    these conditions, and telling the user how to view a copy of this
+    License.  (Exception: if the Program itself is interactive but
+    does not normally print such an announcement, your work based on
+    the Program is not required to print an announcement.)
+
+These requirements apply to the modified work as a whole.  If
+identifiable sections of that work are not derived from the Program,
+and can be reasonably considered independent and separate works in
+themselves, then this License, and its terms, do not apply to those
+sections when you distribute them as separate works.  But when you
+distribute the same sections as part of a whole which is a work based
+on the Program, the distribution of the whole must be on the terms of
+this License, whose permissions for other licensees extend to the
+entire whole, and thus to each and every part regardless of who wrote it.
+
+Thus, it is not the intent of this section to claim rights or contest
+your rights to work written entirely by you; rather, the intent is to
+exercise the right to control the distribution of derivative or
+collective works based on the Program.
+
+In addition, mere aggregation of another work not based on the Program
+with the Program (or with a work based on the Program) on a volume of
+a storage or distribution medium does not bring the other work under
+the scope of this License.
+
+  3. You may copy and distribute the Program (or a work based on it,
+under Section 2) in object code or executable form under the terms of
+Sections 1 and 2 above provided that you also do one of the following:
+
+    a) Accompany it with the complete corresponding machine-readable
+    source code, which must be distributed under the terms of Sections
+    1 and 2 above on a medium customarily used for software interchange; or,
+
+    b) Accompany it with a written offer, valid for at least three
+    years, to give any third party, for a charge no more than your
+    cost of physically performing source distribution, a complete
+    machine-readable copy of the corresponding source code, to be
+    distributed under the terms of Sections 1 and 2 above on a medium
+    customarily used for software interchange; or,
+
+    c) Accompany it with the information you received as to the offer
+    to distribute corresponding source code.  (This alternative is
+    allowed only for noncommercial distribution and only if you
+    received the program in object code or executable form with such
+    an offer, in accord with Subsection b above.)
+
+The source code for a work means the preferred form of the work for
+making modifications to it.  For an executable work, complete source
+code means all the source code for all modules it contains, plus any
+associated interface definition files, plus the scripts used to
+control compilation and installation of the executable.  However, as a
+special exception, the source code distributed need not include
+anything that is normally distributed (in either source or binary
+form) with the major components (compiler, kernel, and so on) of the
+operating system on which the executable runs, unless that component
+itself accompanies the executable.
+
+If distribution of executable or object code is made by offering
+access to copy from a designated place, then offering equivalent
+access to copy the source code from the same place counts as
+distribution of the source code, even though third parties are not
+compelled to copy the source along with the object code.
+
+  4. You may not copy, modify, sublicense, or distribute the Program
+except as expressly provided under this License.  Any attempt
+otherwise to copy, modify, sublicense or distribute the Program is
+void, and will automatically terminate your rights under this License.
+However, parties who have received copies, or rights, from you under
+this License will not have their licenses terminated so long as such
+parties remain in full compliance.
+
+  5. You are not required to accept this License, since you have not
+signed it.  However, nothing else grants you permission to modify or
+distribute the Program or its derivative works.  These actions are
+prohibited by law if you do not accept this License.  Therefore, by
+modifying or distributing the Program (or any work based on the
+Program), you indicate your acceptance of this License to do so, and
+all its terms and conditions for copying, distributing or modifying
+the Program or works based on it.
+
+  6. Each time you redistribute the Program (or any work based on the
+Program), the recipient automatically receives a license from the
+original licensor to copy, distribute or modify the Program subject to
+these terms and conditions.  You may not impose any further
+restrictions on the recipients' exercise of the rights granted herein.
+You are not responsible for enforcing compliance by third parties to
+this License.
+
+  7. If, as a consequence of a court judgment or allegation of patent
+infringement or for any other reason (not limited to patent issues),
+conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License.  If you cannot
+distribute so as to satisfy simultaneously your obligations under this
+License and any other pertinent obligations, then as a consequence you
+may not distribute the Program at all.  For example, if a patent
+license would not permit royalty-free redistribution of the Program by
+all those who receive copies directly or indirectly through you, then
+the only way you could satisfy both it and this License would be to
+refrain entirely from distribution of the Program.
+
+If any portion of this section is held invalid or unenforceable under
+any particular circumstance, the balance of the section is intended to
+apply and the section as a whole is intended to apply in other
+circumstances.
+
+It is not the purpose of this section to induce you to infringe any
+patents or other property right claims or to contest validity of any
+such claims; this section has the sole purpose of protecting the
+integrity of the free software distribution system, which is
+implemented by public license practices.  Many people have made
+generous contributions to the wide range of software distributed
+through that system in reliance on consistent application of that
+system; it is up to the author/donor to decide if he or she is willing
+to distribute software through any other system and a licensee cannot
+impose that choice.
+
+This section is intended to make thoroughly clear what is believed to
+be a consequence of the rest of this License.
+
+  8. If the distribution and/or use of the Program is restricted in
+certain countries either by patents or by copyrighted interfaces, the
+original copyright holder who places the Program under this License
+may add an explicit geographical distribution limitation excluding
+those countries, so that distribution is permitted only in or among
+countries not thus excluded.  In such case, this License incorporates
+the limitation as if written in the body of this License.
+
+  9. The Free Software Foundation may publish revised and/or new versions
+of the General Public License from time to time.  Such new versions will
+be similar in spirit to the present version, but may differ in detail to
+address new problems or concerns.
+
+Each version is given a distinguishing version number.  If the Program
+specifies a version number of this License which applies to it and "any
+later version", you have the option of following the terms and conditions
+either of that version or of any later version published by the Free
+Software Foundation.  If the Program does not specify a version number of
+this License, you may choose any version ever published by the Free Software
+Foundation.
+
+  10. If you wish to incorporate parts of the Program into other free
+programs whose distribution conditions are different, write to the author
+to ask for permission.  For software which is copyrighted by the Free
+Software Foundation, write to the Free Software Foundation; we sometimes
+make exceptions for this.  Our decision will be guided by the two goals
+of preserving the free status of all derivatives of our free software and
+of promoting the sharing and reuse of software generally.
+
+			    NO WARRANTY
+
+  11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
+FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.  EXCEPT WHEN
+OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
+PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
+OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  THE ENTIRE RISK AS
+TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.  SHOULD THE
+PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
+REPAIR OR CORRECTION.
+
+  12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
+WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
+REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
+INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
+OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
+TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
+YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
+PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGES.
+
+		     END OF TERMS AND CONDITIONS
+
+EoF
+
+  exit 0;
+}
+
+# }}}
+
+# Changelog for 0.2
+#  - indentation and folding marks
+#  - made script work with -w and use strict
+#  - removed some localization traps
+#  - marked some BUGS - but they`re still there (mostly localization)
+#  - more robust binary calls
+#  - getval_from_file data acquisition method
+#  - fixed df (shmfs) - but only temporarily (quick hack)
+#  - various code optimizations & cleanup (removed unneded vars)
+#  - Memory size detection now robst and >960MB capable
+#  - slightly better randomness
+#
+#vim:ts=8:sw=4:sts=4
+