"Fossies" - the Fresh Open Source Software Archive

Member "open-fcoe-3.19/fcoe-utils/doc/fcping.txt" (15 Apr 2015, 3274 Bytes) of package /linux/misc/open-fcoe-3.19.tar.gz:


As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file.

    1 ///////////////////////////////////////////////////////////////////////////
    2 // vim:syntax=asciidoc:tw=75:
    3 //
    4 // This is an asciidoc text file, which will be converted into a UNIX man
    5 // page using asciidoc and the DocBook XSL stylesheets.
    6 //
    7 // If you are going to update this documentation, please modify this file
    8 // and then regenerate the nroff formated man page using the Makefile.
    9 ///////////////////////////////////////////////////////////////////////////
   10 
   11 fcping(8)
   12 ==========
   13 :man source: Open-FCoE
   14 :man manual: Open-FCoE Tools
   15 
   16 NAME
   17 ----
   18 fcping - Fibre Channel Ping (ELS ECHO) tool
   19 
   20 SYNOPSIS
   21 --------
   22 *fcping* [-fqx] [ -i _interval_ ] [ -c _count_ ] [ -s _size_ ] -h _source_ _target_
   23 
   24 source = _interface_ | _MAC_ | _WWPN_ | _FC-ID_
   25 
   26 target = -P _WWPN_ | -N _WWPN_ | -F _FC-ID_
   27 
   28 DESCRIPTION
   29 -----------
   30 The *fcping* command performs the Fibre Channel FC-LS-2 ECHO ELS command
   31 and displays the reply. The max payload for *fcping* is 2108 bytes. When
   32 no *-c* is given, *fcping* will continue until user interrupts.
   33 
   34 OPTIONS
   35 -------
   36 *-f*::
   37 	Flood ping
   38 
   39 *-q*::
   40 	Quiet! just print summary
   41 
   42 *-x*::
   43 	Hex dump of responses
   44 
   45 *-i* _interval_::
   46 	Wait _interval_ seconds between each ping
   47 
   48 *-c* _count_::
   49 	Stop after sending _count_ pings
   50 
   51 *-h* _source_::
   52 	Source is _interface_ like ethX, _MAC_ address, _WWPN_, or _FC-ID_
   53 
   54 *-s* _size_::
   55 	Byte-length of ping request payload (max 2108)
   56 
   57 *-F* _FC-ID_::
   58 	Destination port ID
   59 
   60 *-P* _WWPN_::
   61 	Destination world-wide port name
   62 
   63 *-N* _WWNN_::
   64 	Destination world-wide node name
   65 
   66 EXAMPLES
   67 --------
   68 Sends ELS ECHO to Port FC-ID 0xbf0027 from interface n0.170 with max 3 pings.
   69 
   70 	fcping -c 3 -h n0.170 -F 0xbf0027
   71 
   72 	sending echo to 0xBF0027
   73 	echo    1 accepted                       16.170 ms
   74 	echo    2 accepted                        7.053 ms
   75 	echo    3 accepted                        6.803 ms
   76 	3 frames sent, 3 received 0 errors, 0.000% loss, avg. rt time 10.009 ms
   77 
   78 
   79 Sends ELS ECHO to WWNN 0x1000001B213C9DDA from interface n0.170 with max 3 pings
   80 and payload size 1500 bytes
   81 
   82 	fcping -c 3 -h n0.170 -s 1500 -N 0x1000001B213C9DDA
   83 
   84 	sending echo to 0xBF0027
   85 	echo    1 accepted                        6.597 ms
   86 	echo    2 accepted                        6.925 ms
   87 	echo    3 accepted                       12.419 ms
   88 	3 frames sent, 3 received 0 errors, 0.000% loss, avg. rt time 8.647 ms
   89 
   90 Sends ELS ECHO to WWNN 0x1000001B213C9DDA from interface n0.170 continuously
   91 with payload of 32 bytes and hex-dump the reply to the screen
   92 
   93 	fcping -x -h n0.170 -s 32 -N 0x1000001B213C9DDA
   94 
   95 	sending echo to 0xBF0027
   96 	echo    1 accepted                        6.937 ms
   97 	response length 32
   98 	     0 02000000 00000001 00010203 04050607
   99 	    10 08090a0b 0c0d0e0f 10111213 14151617
  100 
  101 	echo    2 accepted                        6.923 ms
  102 	response length 32
  103 	     0 02000000 00000002 00010203 04050607
  104 	    10 08090a0b 0c0d0e0f 10111213 14151617
  105 
  106 	echo    3 accepted                       84.929 ms
  107 	response length 32
  108 	     0 02000000 00000003 00010203 04050607
  109 	    10 08090a0b 0c0d0e0f 10111213 14151617
  110 
  111 
  112 SEE ALSO
  113 --------
  114 *fcoeadm*(8)
  115 
  116 SUPPORT
  117 -------
  118 *fcping* is part of the _fcoe-utils_ package, maintained through the
  119 _Open-FCoE_ project. Resources for both developers and users can be found
  120 at the _Open-FCoE_ website <http://open-fcoe.org/>.