plclog(1)

💖 plclog — Qualcomm Atheros Log Retrieval Utility 💖

okay so bestie, welcome to plclog(1) from the Qualcomm Atheros Open Powerline Toolkit — yes that's a whole mouthful, we love her anyway 🫶

✨ SYNOPSIS ✨

plclog [options] [device] [device] [...]  [>stdout]

🌸 DESCRIPTION 🌸

So basically this lil queen reads the device watchdog and checkpoint report and prints it on stdout, so Atheros Technical Support can do their lil analysis on it later. 💅

The report output is in XML format and it's got base-64 encoded binary data that the device handed back. And ngl — apart from the XML tags, the output is not in human readable format. It's giving ✨machine language✨, not giving bedtime story. 😭

This program is part of the Qualcomm Atheros Powerline Toolkit. Peep the AMP man page for an overview and installation instructions, iykyk. 📖

🎀 OPTIONS 🎀

• -c — Specify custom watchdog report.
• -C — Clear the report after reading.
• -e — Redirects stderr messages to stdout. By convention, status and error messages go on stderr while the primary program output goes on stdout. This option prints all output on stdout for when that's the vibe you want.
• -x — Print the report in XML format. The default is raw (or binary) format.
• -i interface — Select the host Ethernet interface. All requests get sent via this host interface, and only responses received via this host interface are recognized. The default interface is eth1 because most people use eth0 as their principle network connection — however, if the environment string PLC is defined then it takes precedence over the default interface. And this option then takes precedence over either default. 👑 (precedence chain, we love a hierarchy)
• -q — Suppresses status messages on stderr. 🤫
• -v — Print additional information on stdout. In particular, this option dumps incoming and outgoing packets, which can be saved as text files for reference. 🔥
• -?,--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 MAC address of some powerline device. More than one address may be specified. If more than one address is specified then operations are performed on each device in turn. The default address is local. See DEVICES for information about symbolic device addresses.

🌈 LOGFILES 🌈

Log files are saved in binary format by default, but they can also be saved in XML format by adding option -x to the command line. By convention, binary log files have a .log extension and XML log files have a .xlog extension. The extension is not critical but it helps us determine the format before we open the file. 🗂️ (a lil label on the jar, basically)

💜 DEVICES 💜

Powerline devices use Ethernet Media Access Control (MAC) addresses. MAC addresses are 12 hexadecimal digits (0123456789ABCDEFabcdef) in upper, lower or mixed case. Individual octets may be separated by colons, for clarity, but not all octets need to be separated. For example, 00b052000001, 00:b0:52:00:00:01 and 00b052:000001 are valid and equivalent. ✨

The following MAC addresses are special and may be expressed by name instead of number. 🫶

• all — Equivalent to broadcast, described next.
• broadcast — A synonym for the standard Ethernet broadcast address, FF:FF:FF:FF:FF:FF. All devices, whether local, remote or foreign, will respond to this address. 📢
• local — A synonym for the Qualcomm Atheros vendor specific Local Management Address (LMA), 00:B0:52:00:00:01. All local Atheros devices will recognize this address but remote and foreign devices will not. A remote device is any device at the far end of a powerline connection. A foreign device is any device not manufactured by Atheros.

⭐ REFERENCES ⭐

See the Qualcomm Atheros HomePlug AV Firmware Technical Reference Manual for more information.

💀 DISCLAIMER 💀

Atheros HomePlug AV Vendor Specific Management Message structure and content is proprietary to Atheros Communications, Ocala FL USA. Consequently, public information is not available. Atheros Communications reserves the right to modify message structure or content in future firmware releases without any obligation to notify or compensate users of this program.

bestie this is the "no take-backs, no warning" clause, fr fr. Read it and know it. 😭

🔥 EXAMPLES 🔥

The following example reads the Watchdog and Checkpoint Report from device 00:B0:52:BA:BE:02 and prints them on stdout in XML format. The output contains data segments formatted in base-64 notation which preserved data integrity when read or transmitted in text format.

# plclog 00:B0:52:BA:BE:02

The next example does the same thing but pipes output to file temp.log. Atheros recommends using a .log extension for compatibility with the WIndows Device Manager.

# plclog 00:B0:52:BA:BE:02 > temp.log

👑 SEE ALSO 👑

amp(1), plctool(1)

🧚 CREDITS 🧚

• Charles Maier

and that's the whole page, bestie 💖 that was plclog(1) from open-plc-utils-0.0.3, dated November 2013 — go forth and retrieve those logs, you absolute icon, periodt 🌸🦋🎀