#######
pping.1
#######

.. highlight:: perl


********
SYNOPSIS
********


\ **pping**\  [\ **-i | -**\ **-interface**\  \ *interfaces*\ ] [\ **-f | -**\ **-use_fping**\ ] \ *noderange*\ 

\ **pping**\  [\ **-h | -**\ **-help**\ ]

\ **pping**\  {\ **-v | -**\ **-version**\ }


***********
DESCRIPTION
***********


\ **pping**\  is a utility used to ping a list of nodes in parallel.
\ **pping**\  will return an unsorted list of nodes with a ping or noping status.
\ **pping**\  front-ends \ **nmap**\  or \ **fping**\  if available.

This command does not support the xcatd client/server communication.  It must be run on the management node.


*******
OPTIONS
*******



\ **-i | -**\ **-interface**\  \ *interfaces*\ 
 
 A comma separated list of network interface names that should be pinged instead of the interface represented by the nodename/hostname.
 The following name resolution convention is assumed:  an interface is reachable by the hostname <nodename>-<interface>.  For example,
 the ib2 interface on node3 has a hostname of node3-ib2.
 
 If more than one interface is specified, each interface will be combined with the nodenames as described above and will be pinged in turn.
 


\ **-f | -**\ **-use_fping**\ 
 
 Use \ **fping**\  instead of \ **nmap**\ 
 


\ **-h | -**\ **-help**\ 
 
 Show usage information.
 


\ **-v | -**\ **-version**\ 
 
 Display the installed version of xCAT.
 



********
EXAMPLES
********



1.
 
 
 .. code-block:: perl
 
   pping all
 
 
 Output is similar to:
 
 
 .. code-block:: perl
 
   node1: ping
   node2: ping
   node3: noping
 
 


2.
 
 
 .. code-block:: perl
 
   pping all -i ib0,ib1
 
 
 Output is similar to:
 
 
 .. code-block:: perl
 
   node1-ib0: ping
   node2-ib0: ping
   node3-ib0: noping
   node1-ib1: ping
   node2-ib1: ping
   node3-ib1: noping
 
 



********
SEE ALSO
********


psh(1)|psh.1, noderange(3)|noderange.3