chkpib2.1.html 7.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157
  1. <?xml version='1.0' encoding='iso-8859-1'?>
  2. <!doctype html public '-//W3C//DTD XHTML 1.0 Strict//EN' 'http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd'>
  3. <html xmlns='http://www.w3c.org/1999/xhtml' lang='en-us'>
  4. <head>
  5. <title>
  6. chkpib2.1
  7. </title>
  8. <meta http-equiv='content-type' content='text/html;iso-8859-1'/>
  9. <meta name='generator' content='motley-tools 1.9.4 13:40:33 Feb 18 2015'/>
  10. <meta name='author' content='cmaier@cmassoc.net'/>
  11. <meta name='robots' content='noindex,nofollow'/>
  12. <link href='toolkit.css' rel='stylesheet' type='text/css'/>
  13. </head>
  14. <body>
  15. <div class='headerlink'>
  16. [<a href='chkpib.1.html' title=' chkpib.1 '>PREV</a>]
  17. [<a href='toolkit.html' title=' Index '>HOME</a>]
  18. [<a href='CMEncrypt.1.html' title=' CMEncrypt.1 '>NEXT</a>]
  19. </div>
  20. <pre>
  21. chkpib2(1) Qualcomm Atheros Open Powerline Toolkit chkpib2(1)
  22. NAME
  23. chkpib2 - Qualcomm Atheros PLC Parameter File Inspector
  24. SYNOPSIS
  25. chkpib2 [options] file [file] [...]
  26. DESCRIPTION
  27. This program checks Atheros HomePlug AV parameter files for obvious errors, including obsolete format, wrong file size,
  28. bad checksums and read errors. It makes no attempt to check internal information other than file length and checksum.
  29. This program handles both the older Thunderbolt and Lightning and the newer Panther and Lynx parameter file formats. It
  30. validates files directly from memory and so it is faster than program chkpib but needs more memory at runtime.
  31. This program is part of the Qualcomm Atheros Powerline Toolkit. See the AMP man page for an overview and installation
  32. instructions.
  33. OPTIONS
  34. -m Display manifest content, if present. The manifest is a special module, included in some image chains, that con‐
  35. tains useful information about the chain. This option suppresses the summary 'looks good' message.
  36. -q Suppresses printing of progress messages.
  37. -v Print additional information such as the PIB header for each file processed. This information can be used to con‐
  38. firm pib version and distinguish one PIB file from another.
  39. -?,--help
  40. Print program help summary on stdout. This option takes precedence over other options on the command line.
  41. -!,--version
  42. Print program version information on stdout. This option takes precedence over other options on the command line.
  43. Use this option when sending screen dumps to Atheros Technical Support so that they know exactly which version of
  44. the Linux Toolkit you are using.
  45. ARGUMENTS
  46. file The name of a runtime parameter file. By convention, runtime parameter files have a .pib extention but this pro‐
  47. gram does not enforce that convention.
  48. DISCLAIMER
  49. Qualcomm Atheros parameter file structure and content is proprietary to Qualcomm Atheros, Ocala FL USA. Consequently,
  50. public information is not available. Qualcomm Atheros reserves the right to change parameter file structure or content
  51. or change the name or behavior of any program that inspects or changes parameter files, in future software releases with‐
  52. out any obligation to notify or compensate users of such programs.
  53. EXAMPLES
  54. The next example reads file abc.pib and validates it. The message shown indicates that the PIB version is recent, the
  55. file is the correct size, the checksum is valid computes and there are no read errors.
  56. # chkpib2 abc.pib
  57. abc.pib looks good
  58. The next example reads three files and reports on each one. You can suppress good news with the -q option. Remember
  59. that &quot;looking good&quot; does not mean &quot;is good&quot;.
  60. # chkpib2 INT6400.pib AR7400.pib AR7420.pib
  61. INT6400.pib looks good
  62. AR7400.pib looks good
  63. AR7420.pib looks good
  64. The next example reads three files and displays selected information about each one because option -v is present.
  65. # chkpib2 -v INT6400.pib AR7400.pib AR7420.pib
  66. ------- INT6400.pib -------
  67. PIB 4-2 10888 bytes
  68. MAC 00:B0:52:BA:BE:00
  69. DAK 68:9F:07:4B:8B:02:75:A2:71:0B:0B:57:79:AD:16:30 (HomePlugAV)
  70. NMK 50:D3:E4:93:3F:85:5B:70:40:78:4D:F8:15:AA:8D:B7 (HomePlugAV)
  71. NID B0:F2:E6:95:66:6B:03
  72. NET Intellon Enabled Network
  73. MFG Intellon HomePlug AV Device
  74. USR Intellon Enabled Product
  75. CCo Auto
  76. MDU N/A
  77. ------- AR7400.pib -------
  78. PIB 7-1 16352 bytes
  79. MAC 00:B0:52:00:00:08
  80. DAK F0:84:B4:E8:F6:06:9F:F1:30:0C:9B:DB:81:23:67:FF (HomePlugAV0123)
  81. NMK 50:D3:E4:93:3F:85:5B:70:40:78:4D:F8:15:AA:8D:B7 (HomePlugAV)
  82. NID B0:F2:E6:95:66:6B:03
  83. NET Atheros Enabled Network
  84. MFG Atheros HomePlug AV Device
  85. USR Intergalactic Software Pirates
  86. CCo Never
  87. MDU Slave
  88. ------- AR7420.pib -------
  89. PIB 0-2 10904 bytes
  90. MAC 00:B0:52:00:00:01
  91. DAK 68:9F:07:4B:8B:02:75:A2:71:0B:0B:57:79:AD:16:30 (HomePlugAV)
  92. NMK 50:D3:E4:93:3F:85:5B:70:40:78:4D:F8:15:AA:8D:B7 (HomePlugAV)
  93. NID B0:F2:E6:95:66:6B:03
  94. NET Atheros Enabled Network
  95. MFG Atheros HomePlug AV Device
  96. USR Atheros Enabled Product
  97. CCo Auto
  98. MDU N/A
  99. This example prints the manifest found inside newer parameter files. This can be used to distinguish parameter files
  100. from firmware files, determine exact firmware or parameter file revisions and so forth. Observe that we specified sev‐
  101. eral files on the command line but only one file, AR7420.pib, contained a manifest.
  102. # chkpib2 -m INT6400.pib AR7400.pib AR7420.pib
  103. ------- AR7420.pib (0) -------
  104. Signature: 1234ABCD
  105. Hardware Compatibility: AR74200
  106. Chain Major Version: 0
  107. Chain Minor Version: 1
  108. Chain Type: Parameter Block
  109. Build Major Version: 0
  110. Build Minor Version: 0
  111. Build Type: Special
  112. Manifest Version: 1
  113. Build Number: 0
  114. Build Date: 20110811
  115. Build Time: 203853
  116. Device Type: 29728
  117. Build Hostname: TOR-SW-SIM04
  118. Build Username: buildbot
  119. Build Description: Custom
  120. Build Version String: AR-7420-FW-0_0-0_2-20110811:203853-buildbot:TOR-SW-SIM04-1-0_1
  121. SEE ALSO
  122. chkpib(7), getpib(7), modpib(1), pib2xml(1), pibcomp(1), pibdump(1), setpib(1), xml2pib(1)
  123. CREDITS
  124. Charles Maier &lt;cmaier@qca.qualcomm.com&gt;
  125. Nathaniel Houghton &lt;nhoughto@qca.qualcomm.com&gt;
  126. open-plc-utils-0.0.3 Mar 2014 chkpib2(1)
  127. </pre>
  128. <div class='footerlink'>
  129. [<a href='chkpib.1.html' title=' chkpib.1 '>PREV</a>]
  130. [<a href='toolkit.html' title=' Index '>HOME</a>]
  131. [<a href='CMEncrypt.1.html' title=' CMEncrypt.1 '>NEXT</a>]
  132. </div>
  133. </body>
  134. </html>