chkpib.1.html 7.5 KB

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