aboutsummaryrefslogtreecommitdiffstats
path: root/global-functions
AgeCommit message (Collapse)AuthorFilesLines
2023-01-20check-health: monitor free RAMGravatar Christian Hesse1-0/+1
---- ✂️ ---- 🗃️📉️ Health warning: free RAM The available free RAM on MikroTik is at 18% (47MiB)! ---- ✂️ ---- 🗃️📈️ Health recovery: free RAM The available free RAM on MikroTik increased to 65% (168MiB). ---- ✂️ ----
2023-01-20check-health: monitor CPU loadGravatar Christian Hesse1-0/+1
---- ✂️ ---- 🧮️📈️ Health warning: CPU load The average CPU load on MikroTik is at 76%! ---- ✂️ ---- 🧮️📉️ Health recovery: CPU load The average CPU load on MikroTik decreased to 64%. ---- ✂️ ----
2023-01-20global-functions: $RequiredRouterOS: check for valid version stringGravatar Christian Hesse1-0/+6
2023-01-20global-functions: use new functionality for version checkGravatar Christian Hesse1-3/+2
2023-01-20global-functions: $ScriptInstallUpdate: add a version check for scriptsGravatar Christian Hesse1-10/+19
New RouterOS releases bring new features, and thus new syntax. Installing a new script on old RouterOS results in syntax errors. We want to give clear warning messages, so by adding an extra comment into the script... # requires RouterOS, version=7.8beta3 ... installing on unsupported RouterOS version is mitigated.
2023-01-20global-functions: implement $Grep...Gravatar Christian Hesse1-0/+21
... that returns the first line that matches a pattern.
2023-01-12global-functions: $MkDir: no early continue for dir "tmpfs"...Gravatar Christian Hesse1-1/+1
... as we want a RAM disk.
2023-01-12global-functions: $ScriptInstallUpdate: handle config version decrease...Gravatar Christian Hesse1-1/+7
... and log a warning.
2023-01-12mod/notification-*: support extra text (or emojis 🚀) in notification tagschange-87Gravatar Christian Hesse1-1/+1
2023-01-11mod/notification-email: move $QuotedPrintable (from global-functions)Gravatar Christian Hesse1-37/+0
This is used for e-mail only...
2023-01-10sms-forward: support hookschange-86Gravatar Anatoly Bubenkov1-1/+1
2023-01-02update copyright for 2023Gravatar Christian Hesse1-1/+1
2022-12-13global-functions: $MkDir: create a tmpfs (RAM disk)...routeros-7.7rc1Gravatar Christian Hesse1-0/+10
... if the path starts with "tmpfs/". This helps to mitigate flash wear.
2022-12-13global-functions: $MkDir: create directories recursivelyGravatar Christian Hesse1-14/+30
2022-12-13global-functions: $MkDir: rename internal variableGravatar Christian Hesse1-10/+10
2022-12-13global-functions: $MkDir: fail if non-directory path existsGravatar Christian Hesse1-0/+5
2022-12-12global-functions: check RouterOS version before loading modulesGravatar Christian Hesse1-3/+3
2022-12-06global-functions: $SymbolByUnicodeName: append variation selector-16...Gravatar Christian Hesse1-1/+1
... to specify that the preceding character should be displayed with emoji presentation. https://unicode-table.com/en/FE0F/
2022-11-29global-functions: introduce $IsMacLocallyAdministered...Gravatar Christian Hesse1-1/+11
... and use it in $GetMacVendor.
2022-11-22global-functions: $IsTimeSync: no cloud on x86Gravatar Christian Hesse1-2/+3
2022-11-22global-functions: $IsTimeSync: no cloud with CHR free licenseGravatar Christian Hesse1-0/+5
2022-11-22global-functions: $ScriptLock: use shorter random stringGravatar Christian Hesse1-2/+2
... but with all characters from alphabet with $GetRandom20CharAlNum.
2022-11-22global-functions: $MkDir: use shorter random stringGravatar Christian Hesse1-2/+2
... but with all characters from alphabet with $GetRandom20CharAlNum.
2022-09-28global-functions: $ScriptInstallUpdate: disable notification only...Gravatar Christian Hesse1-16/+16
... if requested, but keep output and logs.
2022-09-28global-functions: $ScriptInstallUpdate: drop dead code...Gravatar Christian Hesse1-4/+1
2022-09-25global-functions: $ScriptInstallUpdate: drop code for permission workaroundGravatar Christian Hesse1-4/+1
This is no longer used as 'netwatch-syslog' is gone.
2022-09-25drop 'netwatch-syslog'change-85Gravatar Christian Hesse1-1/+1
To filter in firewall you should use something like this: /ip/firewall/filter/add action=reject chain=output out-interface-list=WAN port=514 protocol=udp reject-with=icmp-admin-prohibited; /ip/firewall/filter/add action=reject chain=forward out-interface-list=WAN port=514 protocol=udp reject-with=icmp-admin-prohibited;
2022-09-25introduce 'mod/notification-email', split off from global-functionschange-84Gravatar Christian Hesse1-128/+1
2022-09-25global-functions: $FlushEmailQueue: do not flush if sendingGravatar Christian Hesse1-0/+5
2022-09-20global-functions: $GetMacVendor: detect locally administered addressesGravatar Christian Hesse1-0/+4
https://en.wikipedia.org/wiki/MAC_address#Universal_vs._local_(U/L_bit)
2022-09-15global-functions: $FlushEmailQueue: use $0 for scheduler nameGravatar Christian Hesse1-6/+6
2022-09-15global-functions: $FlushEmailQueue: do not flush with resolver issuesGravatar Christian Hesse1-0/+6
Flushing the mail queue with resolver issues can flood the log with messages like: e-mail;error Error sending e-mail <=?utf-8?Q?[MikroTik] =F0=9F=92=BE=E2=98=81 Cloud backup?=>: DNS resolve failed Try to avoid this...
2022-09-13global-functions: $GetMacVendor: switched to Let's Encrypt (R3)Gravatar Christian Hesse1-1/+1
So let's check for the correct one, and drop the other.
2022-09-09global-functions: $ScriptInstallUpdate: prepare for future certificate chainGravatar Christian Hesse1-0/+4
2022-09-07global-functions: introduce $GetRandom20CharAlNumGravatar Christian Hesse1-0/+8
2022-09-07global-functions: $GetRandom20CharHex: add optional parameter for lengthGravatar Christian Hesse1-1/+3
2022-08-25global-functions: $SymbolByUnicodeName: add 'earth'Gravatar Christian Hesse1-0/+1
2022-08-05global-functions: $GetRandomNumber: use :rndnumGravatar Michael Gisbers1-8/+2
This is available in RouterOS 7.x... Signed-off-by: Christian Hesse <mail@eworm.de>
2022-08-05global-functions: $GetRandom20CharHex: use :rndstrGravatar Michael Gisbers1-1/+1
This is available in RouterOS 7.x... Signed-off-by: Christian Hesse <mail@eworm.de>
2022-07-21global-functions: $IsTimeSync: cache a positive resultGravatar Christian Hesse1-0/+8
The functions do not rely on perfectly synced time. About the right time is fine, that should make sure certificates are valid and mails are sent with reasonable headers. So cache the result if system is fine for later use.
2022-07-21global-functions: $IsTimeSync: drop the extra condition...Gravatar Christian Hesse1-1/+1
... as ddns is not required to be enabled. The public address is available anyway, but not set in DNS.
2022-07-21global-functions: $IsTimeSync: drop old codeGravatar Christian Hesse1-8/+2
In RouterOS 7.x the ntp client and server are bundled and unique and can not be unavailable. Also it does no longer have a 'last-adjustment' property...
2022-07-21global-functions: $IsFullyConnected: remove trailing spaceGravatar Christian Hesse1-1/+1
2022-07-13global-functions: update initialization of empty arrayGravatar Christian Hesse1-7/+7
Having the parenthesis here is important for valid syntax!
2022-07-06global-config: new setting to disable news and change notifications...change-83Gravatar Christian Hesse1-14/+10
... and also drop the version from global-config and global-config-overlay.
2022-07-06netwatch-notify: rename parameter: hostname -> namechange-82Gravatar Christian Hesse1-1/+1
Starting with RouterOS 7.4 the netwatch tool has been extended, it can now do tcp and http probes. Rename the parameter for reasonable naming with services.
2022-07-05global-functions: introduce function $PrettyPrintGravatar Christian Hesse1-0/+10
... to add trailing carriage return when printing to terminal: [admin@MikroTik] > $PrettyPrint [ $DeviceInfo ] Hostname: MikroTik Board name: hAP ac^2 Architecture: arm Model: RouterBOARD D52G-5HacD2HnD-TC Serial number: 8A2A09A221A1 RouterOS: Channel: testing Installed: 7.4rc1 RouterOS-Scripts: Current: 81
2022-06-28global-functions: $ScriptInstallUpdate: remove script on failure when installingGravatar Christian Hesse1-1/+7
2022-06-20global-functions: introduce function $IsFullyConnectedGravatar Christian Hesse1-0/+19
2022-06-20global-functions: rename internal function: $TimeIsSync -> $IsTimeSyncGravatar Christian Hesse1-33/+33
2022-06-20global-functions: rename internal function: $DNSIsResolving -> $IsDNSResolvingGravatar Christian Hesse1-15/+15
2022-06-20global-functions: rename internal function: $DefaultRouteIsReachable -> ↵Gravatar Christian Hesse1-11/+11
$IsDefaultRouteReachable
2022-06-17global-functions: $WaitTimeSync: drop declaration of unused functionGravatar Christian Hesse1-1/+0
2022-06-16fix typos: 'at lease' -> 'at least'Gravatar Christian Hesse1-2/+2
2022-06-15drop script 'rotate-ntp'change-81Gravatar Christian Hesse1-9/+1
For RouterOS 6.x a separate package 'ntp' exists. This adds server functionality, but allows ip addresses for the client only. I added the script 'rotate-ntp' to update addresses from names... Now with RouterOS 7.x there's no extra package and the limitation does no longer exist. So let's just drop the script. This adds migration code, that... * removes the script from configuration * removes a scheduler from configuration * sets the configured ntp pool name for ntp client
2022-05-20log-forward: change symbol for notificationGravatar Christian Hesse1-0/+1
2022-05-17global-functions: $FlushEmailQueue: return if time is not syncedGravatar Christian Hesse1-0/+6
The local system time is used in the mail header. We do not want the mails to be sent in the past, so return early (and thus wait for time being synced).
2022-05-12notify about freeze of routeros-v7 branchchange-80Gravatar Christian Hesse1-1/+1
2022-05-11global-functions: RouterOS v7 path syntaxGravatar Christian Hesse1-83/+78
2022-04-28global-functions: $LogPrintExit2: handle empty nameGravatar Christian Hesse1-1/+1
2022-04-28global-functions: catch runtime error when loading modulesGravatar Christian Hesse1-1/+5
2022-04-28global-functions: validate syntax of modulesGravatar Christian Hesse1-1/+6
2022-04-28global-functions: set $0 with script nameGravatar Christian Hesse1-2/+4
Now that we have some active code at the bottom...
2022-04-26global-functions: $DefaultRouteIsReachable: update properties for ROS 7.xrouteros-7.x-6Gravatar Christian Hesse1-1/+1
2022-04-26global-functions: $ScriptInstallUpdate: support giving comment...Gravatar Christian Hesse1-2/+3
... for new scripts. This allows to have extra settings from the beginning, for example: $ScriptInstallUpdate script1,script2 "base-url=https://example.com/your/custom/repository/"
2022-03-30introduce backup-partitionchange-79Gravatar Christian Hesse1-1/+1
2022-03-08global-functions: (re-)introduce global $ReadGravatar Christian Hesse1-0/+6
... to interactively read input from user on terminal.
2022-03-01global-functions: $FlushEmailQueue: delay if "in-progress"...Gravatar Christian Hesse1-0/+1
Something else is sending a mail... Let's wait and hope the status is not confused.
2022-02-24global-functions: $DeviceInfo: firmware only if upgrade pendingGravatar Christian Hesse1-1/+2
2022-02-21doc/mod: notify about new documentationchange-78Gravatar Christian Hesse1-1/+1
2022-02-10global-functions: $DownloadPackage: handle special casesGravatar Christian Hesse1-7/+3
This is a RouterOS v7 only change! * Revert commit 1e6931c8e34d5035cb07baa98b57eccbcd4278ab (but keep the cherry-picked one in branch routeros-v6). * Drop special case 'routeros-$arch', which no longer exists. * Update package name 'system' to 'routeros'. This should be the correct name, and is expected by CAPsMAN. No idea why package-name property for the file is different...
2022-02-10global-functions: $MkDir: do not act without directoryGravatar Christian Hesse1-0/+4
2022-02-10introduce firmware-upgrade-rebootchange-77Gravatar Christian Hesse1-1/+1
2022-02-10netwatch-notify: allow to suppress notification on host downchange-76Gravatar Christian Hesse1-1/+1
2022-01-20global-functions: $ScriptInstallUpdate: quote names in log outputGravatar Christian Hesse1-9/+9
2022-01-20global-functions: $ScriptInstallUpdate: give final url in debug outputGravatar Christian Hesse1-7/+6
2022-01-17global-functions: $DownloadPackage: handle special case with nameGravatar Christian Hesse1-0/+4
For RouterOS 6.x bundled package version and architecture are swapped. Closes: #21
2022-01-17global-functions: $DownloadPackage: give url in debug outputGravatar Christian Hesse1-3/+3
2022-01-14global: notify about merging 'routeros-v7' into 'main'change-75Gravatar Christian Hesse1-1/+1
2022-01-14global-functions: bump the required version for RouterOS 7.xGravatar Christian Hesse1-5/+4
... but keep a warning when running RouterOS v6.
2022-01-07hotspot-to-wpa: support settings from templatechange-74Gravatar Christian Hesse1-1/+1
2022-01-06Migrate configuration and send notification on renameschange-73Gravatar Christian Hesse1-1/+1
2022-01-03introduce netwatch-dnschange-72Gravatar Christian Hesse1-1/+1
2022-01-01update copyright for 2022Gravatar Christian Hesse1-1/+1
2021-12-20global-functions: $RequiredRouterOS: fix warningGravatar Christian Hesse1-5/+4
Passing a boolean does not work... Handle as string.
2021-12-14global-functions: $DownloadPackage: make directory firstGravatar Christian Hesse1-0/+6
The fetch command creates the directory itself, however using $MkDir gives better error message when creating directory fails.
2021-12-14global-functions: $MkDir: log errorGravatar Christian Hesse1-1/+3
2021-12-14global-functions: $NotificationFunctions->"email": do not declare unused ↵Gravatar Christian Hesse1-1/+0
function
2021-12-13global-functions: $DeviceInfo: show license level if availableGravatar Christian Hesse1-0/+3
This now shows license level for CHR. The property is named different for Routerboards. As these have the license bundled to hardware anyway we do not show it there.
2021-12-13README: changes for RouterOS v6change-71Gravatar Christian Hesse1-1/+1
2021-12-10global-functions: $ScriptLock: simplify cleanup codeGravatar Christian Hesse1-5/+2
2021-12-09global-functions: $ScriptLock: remove ticket in a loopGravatar Christian Hesse1-1/+2
This was not required with RouterOS v6, but for any reason removing a ticket may fail with RouterOS v7 in very rare cases. So remove in a loop...
2021-12-09global-functions: $ScriptLock: cleanup in dedicated functionGravatar Christian Hesse1-4/+13
2021-12-09global-functions: $ScriptLock: initialize earlierGravatar Christian Hesse1-4/+3
2021-12-09global-functions: $ScriptLock: initialize empty array on cleanupGravatar Christian Hesse1-2/+2
2021-12-07global-functions: give a hint on RouterOS v7Gravatar Christian Hesse1-0/+6
2021-12-07global-config: load overlay automaticallyGravatar Christian Hesse1-4/+4
2021-12-07README: changes for RouterOS v7change-70Gravatar Christian Hesse1-1/+1
2021-11-22global-functions: $DeviceInfo: add current firmwareGravatar Christian Hesse1-0/+2
(I would like to show a note if the upgrade is pending... But did not find a way to get that information. Is there?)
2021-11-16check-health: support hard lower limit for voltagechange-69Gravatar Christian Hesse1-1/+1
... to detect slow decrease of voltage, for example with UPS.