=head1 NAME
 
B<lsmon> - Lists monitoring plug-in modules that can be used to monitor the xCAT cluster.

  
 
=head1 SYNOPSIS
 
I<lsmon [-h| --help]>

I<lsmon  [-v| --version]>

I<lsmon I<name> [-d|--description]> 

I<lsmon [-a|--all] [-d|--description]> 


=head1 DESCRIPTION

This command is used to list the status, desctiption and the settings of one or all of the monitoring plug-in modules.  
       

=head1 Parameters

I<name> is the name of the monitoring plug-in module.  
 
  
=head1 OPTIONS


B<-a | --all>          Searches the I<XCATROOT/lib/perl/xCAT_monitoring> directory and reports all the monitoring plug-in modules. If nothing is specified, the list is read from the I<monitoring> tabel.

B<-d | --description>  Display the description of the plug-in modules. The description ususally contains the possible settings.

B<-h | --help>         Display usage message.

B<-v | -version >      Command Version. 

B<-V | -verbose>       Verbose output. 


=head1 RETURN VALUE

0 The command completed successfully.

1 An error has occurred.

=head1 EXAMPLES

1. To list the status of all the monitoring plug-in modules from the I<monitoring> table, enter:

  lsmon 

The output looks like this:
  xcatmon         monitored       node-status-monitored
  snmpmon         not-monitored

2. To list the status of all the monitoring plug-in modules including the ones that are not in the monitoring table, enter

  lsmon -a

The output looks like this:
  xcatmon         monitored       node-status-monitored
  snmpmon         not-monitored
  gangliamon      not-monitored
  rmcmon          monitored
  nagiosmon       not-monitored
  

3. To list the status and the desciption for I<snmpmon> module, enter:

  lsmon snmpmon -d


=head1 FILES 
 
/opt/xcat/bin/lsmon


=head1 NOTES

See stopmon startmon

This command is part of the xCAT software product.