#!/usr/bin/perl 
## @file memShow
# @brief Shows available, free and used  server memory sizes
# @details 
# @return $OK (0) - if server memory size was defined successfully
# @return $ERROR (1) - some error happens 
# @author Kate Bazhanova
# @date September 2008
# @version 1.00 - Initial version


=pod

=head1 NAME

B<memShow> Shows available, free and used server memory 

=head1 SYNOPSIS

B<memShow> [B<--help>]

=head1 DESCRIPTION

B<memShow> returns full available, free and used sizes of the server memory.
Available and installed memory ( B<memSizeShow> command shows installed server memory)
could have different values. It is related with BIOS memory mapping issue with 32-bit version of the Linux OS.

=head1 OPTIONS

=over 4

=item B<-help>

Print this help message and exit.

=back

=head1 EXAMPLES

$ B<memShow>

         available       used       free     shared    buffers     cached
Mem:    2113024000 1526652928  586371072          0   51961856 1204031488
Swap:   2163236864          0 2163236864
Total:  4276260864 1526652928 2749607936

If cannot get server memory:

$ B<memShow>

Cannot get server memory size.

=head1 SEE ALSO

B<memSizeShow>

=cut


use lib "/opt/nortel/base/lib";

use strict;
use warnings;
use common_variables;
use common_functions;
use hwRecognition;
use baselog;
use base_system;

## @skipline
sub memShow();
exit(memShow());

###############################################################################
## @fn memShow()
# @brief   Main function. 
# @details This function shows defined availlable, free and used server memory size if it was defined
#      \li otherwise it shows an error message.
# @return  $OK (0)    -  if total server memory was defined successfully
# @return  $ERROR (1) -  indicates an error condition.
# @author  Kate Bazhanova
# @date    September 2008

sub memShow()
{
   my @free = ();
   my $retval = $OK;

   if (defined $ARGV[0] and $ARGV[0] =~ /help$/)
   {
      print_pod_usage();
      return $retval;
   }

   unless (do_system([$FREE, '-b', '-t', '-o'], {$dsOUT => \@free}))
   {
      baselog($LOG_ERROR,"Unable to get memory size: $!", $TRUE);
      return undef;
   }
   foreach my $line (@free)
   {
     $line =~ s/\s{4}total/available/;
   }
   print @free;
   return $retval;
} ## end sub memShow()
