-
Notifications
You must be signed in to change notification settings - Fork 161
/
Copy pathchknvm2.1.html
142 lines (115 loc) · 7.02 KB
/
chknvm2.1.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
<?xml version='1.0' encoding='iso-8859-1'?>
<!doctype html public '-//W3C//DTD XHTML 1.0 Strict//EN' 'http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd'>
<html xmlns='http://www.w3c.org/1999/xhtml' lang='en-us'>
<head>
<title>
chknvm2.7
</title>
<meta http-equiv='content-type' content='text/html;iso-8859-1'/>
<meta name='generator' content='motley-tools 1.8.2.10:42:30 Mar 28 2013'/>
<meta name='author' content='[email protected]'/>
<meta name='robots' content='noindex,nofollow'/>
<link href='toolkit.css' rel='stylesheet' type='text/css'/>
</head>
<body>
<div class='headerlink'>
[<a href='chknvm.7.html' title=' chknvm.7 '>PREV</a>]
[<a href='toolkit.html' title=' Index '>HOME</a>]
[<a href='chkpib.7.html' title=' chkpib.7 '>NEXT</a>]
</div>
<pre>
chknvm2(7) Qualcomm Atheros Powerline Toolkit chknvm2(7)
NAME
chknvm2 - Qualcomm Atheros PLC Image File Validator
SYNOPSIS
chknvm2 [options] file [file] [...]
DESCRIPTION
Check Atheros HomePlug AV firmware files for obvious errors, including obsolete format, incorrect file size, bad check‐
sums and read errors. Make no attempt to check any internal information other than firmware header checksums, image
lengths and image checksums. Optionally, display header and image information on stdout.
This program handles both the older Thunderbolt and Lightning and the newer Panther and Lynx firmware file formats. It
validates files directly from memory and so it is faster than program chknvm but needs more memory at runtime.
This program is part of the Qualcomm Atheros Powerline Toolkit. See the AMP man page for an overview and installation
instructions.
OPTIONS
-i Print revision string identity fields in fixed-width columns. This option is useful when searching .nvm folders
for a specific build.
-m Display manifest content, if present. The manifest is a special module, included in some image chains, that con‐
tains useful information about the chain. This option suppresses the summary ’looks good’ message.
-r Print firmware revision string on stdout. This option automatically suppresses the summary ’looks good’ message.
-q Suppresses printing of routine messages. Specifically, it suppresses the summary ’looks good’ message.
-v Print additional information such as the image header for each image processed. This information can be used to
distinguish one firmware file from another, if you know what to look for.
-?,--help
Print program help summary on stdout. This option takes precedence over other options on the command line.
-!,--version
Print program version information on stdout. This option takes precedence over other options on the command line.
Use this option when sending screen dumps to Atheros Technical Support so that they know exactly which version of
the Linux Toolkit you are using.
ARGUMENTS
file The name of an Atheros image file. By convention, Atheros Image files have a .nvm file extension but this program
does not enforce this convention.
DISCLAIMER
Qualcomm Atheros firmware file structure and content is proprietary to Qualcomm Atheros, Ocala FL USA. Consequently,
public information is not available. Qualcomm Atheros reserves the right to change firmware file structure or content or
change the name or behavior of any program that inspects or changes firmware files, in future software releases without
any obligation to notify or compensate users of such programs.
EXAMPLES
This example reads file abc.nvm and validates it. The message shown indicates that the file is the correct length, image
headers and images have the correct length and checksum and there are no read errors. The file can be have either the
newer or older format.
# chknvm2 abc.nvm
abc.nvm looks good
The following example reads three files in succession and reports on each one. You can suppress good news with the -q
option.
# chknvm2 INT6400.nvm AR7400.nvm AR7420.nvm
INT6400.nvm looks good
AR7400.nvm looks good
AR7420.nvm looks good
This next example prints the firmware revision string found inside older image files. The option can be used to identify
the actual firmware image present when the filename has been changed. Newer image files have a manifest, instead.
Observe that file AR7420.nvm shows no revision string since it is the newer image format where firmware images are com‐
pressed.
# chknvm2 -r INT6400.nvm AR7400.nvm AR7420.nvm
INT6400.nvm (3) INT6000-MAC-4-1-4122-01-4020-20100219-FINAL
AR7400.nvm (5) INT7400-MAC-7-0-7011-01-52-20110811-FINAL
The following example displays the firmware revision strings, from the last example, as fixed width columns. Observe
that the external filename may, in some cases, not reflect the file content.
# chknvm2 -i INT6400.nvm AR7400.nvm AR7420.nvm
INT6000 4020 20100219 4.1 INT6400.nvm (3)
INT7400 0052 20110811 7.0 AR7400.nvm (5)
This example prints the manifest found inside newer firmware files. This can be used to distinguish firmware files from
parameter files, determine exact firmware or parameter file revisions and so forth. Observe that we specified several
files on the command line but only one file, AR7420.nvm, contained a mainfest.
# chknvm2 -m INT6400.nvm AR7400.nvm AR7420.nvm
------- AR7420.nvm (0) -------
Signature: 1234ABCD
Hardware Compatibility: AR74200
Chain Major Version: 0
Chain Minor Version: 1
Chain Type: Firmware
Build Major Version: 0
Build Minor Version: 0
Build Type: Special
Manifest Version: 1
Build Number: 0
Build Date: 20110811
Build Time: 203853
Device Type: 29728
Build Hostname: TOR-SW-SIM04
Build Username: buildbot
Build Description: Custom
Build Version String: AR-7420-FW-0_0-0_2-20110811:203853-buildbot:TOR-SW-SIM04-1-0_1
SEE ALSO
chknvm(7), chkpib(7), chkpib2(7), int6ktest(7), nvmmerge(7), nvmsplit(7), plctest(7)
CREDITS
Charles Maier <[email protected]>
plc-utils-2.1.5 March 2013 chknvm2(7)
</pre>
<div class='footerlink'>
[<a href='chknvm.7.html' title=' chknvm.7 '>PREV</a>]
[<a href='toolkit.html' title=' Index '>HOME</a>]
[<a href='chkpib.7.html' title=' chkpib.7 '>NEXT</a>]
</div>
</body>
</html>