chknvm2.1.html 7.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142
  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. chknvm2.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='chknvm.1.html' title=' chknvm.1 '>PREV</a>]
  17. [<a href='toolkit.html' title=' Index '>HOME</a>]
  18. [<a href='chkpib.1.html' title=' chkpib.1 '>NEXT</a>]
  19. </div>
  20. <pre>
  21. chknvm2(1) Qualcomm Atheros Open Powerline Toolkit chknvm2(1)
  22. NAME
  23. chknvm2 - Qualcomm Atheros PLC Image File Validator
  24. SYNOPSIS
  25. chknvm2 [options] file [file] [...]
  26. DESCRIPTION
  27. Check Atheros HomePlug AV firmware files for obvious errors, including obsolete format, incorrect file size, bad check‐
  28. sums and read errors. Make no attempt to check any internal information other than firmware header checksums, image
  29. lengths and image checksums. Optionally, display header and image information on stdout.
  30. This program handles both the older Thunderbolt and Lightning and the newer Panther and Lynx firmware file formats. It
  31. validates files directly from memory and so it is faster than program chknvm but needs more 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. -i Print revision string identity fields in fixed-width columns. This option is useful when searching .nvm folders
  36. for a specific build.
  37. -m Display manifest content, if present. The manifest is a special module, included in some image chains, that con‐
  38. tains useful information about the chain. This option suppresses the summary 'looks good' message.
  39. -r Print firmware revision string on stdout. This option automatically suppresses the summary 'looks good' message.
  40. -q Suppresses printing of routine messages. Specifically, it suppresses the summary 'looks good' message.
  41. -v Print additional information such as the image header for each image processed. This information can be used to
  42. distinguish one firmware file from another, if you know what to look for.
  43. -?,--help
  44. Print program help summary on stdout. This option takes precedence over other options on the command line.
  45. -!,--version
  46. Print program version information on stdout. This option takes precedence over other options on the command line.
  47. Use this option when sending screen dumps to Atheros Technical Support so that they know exactly which version of
  48. the Linux Toolkit you are using.
  49. ARGUMENTS
  50. file The name of an Atheros image file. By convention, Atheros Image files have a .nvm file extension but this program
  51. does not enforce this convention.
  52. DISCLAIMER
  53. Qualcomm Atheros firmware file structure and content is proprietary to Qualcomm Atheros, Ocala FL USA. Consequently,
  54. public information is not available. Qualcomm Atheros reserves the right to change firmware file structure or content or
  55. change the name or behavior of any program that inspects or changes firmware files, in future software releases without
  56. any obligation to notify or compensate users of such programs.
  57. EXAMPLES
  58. This example reads file abc.nvm and validates it. The message shown indicates that the file is the correct length, image
  59. headers and images have the correct length and checksum and there are no read errors. The file can be have either the
  60. newer or older format.
  61. # chknvm2 abc.nvm
  62. abc.nvm looks good
  63. The following example reads three files in succession and reports on each one. You can suppress good news with the -q
  64. option.
  65. # chknvm2 INT6400.nvm AR7400.nvm AR7420.nvm
  66. INT6400.nvm looks good
  67. AR7400.nvm looks good
  68. AR7420.nvm looks good
  69. This next example prints the firmware revision string found inside older image files. The option can be used to identify
  70. the actual firmware image present when the filename has been changed. Newer image files have a manifest, instead.
  71. Observe that file AR7420.nvm shows no revision string since it is the newer image format where firmware images are com‐
  72. pressed.
  73. # chknvm2 -r INT6400.nvm AR7400.nvm AR7420.nvm
  74. INT6400.nvm (3) INT6000-MAC-4-1-4122-01-4020-20100219-FINAL
  75. AR7400.nvm (5) INT7400-MAC-7-0-7011-01-52-20110811-FINAL
  76. The following example displays the firmware revision strings, from the last example, as fixed width columns. Observe
  77. that the external filename may, in some cases, not reflect the file content.
  78. # chknvm2 -i INT6400.nvm AR7400.nvm AR7420.nvm
  79. INT6000 4020 20100219 4.1 INT6400.nvm (3)
  80. INT7400 0052 20110811 7.0 AR7400.nvm (5)
  81. This example prints the manifest found inside newer firmware files. This can be used to distinguish firmware files from
  82. parameter files, determine exact firmware or parameter file revisions and so forth. Observe that we specified several
  83. files on the command line but only one file, AR7420.nvm, contained a mainfest.
  84. # chknvm2 -m INT6400.nvm AR7400.nvm AR7420.nvm
  85. ------- AR7420.nvm (0) -------
  86. Signature: 1234ABCD
  87. Hardware Compatibility: AR74200
  88. Chain Major Version: 0
  89. Chain Minor Version: 1
  90. Chain Type: Firmware
  91. Build Major Version: 0
  92. Build Minor Version: 0
  93. Build Type: Special
  94. Manifest Version: 1
  95. Build Number: 0
  96. Build Date: 20110811
  97. Build Time: 203853
  98. Device Type: 29728
  99. Build Hostname: TOR-SW-SIM04
  100. Build Username: buildbot
  101. Build Description: Custom
  102. Build Version String: AR-7420-FW-0_0-0_2-20110811:203853-buildbot:TOR-SW-SIM04-1-0_1
  103. SEE ALSO
  104. chknvm(1), chkpib(1), chkpib2(1), int6ktest(7), nvmmerge(1), nvmsplit(1), plctest(7)
  105. CREDITS
  106. Charles Maier &lt;cmaier@qca.qualcomm.com&gt;
  107. open-plc-utils-0.0.3 Mar 2014 chknvm2(1)
  108. </pre>
  109. <div class='footerlink'>
  110. [<a href='chknvm.1.html' title=' chknvm.1 '>PREV</a>]
  111. [<a href='toolkit.html' title=' Index '>HOME</a>]
  112. [<a href='chkpib.1.html' title=' chkpib.1 '>NEXT</a>]
  113. </div>
  114. </body>
  115. </html>