| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108 |
- <?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>
- CMEncrypt.1
- </title>
- <meta http-equiv='content-type' content='text/html;iso-8859-1'/>
- <meta name='generator' content='motley-tools 1.9.4 13:40:33 Feb 18 2015'/>
- <meta name='author' content='cmaier@cmassoc.net'/>
- <meta name='robots' content='noindex,nofollow'/>
- <link href='toolkit.css' rel='stylesheet' type='text/css'/>
- </head>
- <body>
- <div class='headerlink'>
- [<a href='chkpib2.1.html' title=' chkpib2.1 '>PREV</a>]
- [<a href='toolkit.html' title=' Index '>HOME</a>]
- [<a href='config2cfg.1.html' title=' config2cfg.1 '>NEXT</a>]
- </div>
- <pre>
- CMEncrypt(1) Qualcomm Atheros Open Powerline Toolkit CMEncrypt(1)
- NAME
- CMEncrypt - Send Encrypted Payload
- SYNOPSIS
- CMEncrypt [options] [device] [device] [...]
- DESCRIPTION
- Transmit a file over powerline using CM_ENCRYPTED_PAYLOAD messages. This program tests and demonstrates proper (or
- improper) message routing but does not support encrypted transmission. All payloads are sent unencrypted at this time.
- OPTIONS
- -A status
- The AVLN Status. This indicates the current association status and capabilities of the sending station. Permit‐
- ted values are 0 through 255 but only value 0 through 5 and 8 are recognized by the firmware. Values may be
- entered in decimal, hexadecimal or binary format. Hexadecimal value are prefixed with "0x" or "0X". Binary val‐
- ues are prefixed with "0b" or "0B". The default is 0.
- -f file
- The name of the payload file. File content may be text or binary and forms the payload of one or more messages.
- Payloads are transmitted unencrypted when PID is 4 and PEKS is 15 which is default.
- -K PEKS
- The Payload Encryption Key Select. This value indicates the key used to encrypt the payload. Permitted values
- are 0 through 15. Values may be entered in decimal, hexadecimal or binary format. Hexadecimal value are prefixed
- with "0x" or "0X". Binary values are prefixed with "0b" or "0B".. The default is 15 for "No Encryption".
- -P PID The Protocol Identifier. This value detemines how the payload is interpreted by powerline devices. Permitted
- values are 0 through 4. The default is 4 for "HLE Protocol".
- -v Print incoming and outgoing Ethernet frames in hex dump format on stdout.
- -?,--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
- device The Media Access Control (MAC) address of a remote host, not a powerline device. Addresses are 6 hexadecimal
- octets optionally separated by colon. For example, the addresses "00b052000001", "00:b0:52:00:00:01" and
- "00b052:000001" are all valid and equivalent. For convenience, the symbolic address "local" resolves to
- "00:b0:52:00:00:01" and the symbolic addresses "all" and "broadcast" both resolve to "ff:ff:ff:ff:ff:ff".
- INTERNALS
- This program lets the user specify some CM_ENCRYPTED_PAYLOAD fields but not others. The following are fields that the
- user cannot specify. The program automatically computes these values.
- PRN The Protocol Run Number. This is a random number used to distinguish between runs having the same protocol. This
- program uses the system time variable.
- UUID The Universally Unique Identifier. This program uses the left-most 16 bytes of the SHA256 digest for the payload.
- REFERENCES
- Consult the HomePlug AV Specification or Atheros Firmware Technical Reference Manual for more information.
- EXAMPLES
- The following example transmits file myfile.txt to host 00:85:73:00:94:01 in unecrypted format because that is the pro‐
- gram default. The remote address is required and refers to the ultimate recipient, not the local device.
- # CMEncrypt -f myfile.txt 00:85:73:00:94:01 The next example does the same but specifies the program defaults.
- Observe that operands can be expressed in decimal, binary or hexadecimal format.
- # CMEncrypt -f myfile.txt -A 0 -P 0b0100 -K 0x0F 00:85:73:00:94:01
- DISCLAIMER
- Atheros HomePlug AV Vendor Specific Management Message structure and content is proprietary to Qualcomm Atheros, Ocala FL
- USA. Consequently, public information is not available. Qualcomm Atheros reserves the right to modify message structure
- or content in future firmware releases without any obligation to notify or compensate users of this program.
- SEE ALSO
- None.
- CREDITS
- Charles Maier <cmaier@qca.qualcomm.com>
- open-plc-utils-0.0.3 Mar 2014 CMEncrypt(1)
- </pre>
- <div class='footerlink'>
- [<a href='chkpib2.1.html' title=' chkpib2.1 '>PREV</a>]
- [<a href='toolkit.html' title=' Index '>HOME</a>]
- [<a href='config2cfg.1.html' title=' config2cfg.1 '>NEXT</a>]
- </div>
- </body>
- </html>
|
