/* Copyright (C) 2017-2022 Fredrik Öhrström (gpl-3.0-or-later) This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see . */ #ifndef UTIL_H #define UTIL_H #include #include #include #include #include #include #include void setVersion(const char *v); const char *getVersion(); void onExit(std::function cb); void restoreSignalHandlers(); bool gotHupped(); void wakeMeUpOnSigChld(pthread_t t); bool signalsInstalled(); typedef unsigned char uchar; #define call(A,B) ([&](){A->B();}) #define calll(A,B,T) ([&](T t){A->B(t);}) enum class TestBit { Unknown, Set, NotSet }; uchar bcd2bin(uchar c); uchar revbcd2bin(uchar c); uchar reverse(uchar c); // A BCD string 102030405060 is reversed to 605040302010 std::string reverseBCD(const std::string& v); // A hex string encoding ascii chars is reversed and safely translated into a readble string. std::string reverseBinaryAsciiSafeToString(const std::string& v); // Check if hex string is likely to be ascii bool isLikelyAscii(const std::string& v); bool isHexChar(uchar c); // Flex strings contain hexadecimal digits and permit # | and whitespace. bool isHexStringFlex(const char* txt, bool *invalid); bool isHexStringFlex(const std::string &txt, bool *invalid); // Strict strings contain only hexadecimal digits. bool isHexStringStrict(const char* txt, bool *invalid); bool isHexStringStrict(const std::string &txt, bool *invalid); int char2int(char input); bool hex2bin(const char* src, std::vector *target); bool hex2bin(const std::string &src, std::vector *target); bool hex2bin(std::vector &src, std::vector *target); std::string bin2hex(const std::vector &target); std::string bin2hex(std::vector::iterator data, std::vector::iterator end, int len); std::string bin2hex(std::vector &data, int offset, int len); std::string safeString(std::vector &target); void strprintf(std::string *s, const char* fmt, ...); std::string tostrprintf(const char* fmt, ...); std::string tostrprintf(const std::string &fmt, ...); bool endsWith(const std::string &str, const std::string &suffix); // Return for example: 2010-03-21 std::string strdate(struct tm *date); std::string strdate(double v); // Return for example: 2010-03-21 15:22 std::string strdatetime(struct tm *date); std::string strdatetime(double v); // Return for example: 2010-03-21 15:22:03 std::string strdatetimesec(struct tm *date); std::string strdatetimesec(double v); // Return UTC timestamp: std::string strTimestampUTC(double v); void addMonths(struct tm* date, int m); double addMonths(double t, int m); bool stringFoundCaseIgnored(const std::string& haystack, const std::string& needle); void xorit(uchar *srca, uchar *srcb, uchar *dest, int len); void shiftLeft(uchar *srca, uchar *srcb, int len); std::string format3fdot3f(double v); bool enableLogfile(const std::string& logfile, bool daemon); void disableLogfile(); void enableSyslog(); void error(const char* fmt, ...); #define verbose(...) { if (isVerboseEnabled()) { verbose_int(__VA_ARGS__); } } void verbose_int(const char* fmt, ...); #define trace(...) { if (isTraceEnabled()) { trace_int(__VA_ARGS__); } } void trace_int(const char* fmt, ...); #define debug(...) { if (isDebugEnabled()) { debug_int(__VA_ARGS__); } } void debug_int(const char* fmt, ...); void warning(const char* fmt, ...); void info(const char* fmt, ...); void notice(const char* fmt, ...); void notice_always(const char* fmt, ...); void notice_timestamp(const char* fmt, ...); void silentLogging(bool b); void verboseEnabled(bool b); void debugEnabled(bool b); void traceEnabled(bool b); enum class AddLogTimestamps { NotSet, Never, Always, Important }; void setLogTimestamps(AddLogTimestamps ts); void stderrEnabled(bool b); void logTelegramsEnabled(bool b); void internalTestingEnabled(bool b); bool isInternalTestingEnabled(); bool isVerboseEnabled(); bool isDebugEnabled(); bool isTraceEnabled(); bool isLogTelegramsEnabled(); void debugPayload(const std::string& intro, std::vector &payload); void debugPayload(const std::string& intro, std::vector &payload, std::vector::iterator &pos); void logTelegram(std::vector &original, std::vector &parsed, int header_size, int suffix_size); enum class Alarm { DeviceFailure, RegularResetFailure, DeviceInactivity, SpecifiedDeviceNotFound }; const char* toString(Alarm type); void logAlarm(Alarm type, std::string info); void setAlarmShells(std::vector &alarm_shells); bool isValidAlias(const std::string& alias); bool isValidBps(const std::string& b); bool isFrequency(const std::string& fq); bool isNumber(const std::string& fq); // Split s into strings separated by c. std::vector splitString(const std::string &s, char c); // Split s into strings separated by c and store inte set. std::set splitStringIntoSet(const std::string &s, char c); // Split device string cul:c1:CMD(bar 1:2) into cul c1 CMD(bar 1:2) // I.e. the : colon inside CMD is not used for splitting. std::vector splitDeviceString(const std::string &s); void incrementIV(uchar *iv, size_t len); bool checkCharacterDeviceExists(const char *tty, bool fail_if_not); bool checkFileExists(const char *file); bool checkIfSimulationFile(const char *file); bool checkIfDirExists(const char *dir); bool listFiles(const std::string& dir, std::vector *files); int loadFile(const std::string& file, std::vector *lines); bool loadFile(const std::string& file, std::vector *buf); std::string eatTo(std::vector &v, std::vector::iterator &i, int c, size_t max, bool *eof, bool *err); void padWithZeroesTo(std::vector *content, size_t len, std::vector *full_content); std::string padLeft(const std::string& input, int width); // Parse text string into seconds, 5h = (3600*5) 2m = (60*2) 1s = 1 int parseTime(const std::string& time); // Test if current time is inside any of the specified periods. // For example: mon-sun(00-24) is always true! // mon-fri(08-20) is true monday to friday from 08.00 to 19.59 // tue(09-10),sat(00-24) is true tuesday 09.00 to 09.59 and whole of saturday. bool isInsideTimePeriod(time_t now, std::string periods); bool isValidTimePeriod(const std::string& periods); uint16_t crc16_EN13757(uchar *data, size_t len); // This crc is used by im871a for its serial communication. uint16_t crc16_CCITT(uchar *data, uint16_t length); bool crc16_CCITT_check(uchar *data, uint16_t length); void addSlipFraming(std::vector& from, std::vector &to); // Frame length is set to zero if no frame was found. void removeSlipFraming(std::vector& from, size_t *frame_length, std::vector &to); // Eat characters from the vector v, iterating using i, until the end char c is found. // If end char == -1, then do not expect any end char, get all until eof. // If the end char is not found, return error. // If the maximum length is reached without finding the end char, return error. std::string eatTo(std::vector &v, std::vector::iterator &i, int c, size_t max, bool *eof, bool *err); // Eat whitespace (space and tab, not end of lines). void eatWhitespace(std::vector &v, std::vector::iterator &i, bool *eof); // First eat whitespace, then start eating until c is found or eof. The found string is trimmed from beginning and ending whitespace. std::string eatToSkipWhitespace(std::vector &v, std::vector::iterator &i, int c, size_t max, bool *eof, bool *err); // Remove leading and trailing white space void trimWhitespace(std::string *s); // Returns AccessOK if device exists and is accessible. // NotSameGroup means that there is no permission and the groups do not match. // NoPermission means some other reason for no access. (missing rw etc) // Locked means that some other process has locked the tty. // NoSuchDevice means the tty does not exist. // NoProperResponse means that we talked to something, but we do not know what it is. enum class AccessCheck { NoSuchDevice, NoProperResponse, NoPermission, NotSameGroup, AccessOK }; const char* toString(AccessCheck ac); AccessCheck checkIfExistsAndHasAccess(const std::string& device); // Count the number of 1:s in the binary number v. int countSetBits(int v); bool startsWith(const std::string &s, const char *prefix); bool startsWith(const std::string &s, std::string &prefix); // Given alfa=beta it returns "alfa":"beta" std::string makeQuotedJson(const std::string &s); std::string currentYear(); std::string currentDay(); std::string currentHour(); std::string currentMinute(); std::string currentSeconds(); std::string currentMicros(); #define CHECK(n) if (!hasBytes(n, pos, frame)) return expectedMore(__LINE__); bool hasBytes(int n, std::vector::iterator &pos, std::vector &frame); bool startsWith(const std::string& s, std::vector &data); // Sum the memory used by the heap and stack. size_t memoryUsage(); std::string humanReadableTwoDecimals(size_t s); uint32_t indexFromRtlSdrName(const std::string& s); bool check_if_rtlwmbus_exists_in_path(); bool check_if_rtlsdr_exists_in_path(); // Return the actual executable binary that is running. std::string currentProcessExe(); std::string dirname(const std::string& p); std::string lookForExecutable(const std::string& prog, std::string bin_dir, std::string default_dir); // Extract from "ppm=5 radix=7" and put key values into map. bool parseExtras(const std::string& s, std::map *extras); void checkIfMultipleWmbusMetersRunning(); bool findBytes(std::vector &v, uchar a, uchar b, uchar c, size_t *out); enum class OutputFormat { NONE, PLAIN, TERMINAL, JSON, HTML }; // Joing two status strings with a space, but merge OKs. // I.e. "OK" + "OK" --> "OK" // "ERROR" + "OK" --> "ERROR" // "OK" + "ERROR FLOW" --> "ERROR FLOW" // "ERROR" + "FLOW" --> "ERROR FLOW" // It also translates empty strings into OK. // "" + "OK" --> "OK" // "" + "" --> "OK" std::string joinStatusOKStrings(const std::string &a, const std::string &b); // Same but do not introduce OK, keep empty strings empty. std::string joinStatusEmptyStrings(const std::string &a, const std::string &b); // Sort the words in a status string: "GAMMA BETA ALFA" --> "ALFA BETA GAMMA" // Also identical flags are merged: "BETA ALFA ALFA" --> "ALFA BETA" // Finally ~ is replaced with a space, this is only used for backwards compatibilty for deprecated fields. std::string sortStatusString(const std::string &a); // If a vector is empty, then there will be an assert (with some compiler flags) if we use &v[0] // even if we do not intend to actually use the pointer to uchars! // So provide safeVectorPtr which will return NULL instead of assert-crashing. uchar *safeButUnsafeVectorPtr(std::vector &v); // Count utf8 unicode code points. int strlen_utf8(const char *s); int toMfctCode(char a, char b, char c); bool is_lowercase_alnum_text(const char *text); // The language that the user expects driver and other messages in. const std::string &language(); TestBit toTestBit(const char *s); #ifndef FUZZING #define FUZZING false #endif #endif