pib2xml.1.html 4.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110
  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. pib2xml.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='pev.1.html' title=' pev.1 '>PREV</a>]
  17. [<a href='toolkit.html' title=' Index '>HOME</a>]
  18. [<a href='pibcomp.1.html' title=' pibcomp.1 '>NEXT</a>]
  19. </div>
  20. <pre>
  21. pib2xml(1) Qualcomm Atheros Open Powerline Toolkit pib2xml(1)
  22. NAME
  23. pib2xml - print object driven xml editior intructions
  24. SYNOPSIS
  25. pib2xml [options] file [file] [...] [&gt;stdout]
  26. DESCRIPTION
  27. Write XML editor instructions on stdout. This requires an object definition file that contains the size and name of data
  28. regions and members within a binary object or file. Individual data members are presented as XML instructions that can
  29. be used by program pxe to edit PIB files.
  30. OPTIONS
  31. -f definitions
  32. The name of the object definition file that contains the size, name and description of objects within a binary
  33. file. The definition file is not modified. This option is required. There is no default file.
  34. -s schema
  35. The url for the XML schema. The default schema is piboffset.xsd for the Qualcomm Atheros Powerline Toolkit verion
  36. of this program.
  37. -x Print an XML schema on stdout. This schema defines the elements and attributes used to define data objects and
  38. members read from input files. It can be used to validate XML files used with program pxe.
  39. -?,--help
  40. Print program help summary on stdout. This option takes precedence over other options on the command line.
  41. -!,--version
  42. Print program version information on stdout. This option takes precedence over other options on the command line.
  43. Use this option when sending screen dumps to Atheros Technical Support so that they know exactly which version of
  44. the Linux Toolkit you are using.
  45. ARGUMENTS
  46. file The name of a binary file. The file must have either Thunderbolt/Lightning or Panther/Lynx format or output will
  47. be incorrect. The file is not modified by this program. Only one such file is permitted on the command line.
  48. EXAMPLES
  49. The following is an example object definition file that defines a standard ethernet frame and member fields within it.
  50. The comments and descriptions shown are optional. The field lengths and field names are not. Zero-length fields denote
  51. arbitrary field groups and are used by program offset to print headings.
  52. # ========================================
  53. #
  54. # ----------------------------------------
  55. 0 header
  56. 6 ODA Own Destination Address
  57. 6 OSA Own Source Address
  58. 2 ET Ethertype or frame length
  59. # ========================================
  60. #
  61. # ----------------------------------------
  62. 0 body
  63. 1500 Payload
  64. # ========================================
  65. #
  66. # ----------------------------------------
  67. 0 trailer
  68. 4 CRC Cyclical Redundancy Check
  69. The following command uses object definition file ether.txt to identify and display member fields within binary file
  70. abc.bin as a set of xml instructions that can be used by program xde to edit other files.
  71. # pib2xml -f ether.txt abc.bin
  72. The next command writes the xml schema that defines the elements and attributes used in the edit instructions to file
  73. data.xsd. This file can be used to validate xml edit instructions.
  74. # pib2xml -x &gt; data.xsd
  75. SEE ALSO
  76. chkpib(7), chkpib2(7), getpib(7), modpib(1), pibcomp(1), pibdump(1), setpib(1), xml2pib(1)
  77. CREDITS
  78. Charles Maier &lt;cmaier@cmassoc.net&gt;
  79. open-plc-utils-0.0.3 Mar 2014 pib2xml(1)
  80. </pre>
  81. <div class='footerlink'>
  82. [<a href='pev.1.html' title=' pev.1 '>PREV</a>]
  83. [<a href='toolkit.html' title=' Index '>HOME</a>]
  84. [<a href='pibcomp.1.html' title=' pibcomp.1 '>NEXT</a>]
  85. </div>
  86. </body>
  87. </html>