/*====================================================================* * * Copyright (c) 2013 Qualcomm Atheros, Inc. * * All rights reserved. * * Redistribution and use in source and binary forms, with or * without modification, are permitted (subject to the limitations * in the disclaimer below) provided that the following conditions * are met: * * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * * Redistributions in binary form must reproduce the above * copyright notice, this list of conditions and the following * disclaimer in the documentation and/or other materials * provided with the distribution. * * * Neither the name of Qualcomm Atheros nor the names of * its contributors may be used to endorse or promote products * derived from this software without specific prior written * permission. * * NO EXPRESS OR IMPLIED LICENSES TO ANY PARTY'S PATENT RIGHTS ARE * GRANTED BY THIS LICENSE. THIS SOFTWARE IS PROVIDED BY THE * COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER * OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE * OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * *--------------------------------------------------------------------*/ /*====================================================================* * * int6klog.c - Atheros INT6x00 Log Retrieval Utility; * * * Contributor(s): * Charles Maier * Nathaniel Houghton * *--------------------------------------------------------------------*/ /*====================================================================*" * system header files; *--------------------------------------------------------------------*/ #include #include #include #include /*====================================================================* * custom header files; *--------------------------------------------------------------------*/ #include "../tools/getoptv.h" #include "../tools/putoptv.h" #include "../tools/memory.h" #include "../tools/number.h" #include "../tools/symbol.h" #include "../tools/format.h" #include "../tools/base64.h" #include "../tools/types.h" #include "../tools/flags.h" #include "../tools/files.h" #include "../tools/error.h" #include "../tools/permissions.h" #include "../ether/channel.h" #include "../plc/plc.h" /*====================================================================* * custom source files; *--------------------------------------------------------------------*/ #ifndef MAKEFILE #include "../plc/Devices.c" #include "../plc/Failure.c" #include "../plc/SendMME.c" #include "../plc/ReadMME.c" #endif #ifndef MAKEFILE #include "../tools/error.c" #include "../tools/getoptv.c" #include "../tools/putoptv.c" #include "../tools/version.c" #include "../tools/uintspec.c" #include "../tools/hexdump.c" #include "../tools/hexencode.c" #include "../tools/hexdecode.c" #include "../tools/hexstring.c" #include "../tools/todigit.c" #include "../tools/strfbits.c" #include "../tools/synonym.c" #include "../tools/lookup.c" #include "../tools/assist.c" #include "../tools/codelist.c" #include "../tools/b64dump.c" #include "../tools/desuid.c" #endif #ifndef MAKEFILE #include "../ether/initchannel.c" #include "../ether/openchannel.c" #include "../ether/closechannel.c" #include "../ether/readpacket.c" #include "../ether/sendpacket.c" #include "../ether/channel.c" #endif #ifndef MAKEFILE #include "../mme/MMECode.c" #include "../mme/EthernetHeader.c" #include "../mme/QualcommHeader.c" #include "../mme/UnwantedMessage.c" #endif /*====================================================================* * constants *--------------------------------------------------------------------*/ #define MSTATUS_STATUS (7 << 0) #define MSTATUS_MAJORVERSION (1 << 3) #define MSTATUS_BUFFERISLOCKED (1 << 4) #define MSTATUS_AUTOLOCKONRESET (1 << 5) #define MSTATUS_UNSOLICITEDUPDATES (1 << 6) #define MSTATUS_UNSOLICITED (1 << 7) #define INT6KLOG_FMT_RAW 1 #define INT6KLOG_FMT_XML 2 #define WD_ACTION_READ (1 << 0) #define WD_ACTION_CLEAR (1 << 1) #define WD_ACTION_CUSTOM (1 << 2) /*====================================================================* * program variables; *--------------------------------------------------------------------*/ static struct _code_ const formats [] = { { INT6KLOG_FMT_RAW, "raw", }, { INT6KLOG_FMT_XML, "xml", } }; /*====================================================================* * * static signed PrintRawWatchdogReport (struct plc * plc); * * Read the watchdog report using VS_WD_RPT and write to file in * binary format; the output can be sent to Atheros Support for * analysis; * * VS_WD_RPT request returns an indication instead of a confirmation * message; this is unusual but so is life; * * * Contributor(s): * Charles Maier * *--------------------------------------------------------------------*/ static signed PrintRawWatchdogReport (struct plc * plc) { struct channel * channel = (struct channel *)(plc->channel); struct message * message = (struct message *)(plc->message); #ifndef __GNUC__ #pragma pack (push,1) #endif struct __packed vs_wd_rpt_request { struct ethernet_hdr ethernet; struct qualcomm_hdr qualcomm; uint16_t SESSIONID; uint8_t CLR; } * request = (struct vs_wd_rpt_request *) (message); struct __packed vs_wd_rpt_indicate { struct ethernet_hdr ethernet; struct qualcomm_hdr qualcomm; uint8_t MSTATUS; uint16_t SESSIONID; uint8_t NUMPARTS; uint8_t CURPART; uint16_t RDATALENGTH; uint8_t RDATAOFFSET; uint8_t RDATA [1]; } * indicate = (struct vs_wd_rpt_indicate *) (message); #ifndef __GNUC__ #pragma pack (pop) #endif memset (message, 0, sizeof (* message)); EthernetHeader (&request->ethernet, channel->peer, channel->host, channel->type); QualcommHeader (&request->qualcomm, 0, (VS_WD_RPT | MMTYPE_REQ)); plc->packetsize = (ETHER_MIN_LEN - ETHER_CRC_LEN); request->SESSIONID = HTOLE16 (plc->cookie); request->CLR = plc->readaction; if (SendMME (plc) <= 0) { error (PLC_EXIT (plc), errno, CHANNEL_CANTSEND); return (-1); } do { printf ("%d %d\n", LE16TOH (indicate->RDATALENGTH), indicate->RDATAOFFSET); if (ReadMME (plc, 0, (VS_WD_RPT | MMTYPE_IND)) <= 0) { error (PLC_EXIT (plc), errno, CHANNEL_CANTREAD); return (-1); } printf ("%d %d\n", LE16TOH (indicate->RDATALENGTH), indicate->RDATAOFFSET); if (indicate->MSTATUS) { Failure (plc, PLC_WONTDOIT); return (-1); } printf ("%d %d\n", LE16TOH (indicate->RDATALENGTH), indicate->RDATAOFFSET); write (STDOUT_FILENO, indicate->RDATA + indicate->RDATAOFFSET, LE16TOH (indicate->RDATALENGTH) - indicate->RDATAOFFSET); } while (indicate->CURPART < indicate->NUMPARTS); return (0); } /*====================================================================* * * static signed PrintWatchdogReport (struct plc * plc, char const * version); * * Read the watchdog report using VS_WD_RPT and print to file in * XML format; this file may be sent to QCA for analysis; * * VS_WD_RPT request returns an indication instead of a confirmation * message; this is unusual but so is life; * * * Contributor(s): * Charles Maier * *--------------------------------------------------------------------*/ static signed PrintWatchdogReport (struct plc * plc, char const * version) { struct channel * channel = (struct channel *)(plc->channel); struct message * message = (struct message *)(plc->message); #ifndef __GNUC__ #pragma pack (push,1) #endif struct __packed vs_wd_rpt_request { struct ethernet_hdr ethernet; struct qualcomm_hdr qualcomm; uint16_t SESSIONID; uint8_t CLR; } * request = (struct vs_wd_rpt_request *) (message); struct __packed vs_wd_rpt_ind { struct ethernet_hdr ethernet; struct qualcomm_hdr qualcomm; uint8_t MSTATUS; uint16_t SESSIONID; uint8_t NUMPARTS; uint8_t CURPART; uint16_t RDATALENGTH; uint8_t RDATAOFFSET; uint8_t RDATA [1]; } * indicate = (struct vs_wd_rpt_ind *) (message); #ifndef __GNUC__ #pragma pack (pop) #endif memset (message, 0, sizeof (* message)); EthernetHeader (&request->ethernet, channel->peer, channel->host, channel->type); QualcommHeader (&request->qualcomm, 0, (VS_WD_RPT | MMTYPE_REQ)); plc->packetsize = (ETHER_MIN_LEN - ETHER_CRC_LEN); request->SESSIONID = HTOLE16 (plc->cookie); request->CLR = plc->readaction; if (SendMME (plc) <= 0) { error (PLC_EXIT (plc), errno, CHANNEL_CANTSEND); return (-1); } printf (""); do { if (ReadMME (plc, 0, (VS_WD_RPT | MMTYPE_IND)) < 0) { error (PLC_EXIT (plc), errno, CHANNEL_CANTREAD); return (-1); } if (indicate->MSTATUS) { Failure (plc, PLC_WONTDOIT); return (-1); } printf (""); printf ("%s", version); printf ("%s", "00B052"); printf ("0"); printf ("0"); printf ("%d", indicate->NUMPARTS); printf ("%d", indicate->CURPART); printf ("%d", LE16TOH (indicate->RDATALENGTH)); printf ("%d", indicate->RDATAOFFSET); printf (""); b64dump (indicate->RDATA + indicate->RDATAOFFSET, LE16TOH (indicate->RDATALENGTH) - indicate->RDATAOFFSET, 0, stdout); printf (""); printf (""); } while (indicate->CURPART < indicate->NUMPARTS); printf (""); return (0); } /*====================================================================* * * static signed PrintCheckpointReport (struct plc * plc, char const * version); * * Read the watchdog reqport using VS_CP_RPT and write to file in * binary or XML format; this file can be sent to Atheros Support * for analysis; * * VS_CP_RPT request returns an indication instead of a confirmation * message; this is unusual but so is life; * * * Contributor(s): * Charles Maier * Nathaniel Houghton * *--------------------------------------------------------------------*/ static signed PrintCheckpointReport (struct plc * plc, char const * version) { struct channel * channel = (struct channel *)(plc->channel); struct message * message = (struct message *)(plc->message); #ifndef __GNUC__ #pragma pack (push,1) #endif struct __packed vs_cp_rpt_request { struct ethernet_hdr ethernet; struct qualcomm_hdr qualcomm; uint16_t SESSIONID; uint8_t CLR; } * request = (struct vs_cp_rpt_request *) (message); struct __packed vs_cp_rpt_ind { struct ethernet_hdr ethernet; struct qualcomm_hdr qualcomm; uint8_t MSTATUS; uint8_t MAJORVERSION; uint8_t MINORVERSION; uint8_t RESERVED [14]; uint16_t SESSIONID; uint32_t TOTALBUFFERSIZE; uint32_t BLOCKOFFSET; uint32_t BYTEINDEXOFNEXTPOSITION; uint8_t NUMPARTS; uint8_t CURPART; uint16_t RDATALENGTH; uint8_t RDATAOFFSET; uint8_t RDATA [1]; } * indicate = (struct vs_cp_rpt_ind *) (message); #ifndef __GNUC__ #pragma pack (pop) #endif memset (message, 0, sizeof (* message)); EthernetHeader (&request->ethernet, channel->peer, channel->host, channel->type); QualcommHeader (&request->qualcomm, 0, (VS_CP_RPT | MMTYPE_REQ)); plc->packetsize = (ETHER_MIN_LEN - ETHER_CRC_LEN); request->SESSIONID = HTOLE16 (plc->cookie); request->CLR = plc->readaction; if (SendMME (plc) <= 0) { error (PLC_EXIT (plc), errno, CHANNEL_CANTSEND); return (-1); } printf (""); do { if (ReadMME (plc, 0, (VS_CP_RPT | MMTYPE_IND)) <= 0) { error (PLC_EXIT (plc), errno, CHANNEL_CANTREAD); return (-1); } if (_anyset (indicate->MSTATUS, MSTATUS_STATUS)) { Failure (plc, PLC_WONTDOIT); return (-1); } printf (""); printf ("%s", version); printf ("0"); printf ("%d", indicate->MSTATUS & MSTATUS_MAJORVERSION? 1:0); printf ("%d", indicate->MSTATUS & MSTATUS_BUFFERISLOCKED? 1:0); printf ("%d", indicate->MSTATUS & MSTATUS_AUTOLOCKONRESET? 1:0); printf ("%d", indicate->MSTATUS & MSTATUS_UNSOLICITEDUPDATES? 1:0); printf ("%d", indicate->MSTATUS & MSTATUS_UNSOLICITED? 1:0); printf ("%d", indicate->MAJORVERSION); printf ("%d", indicate->MINORVERSION); printf ("0"); printf ("0"); printf ("0"); printf ("0"); printf ("1"); printf ("%d", LE32TOH (indicate->TOTALBUFFERSIZE)); printf ("%d", LE32TOH (indicate->BLOCKOFFSET)); printf ("%d", LE32TOH (indicate->BYTEINDEXOFNEXTPOSITION)); printf ("%d", indicate->NUMPARTS); printf ("%d", indicate->CURPART); printf ("%d", LE16TOH (indicate->RDATALENGTH)); printf ("%d", indicate->RDATAOFFSET); printf (""); b64dump (indicate->RDATA + indicate->RDATAOFFSET, LE16TOH (indicate->RDATALENGTH), 0, stdout); printf (""); printf (""); } while (indicate->CURPART < indicate->NUMPARTS); printf (""); return (0); } /*====================================================================* * * static signed Diagnostics (struct plc * plc) * * read the firmware version string from a device before reading * and writing the watchdog and checkpoint reports in XML format; * * *--------------------------------------------------------------------*/ static signed Diagnostics (struct plc * plc) { char version [PLC_VERSION_STRING]; struct channel * channel = (struct channel *)(plc->channel); struct message * message = (struct message *)(plc->message); #ifndef __GNUC__ #pragma pack (push,1) #endif struct __packed vs_sw_ver_request { struct ethernet_hdr ethernet; struct qualcomm_hdr qualcomm; uint8_t MSTATUS; uint8_t MDEVICEID; uint8_t MVERLENGTH; char MVERSION [PLC_VERSION_STRING]; } * request = (struct vs_sw_ver_request *) (message); struct __packed vs_sw_ver_confirm { struct ethernet_hdr ethernet; struct qualcomm_hdr qualcomm; uint8_t MSTATUS; uint8_t MDEVICEID; uint8_t MVERLENGTH; char MVERSION [PLC_VERSION_STRING]; } * confirm = (struct vs_sw_ver_confirm *) (message); #ifndef __GNUC__ #pragma pack (pop) #endif memset (message, 0, sizeof (* message)); EthernetHeader (&request->ethernet, channel->peer, channel->host, channel->type); QualcommHeader (&request->qualcomm, 0, (VS_SW_VER | MMTYPE_REQ)); plc->packetsize = (ETHER_MIN_LEN - ETHER_CRC_LEN); if (SendMME (plc) <= 0) { error (PLC_EXIT (plc), errno, CHANNEL_CANTSEND); return (-1); } if (ReadMME (plc, 0, (VS_SW_VER | MMTYPE_CNF)) <= 0) { error (PLC_EXIT (plc), errno, CHANNEL_CANTREAD); return (-1); } if (confirm->MSTATUS) { Failure (plc, PLC_WONTDOIT); return (-1); } memcpy (version, confirm->MVERSION, sizeof (version)); if (plc->action == INT6KLOG_FMT_XML) { printf (""); printf (""); PrintWatchdogReport (plc, version); PrintCheckpointReport (plc, version); printf ("\n"); return (0); } if (plc->action == INT6KLOG_FMT_RAW) { PrintRawWatchdogReport (plc); return (0); } return (0); } /*====================================================================* * * int main (int argc, char const * argv[]); * * parse command line, populate plc structure and perform selected * operations; show help summary if asked; see getoptv and putoptv * to understand command line parsing and help summary display; see * plc.h for the definition of struct plc; * * the command line accepts multiple MAC addresses and the program * performs the specified operations on each address, in turn; the * address order is significant but the option order is not; the * default address is a local broadcast that causes all devices on * the local H1 interface to respond but not those at the remote * end of the powerline; * * the default address is 00:B0:52:00:00:01; omitting the address * will automatically address the local device; some options will * cancel themselves if this makes no sense; * * the default interface is eth1 because most people use eth0 as * their principle network connection; you can specify another * interface with -i or define environment string PLC to make * that the default interface and save typing; * * *--------------------------------------------------------------------*/ int main (int argc, char const * argv []) { extern struct channel channel; static char const * optv [] = { "cCef:ri:qvz:", "device [device] [...] [> stdout]", "Qualcomm Atheros INT6x00 Log Retrieval Utility", "c\tclear watchdog and checkpoint reports", "C\tcustom watchdog report", "e\tredirect stderr to stdout", "f s\tprint Watchdog Report in format (s) [xml]", #if defined (WINPCAP) || defined (LIBPCAP) "i n\thost interface is (n) [" LITERAL (CHANNEL_ETHNUMBER) "]", #else "i s\thost interface is (s) [" LITERAL (CHANNEL_ETHDEVICE) "]", #endif "q\tquiet mode", "r\tread ", "v\tverbose mode", (char const *) (0) }; #include "../plc/plc.c" signed c; initchannel (&channel); desuid (); if (getenv (PLCDEVICE)) { #if defined (WINPCAP) || defined (LIBPCAP) channel.ifindex = atoi (getenv (PLCDEVICE)); #else channel.ifname = strdup (getenv (PLCDEVICE)); #endif } optind = 1; plc.readaction = 0; plc.action = INT6KLOG_FMT_XML; while ((c = getoptv (argc, argv, optv)) != -1) { switch (c) { case 'C': _setbits (plc.readaction, WD_ACTION_CUSTOM); break; case 'c': _setbits (plc.readaction, WD_ACTION_CLEAR); break; case 'e': dup2 (STDOUT_FILENO, STDERR_FILENO); break; case 'f': if ((c = lookup (optarg, formats, SIZEOF (formats))) == -1) { assist (optarg, "format", formats, SIZEOF (formats)); } plc.action = (uint8_t)(c); break; case 'i': #if defined (WINPCAP) || defined (LIBPCAP) channel.ifindex = atoi (optarg); #else channel.ifname = optarg; #endif break; case 'q': _setbits (channel.flags, CHANNEL_SILENCE); _setbits (plc.flags, PLC_SILENCE); break; case 'r': _setbits (plc.readaction, WD_ACTION_READ); break; case 'v': _setbits (channel.flags, CHANNEL_VERBOSE); _setbits (plc.flags, PLC_VERBOSE); break; case 'z': plc.readaction = (uint8_t)(uintspec (optarg, 0, 255)); break; default: break; } } argc -= optind; argv += optind; if (argc != 1) { if (plc.rpt.file != -1) { error (1, ECANCELED, PLC_NODEVICE); } } openchannel (&channel); if (!(plc.message = malloc (sizeof (* plc.message)))) { error (1, errno, PLC_NOMEMORY); } #ifdef WIN32 if (plc.action == INT6KLOG_FMT_RAW) { setmode (STDOUT_FILENO, O_BINARY); } #endif if (!argc) { Diagnostics (&plc); } while ((argc) && (* argv)) { if (!hexencode (channel.peer, sizeof (channel.peer), synonym (* argv, devices, SIZEOF (devices)))) { error (1, errno, PLC_BAD_MAC, * argv); } Diagnostics (&plc); argc--; argv++; } free (plc.message); closechannel (&channel); exit (0); }