pibcomp.1 2.4 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071
  1. .TH pibcomp 1 "Mar 2014" "plc-utils-2.1.6" "Qualcomm Atheros Powerline Toolkit"
  2. .SH NAME
  3. pibcomp - Qualcomm Atheros Parameter Block Compare Utility
  4. .SH SYNOPSIS
  5. .BR pibcomp
  6. .RI [ options ]
  7. .IR file
  8. .IR file
  9. .RI [> stdout ]
  10. .SH DESCRIPTION
  11. Read and compare two Qualcomm Atheros powerline parameter block files and print only those objects that are different.
  12. It will detect and handle both old and new powerline parameter file formats.
  13. This program is similar to program \fBodc\fR but is designed specifically for Qualcomm Atheros powerline parameter files.
  14. Program \fBodc\fR is no longer supported and will be removed from future toolkit releases.
  15. .PP
  16. Object driven comparison requires an object definition file that lists the size and name of data data objects (ie; integers, arrays or structures) within the parameter file.
  17. Individual data members are presented as smaller, individual data dumps within a larger, overall data dump.
  18. See program pibdump for more information of object definition file format.
  19. .SH OPTIONS
  20. .TP
  21. -\fBf\fI file\fR
  22. The object definition file that lists the size, name and description of individual individual objects in order of occurance.
  23. If this option is omitted then object definitions are read from stdin.
  24. The object definition file is not modified by this program.
  25. See the \fBpibdump\fR man page for an example of an object definition file.
  26. .TP
  27. .RB - ? ,-- help
  28. Print program help summary on stdout.
  29. This option takes precedence over other options on the command line.
  30. .TP
  31. .RB - ! ,-- version
  32. Print program version information on stdout.
  33. This option takes precedence over other options on the command line.
  34. 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.
  35. .SH ARGUMENTS
  36. .TP
  37. .IR file
  38. The name of a binary file.
  39. Two binary files are needed for comparison and both should conform to the object definition file for the comarison to be meaningful.
  40. .SH EXAMPLES
  41. The following example compares file \fBabc.bin\fR and \fBdef.bin\fR and prints objects that are different in hexdump format.
  42. Objects are defined in \fBobjects.txt\fR and read using \fB-f\fR.
  43. .PP
  44. # pibcomp -f objects.txt abc.bin def.bin
  45. .SH SEE ALSO
  46. .BR chkpib (7),
  47. .BR chkpib2 (7),
  48. .BR getpib (7 ),
  49. .BR modpib ( 1 ),
  50. .BR pib2xml ( 1 ),
  51. .BR pibdump ( 1 ),
  52. .BR setpib ( 1 ),
  53. .BR xml2pib ( 1 )
  54. .SH CREDITS
  55. Nathaniel Houghton <nhoughto@qca.qualcomm.com>
  56. Charles Maier <cmaier@qca.qualcomm.com>