Provided by: plc-utils-extra_0.0.6+git20230504.1ba7d5a0-1_amd64 
NAME
chkpib2 - Qualcomm Atheros PLC Parameter File Inspector
SYNOPSIS
chkpib2 [options] file [file] [...]
DESCRIPTION
This program checks Atheros HomePlug AV parameter files for obvious errors, including
obsolete format, wrong file size, bad checksums and read errors. It makes no attempt to
check internal information other than file length and checksum.
This program handles both the older Thunderbolt and Lightning and the newer Panther and
Lynx parameter file formats. It validates files directly from memory and so it is faster
than program chkpib 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
-m Display manifest content, if present. The manifest is a special module, included
in some image chains, that contains useful information about the chain. This
option suppresses the summary 'looks good' message.
-q Suppresses printing of progress messages.
-v Print additional information such as the PIB header for each file processed. This
information can be used to confirm pib version and distinguish one PIB file from
another.
-?,--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 a runtime parameter file. By convention, runtime parameter files have
a .pib extention but this program does not enforce that convention.
DISCLAIMER
Qualcomm Atheros parameter 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 parameter file structure or content or change the name or
behavior of any program that inspects or changes parameter files, in future software
releases without any obligation to notify or compensate users of such programs.
EXAMPLES
The next example reads file abc.pib and validates it. The message shown indicates that
the PIB version is recent, the file is the correct size, the checksum is valid computes
and there are no read errors.
# chkpib2 abc.pib
abc.pib looks good
The next example reads three files and reports on each one. You can suppress good news
with the -q option. Remember that "looking good" does not mean "is good".
# chkpib2 INT6400.pib AR7400.pib AR7420.pib
INT6400.pib looks good
AR7400.pib looks good
AR7420.pib looks good
The next example reads three files and displays selected information about each one
because option -v is present.
# chkpib2 -v INT6400.pib AR7400.pib AR7420.pib
------- INT6400.pib -------
PIB 4-2 10888 bytes
MAC 00:B0:52:BA:BE:00
DAK 68:9F:07:4B:8B:02:75:A2:71:0B:0B:57:79:AD:16:30 (HomePlugAV)
NMK 50:D3:E4:93:3F:85:5B:70:40:78:4D:F8:15:AA:8D:B7 (HomePlugAV)
NID B0:F2:E6:95:66:6B:03
NET Intellon Enabled Network
MFG Intellon HomePlug AV Device
USR Intellon Enabled Product
CCo Auto
MDU N/A
------- AR7400.pib -------
PIB 7-1 16352 bytes
MAC 00:B0:52:00:00:08
DAK F0:84:B4:E8:F6:06:9F:F1:30:0C:9B:DB:81:23:67:FF (HomePlugAV0123)
NMK 50:D3:E4:93:3F:85:5B:70:40:78:4D:F8:15:AA:8D:B7 (HomePlugAV)
NID B0:F2:E6:95:66:6B:03
NET Atheros Enabled Network
MFG Atheros HomePlug AV Device
USR Intergalactic Software Pirates
CCo Never
MDU Slave
------- AR7420.pib -------
PIB 0-2 10904 bytes
MAC 00:B0:52:00:00:01
DAK 68:9F:07:4B:8B:02:75:A2:71:0B:0B:57:79:AD:16:30 (HomePlugAV)
NMK 50:D3:E4:93:3F:85:5B:70:40:78:4D:F8:15:AA:8D:B7 (HomePlugAV)
NID B0:F2:E6:95:66:6B:03
NET Atheros Enabled Network
MFG Atheros HomePlug AV Device
USR Atheros Enabled Product
CCo Auto
MDU N/A
This example prints the manifest found inside newer parameter files. This can be used to
distinguish parameter files from firmware 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.pib, contained a manifest.
# chkpib2 -m INT6400.pib AR7400.pib AR7420.pib
------- AR7420.pib (0) -------
Signature: 1234ABCD
Hardware Compatibility: AR74200
Chain Major Version: 0
Chain Minor Version: 1
Chain Type: Parameter Block
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
chkpib(7), getpib(7), modpib(1), pib2xml(1), pibcomp(1), pibdump(1), setpib(1), xml2pib(1)
CREDITS
Charles Maier
Nathaniel Houghton