fix(logger): Fix JournalD log levels

Log levels were reversed in the translation function.

.gitattributes

@@ -55,6 +55,23 @@
 *.bat      text eol=crlf
 *.cmd      text eol=crlf
 
+# web frontend stack -- force LF so SRI hashes are always correct
+*.html     text eol=lf
+*.htm      text eol=lf
+*.css      text eol=lf
+*.min.css  text eol=lf
+*.js       text eol=lf
+*.min.js   text eol=lf
+*.php      text eol=lf
+
+# Visual Studio projects (Rider also)
+*.cs     diff=csharp
+*.sln    merge=union
+*.csproj merge=union
+*.vbproj merge=union
+*.fsproj merge=union
+*.dbproj merge=union
+
 # Serialisation
 *.json     text
 *.toml     text
@@ -76,6 +93,8 @@
 # Exclude files from exporting
 #
 
-.gitattributes export-ignore
+.gitattributes  export-ignore
-.gitignore     export-ignore
+.gitignore      export-ignore
-.gitkeep       export-ignore
+.gitkeep        export-ignore
+.idea           export-ignore
+.vscode         export-ignore

.gitignore

@@ -1 +1,35 @@
+#
+# JetBrains exclusions
+#
+
+riderModule.iml
+/_ReSharper.Caches/
+
+# User-specific stuff
+.idea/**/workspace.xml
+.idea/**/tasks.xml
+.idea/**/usage.statistics.xml
+.idea/**/dictionaries
+.idea/**/shelf
+
+# Generated files
+.idea/**/contentModel.xml
+.idea/**/GitCommitMessageStorage.xml
+
+# Sensitive or high-churn files
+.idea/**/dataSources/
+.idea/**/dataSources.ids
+.idea/**/dataSources.local.xml
+.idea/**/sqlDataSources.xml
+.idea/**/dynamic.xml
+.idea/**/uiDesigner.xml
+.idea/**/dbnavigator.xml
+
+# modules
+.idea_modules/
+
+# Editor-based Rest Client
+.idea/httpRequests
+
+# project-specific exclusions
 *.log

.idea/developer-tools.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="DeveloperToolsToolWindowSettingsV1" lastSelectedContentNodeId="base64-encoder-decoder" pluginVersion="9.0.0">
+    <developerToolsConfigurations />
+  </component>
+</project>

.idea/git_toolbox_prj.xml

@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="GitToolBoxProjectSettings">
+    <option name="commitMessageIssueKeyValidationOverride">
+      <BoolValueOverride>
+        <option name="enabled" value="true" />
+      </BoolValueOverride>
+    </option>
+    <option name="commitMessageValidationEnabledOverride">
+      <BoolValueOverride>
+        <option name="enabled" value="true" />
+      </BoolValueOverride>
+    </option>
+  </component>
+</project>

.idea/indexLayout.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="UserContentModel">
+    <attachedFolders />
+    <explicitIncludes />
+    <explicitExcludes />
+  </component>
+</project>

.idea/misc.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="com.itcodebox.notebooks.projectservice.ProjectUIState">
+    <option name="selectedNotebookId" value="1" />
+    <option name="selectedChapterId" value="1" />
+    <option name="selectedNoteId" value="1" />
+  </component>
+</project>

.idea/projectSettingsUpdater.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="RiderProjectSettingsUpdater">
+    <option name="singleClickDiffPreview" value="1" />
+    <option name="unhandledExceptionsIgnoreList" value="1" />
+    <option name="vcsConfiguration" value="3" />
+  </component>
+</project>

.idea/vcs.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="" vcs="Git" />
+  </component>
+</project>

cfddns.sh

@@ -3,256 +3,261 @@
 #
 # update Cloudflare DNS records with current (dynamic) IP address
 #    Script by Asif Bacchus <asif@bacchus.cloud>
-#    Last modified: May 10, 2021
+#    Last modified: July 19, 2026
-#    Version 2.2
+#    Version 3.0
 #
 
 ### text formatting presets using tput
 if command -v tput >/dev/null; then
-    [ -z "$TERM" ] && export TERM=xterm
+  [ -z "$TERM" ] && export TERM=xterm
-    bold=$(tput bold)
+  bold=$(tput bold)
-    cyan=$(tput setaf 6)
+  cyan=$(tput setaf 6)
-    err=$(tput bold)$(tput setaf 1)
+  err=$(tput bold)$(tput setaf 1)
-    magenta=$(tput setaf 5)
+  magenta=$(tput setaf 5)
-    norm=$(tput sgr0)
+  norm=$(tput sgr0)
-    ok=$(tput setaf 2)
+  ok=$(tput setaf 2)
-    warn=$(tput bold)$(tput setaf 3)
+  warn=$(tput bold)$(tput setaf 3)
-    yellow=$(tput setaf 3)
+  yellow=$(tput setaf 3)
-    width=$(tput cols)
+  width=$(tput cols)
 else
-    bold=""
+  bold=""
-    cyan=""
+  cyan=""
-    err=""
+  err=""
-    magenta=""
+  magenta=""
-    norm=""
+  norm=""
-    ok=""
+  ok=""
-    warn=""
+  warn=""
-    yellow=""
+  yellow=""
-    width=80
+  width=80
 fi
 
 ### functions
 badParam() {
-    if [ "$1" = "null" ]; then
+  if [ "$1" = "null" ]; then
-        printf "\n%sERROR: '%s' cannot have a NULL (empty) value.\n" "$err" "$2"
+    printf "\n%sERROR: '%s' cannot have a NULL (empty) value.\n" "$err" "$2"
-        printf "%sPlease use '--help' for assistance.%s\n\n" "$cyan" "$norm"
+    printf "%sPlease use '--help' for assistance.%s\n\n" "$cyan" "$norm"
-        exit 1
+    exit 1
-    elif [ "$1" = "dne" ]; then
+  elif [ "$1" = "dne" ]; then
-        printf "\n%sERROR: '%s %s'\n" "$err" "$2" "$3"
+    printf "\n%sERROR: '%s %s'\n" "$err" "$2" "$3"
-        printf "file or directory does not exist or is empty.%s\n\n" "$norm"
+    printf "file or directory does not exist or is empty.%s\n\n" "$norm"
-        exit 1
+    exit 1
-    elif [ "$1" = "errMsg" ]; then
+  elif [ "$1" = "errMsg" ]; then
-        printf "\n%sERROR: %s%s\n\n" "$err" "$2" "$norm"
+    printf "\n%sERROR: %s%s\n\n" "$err" "$2" "$norm"
-        exit 1
+    exit 1
-    fi
+  fi
 }
 
 exitError() {
-    case "$1" in
+  case "$1" in
-    3)
+  3)
-        errMsg="Unable to connect to Cloudflare servers. This is probably a temporary networking issue. Please try again later."
+    errMsg="Unable to connect to Cloudflare servers. This is probably a temporary networking issue. Please try again later."
-        ;;
+    ;;
-    10)
+  10)
-        errMsg="Unable to auto-detect IP address. Try again later or supply the IP address to be used."
+    errMsg="Unable to auto-detect IP address. Try again later or supply the IP address to be used."
-        ;;
+    ;;
-    20)
+  20)
-        errMsg="Cloudflare authorized email address (cfEmail) is either null or undefined. Please check your Cloudflare credentials file."
+    errMsg="Cloudflare authorized email address (cfEmail) is either null or undefined. Please check your Cloudflare credentials file."
-        ;;
+    ;;
-    21)
+  21)
-        errMsg="Cloudflare authorized API key (cfKey) is either null or undefined. Please check your Cloudflare credentials file."
+    errMsg="Cloudflare authorized API key (cfKey) is either null or undefined. Please check your Cloudflare credentials file."
-        ;;
+    ;;
-    22)
+  22)
-        errMsg="Cloudflare zone id (cfZoneId) is either null or undefined. Please check your Cloudflare credentials file."
+    errMsg="Cloudflare zone id (cfZoneId) is either null or undefined. Please check your Cloudflare credentials file."
-        ;;
+    ;;
-    25)
+  25)
-        errMsg="Cloudflare API error. Please review any 'CF-ERR:' lines in this log for details."
+    errMsg="Cloudflare API error. Please review any 'CF-ERR:' lines in this log for details."
-        ;;
+    ;;
-    26)
+  26)
-        errMsg="${failedHostCount} host update(s) failed. Any 'CF-ERR:' lines noted in this log may help determine what went wrong."
+    errMsg="${failedHostCount} host update(s) failed. Any 'CF-ERR:' lines noted in this log may help determine what went wrong."
-        ;;
+    ;;
-    *)
+  *)
-        writeLog error "An unspecified error occurred. (code: 99)"
+    writeLog error "An unspecified error occurred. (code: 99)"
-        printf "%s[%s] -- Cloudflare DDNS update-script: completed with error(s) --%s\n" "$err" "$(stamp)" "$norm" >>"$logFile"
-        exit 99
-        ;;
-    esac
-    writeLog error "$errMsg" "$1"
     printf "%s[%s] -- Cloudflare DDNS update-script: completed with error(s) --%s\n" "$err" "$(stamp)" "$norm" >>"$logFile"
-    exit "$1"
+    exit 99
+    ;;
+  esac
+  writeLog error "$errMsg" "$1"
+  printf "%s[%s] -- Cloudflare DDNS update-script: completed with error(s) --%s\n" "$err" "$(stamp)" "$norm" >>"$logFile"
+  exit "$1"
 }
 
 exitOK() {
-    printf "%s[%s] -- Cloudflare DDNS update-script: completed successfully --%s\n" "$ok" "$(stamp)" "$norm" >>"$logFile"
+  printf "%s[%s] -- Cloudflare DDNS update-script: completed successfully --%s\n" "$ok" "$(stamp)" "$norm" >>"$logFile"
-    exit 0
+  exit 0
 }
 
 listCFErrors() {
-    # extract error codes and messages in separate variables, replace newlines with underscores
+  # extract error codes and messages in separate variables, replace newlines with underscores
-    codes="$(printf "%s" "$1" | jq -r '.errors | .[] | .code' | tr '\n' '_')"
+  codes="$(printf "%s" "$1" | jq -r '.errors | .[] | .code' | tr '\n' '_')"
-    messages="$(printf "%s" "$1" | jq -r '.errors | .[] | .message' | tr '\n' '_')"
+  messages="$(printf "%s" "$1" | jq -r '.errors | .[] | .message' | tr '\n' '_')"
 
-    # iterate codes and messages and assemble into coherent messages in log
+  # iterate codes and messages and assemble into coherent messages in log
-    while [ -n "$codes" ] && [ -n "$messages" ]; do
+  while [ -n "$codes" ] && [ -n "$messages" ]; do
-        # get first code and message in respective sets
+    # get first code and message in respective sets
-        code="${codes%%_*}"
+    code="${codes%%_*}"
-        message="${messages%%_*}"
+    message="${messages%%_*}"
 
-        # update codes and messages sets by removing first item in each set
+    # update codes and messages sets by removing first item in each set
-        codes="${codes#*_}"
+    codes="${codes#*_}"
-        messages="${messages#*_}"
+    messages="${messages#*_}"
 
-        # output to log
+    # output to log
-        writeLog cf "$message" "$code"
+    writeLog cf "$message" "$code"
-    done
+  done
 }
 
 scriptExamples() {
-    newline
+  newline
-    printf "Update Cloudflare DNS host A/AAAA records with current IP address.\n"
+  printf "Update Cloudflare DNS host A/AAAA records with current IP address.\n"
-    printf "%sUsage: %s --records host.domain.tld[,host2.domain.tld,...] [parameters]%s\n\n" "$bold" "$scriptName" "$norm"
+  printf "%sUsage: %s --records host.domain.tld[,host2.domain.tld,...] [parameters]%s\n\n" "$bold" "$scriptName" "$norm"
-    textBlock "${magenta}--- usage examples ---${norm}"
+  textBlock "${magenta}--- usage examples ---${norm}"
-    newline
+  newline
-    textBlockSwitches "${scriptName} -r myserver.mydomain.net"
+  textBlockSwitches "${scriptName} -r myserver.mydomain.net"
-    textBlock "Update Cloudflare DNS records for myserver.mydomain.net with the auto-detected public IP4 address. Credentials will be expected in the default location and the log will be written in the default location also."
+  textBlock "Update Cloudflare DNS records for myserver.mydomain.net with the auto-detected public IP4 address. Credentials will be expected in the default location and the log will be written in the default location also."
-    newline
+  newline
-    textBlockSwitches "${scriptName} -r myserver.mydomain.net -6"
+  textBlockSwitches "${scriptName} -r myserver.mydomain.net -6"
-    textBlock "Same as above, but update AAAA host records with the auto-detected public IP6 address."
+  textBlock "Same as above, but update AAAA host records with the auto-detected public IP6 address."
-    newline
+  newline
-    textBlockSwitches "${scriptName} -r myserver.mydomain.net,myserver2.mydomain.net -l /var/log/cfddns.log --nc"
+  textBlockSwitches "${scriptName} -r myserver.mydomain.net,myserver2.mydomain.net -l /var/log/cfddns.log --nc"
-    textBlock "Update DNS entries for both listed hosts using auto-detected IP4 address. Write a non-coloured log to '/var/log/cfddns.log'."
+  textBlock "Update DNS entries for both listed hosts using auto-detected IP4 address. Write a non-coloured log to '/var/log/cfddns.log'."
-    newline
+  newline
-    textBlockSwitches "${scriptName} -r myserver.mydomain.net,myserver2.mydomain.net -l /var/log/cfddns.log --ip6 --ip fd21:7a62:2737:9c3a::a151"
+  textBlockSwitches "${scriptName} -r myserver.mydomain.net,myserver2.mydomain.net -l /var/log/cfddns.log --ip6 --ip fd21:7a62:2737:9c3a::a151"
-    textBlock "Update DNS AAAA entries for listed hosts using the *specified* IP address. Write a colourful log to the location specified."
+  textBlock "Update DNS AAAA entries for listed hosts using the *specified* IP address. Write a colourful log to the location specified."
-    newline
+  newline
-    textBlockSwitches "${scriptName} -r myserver.mydomain.net -c /root/cloudflare.creds -l /var/log/cfddns.log --ip 1.2.3.4"
+  textBlockSwitches "${scriptName} -r myserver.mydomain.net -c /root/cloudflare.creds -l /var/log/cfddns.log --ip 1.2.3.4"
-    textBlock "Update DNS A entry for listed hostname with the provided IP address. Read cloudflare credentials file from specified location, save log in specified location."
+  textBlock "Update DNS A entry for listed hostname with the provided IP address. Read cloudflare credentials file from specified location, save log in specified location."
-    newline
+  newline
-    textBlockSwitches "${scriptName} -r myserver.mydomain.net -c /root/cloudflare.creds -l /var/log/cfddns.log -6 -i fd21:7a62:2737:9c3a::a151"
+  textBlockSwitches "${scriptName} -r myserver.mydomain.net -c /root/cloudflare.creds -l /var/log/cfddns.log -6 -i fd21:7a62:2737:9c3a::a151"
-    textBlock "Exact same as above, but change the AAAA record. This is how you run the script once for IP4 and again for IP6."
+  textBlock "Exact same as above, but change the AAAA record. This is how you run the script once for IP4 and again for IP6."
-    exit 0
+  exit 0
 }
 
 scriptHelp() {
-    newline
+  newline
-    printf "Update Cloudflare DNS host A/AAAA records with current IP address.\n"
+  printf "Update Cloudflare DNS host A/AAAA records with current IP address.\n"
-    printf "%sUsage: %s --records host.domain.tld[,host2.domain.tld,...] [parameters]%s\n\n" "$bold" "$scriptName" "$norm"
+  printf "%sUsage: %s --records host.domain.tld[,host2.domain.tld,...] [parameters]%s\n\n" "$bold" "$scriptName" "$norm"
-    textBlock "The only required parameter is '--records' which is a comma-delimited list of hostnames to update. However, there are several other options which may be useful to implement."
+  textBlock "The only required parameter is '--records' which is a comma-delimited list of hostnames to update. However, there are several other options which may be useful to implement."
-    textBlock "Parameters are listed below and followed by a description of their effect. If a default value exists, it will be listed on the following line in (parentheses)."
+  textBlock "Parameters are listed below and followed by a description of their effect. If a default value exists, it will be listed on the following line in (parentheses)."
-    newline
+  newline
-    textBlock "${magenta}--- script related parameters ---${norm}"
+  textBlock "${magenta}--- script related parameters ---${norm}"
-    newline
+  newline
-    textBlockSwitches "-c | --cred | --creds | --credentials | -f (deprecated, backward-compatibility)"
+  textBlockSwitches "-c | --cred | --creds | --credentials | -f (deprecated, backward-compatibility)"
-    textBlock "Path to file containing your Cloudflare *token* credentials. Please refer to the repo README for more information on format, etc."
+  textBlock "Path to file containing your Cloudflare *token* credentials. Please refer to the repo README for more information on format, etc."
-    textBlockDefaults "(${accountFile})"
+  textBlockDefaults "(${accountFile})"
-    newline
+  newline
-    textBlockSwitches "-l | --log"
+  textBlockSwitches "-l | --log"
-    textBlock "Path where the log file should be written."
+  textBlock "Path where the log file should be written."
-    textBlockDefaults "(${logFile})"
+  textBlockDefaults "(${logFile})"
-    newline
+  newline
-    textBlockSwitches "--nc | --no-color | --no-colour"
+  textBlockSwitches "--nc | --no-color | --no-colour"
-    textBlock "Switch value. Disables ANSI colours in the log. Useful if you review the logs using a reader that does not parse ANSI colour codes."
+  textBlock "Switch value. Disables ANSI colours in the log. Useful if you review the logs using a reader that does not parse ANSI colour codes."
-    textBlockDefaults "(disabled: print logs in colour)"
+  textBlockDefaults "(disabled: print logs in colour)"
-    newline
+  newline
-    textBlockSwitches "--log-console"
+  textBlockSwitches "--log-console"
-    textBlock "Switch value. Output log to console (stdout) instead of a log file. Can be combined with --nc if desired."
+  textBlock "Switch value. Output log to console (stdout) instead of a log file. Can be combined with --nc if desired."
-    textBlockDefaults "(disabled: output to log file)"
+  textBlockDefaults "(disabled: output to log file)"
-    newline
+  newline
-    textBlockSwitches "--no-log"
+  textBlockSwitches "--log-journal"
-    textBlock "Switch value. Do not create a log (i.e. no console, no file). You will not have *any* output from the script if you choose this option, so you will not know if updates succeeded or failed."
+  textBlock "Switch value. Output a structured log entry to your journaling system instead of a log file. Implies --nc."
-    textBlockDefaults "(disabled: output to log file)"
+  textBlockDefaults "(disabled: output to log file)"
-    newline
+  newline
-    textBlockSwitches "-h | --help | -?"
+  textBlockSwitches "--no-log"
-    textBlock "Display this help screen."
+  textBlock "Switch value. Do not create a log (i.e. no console, no file). You will not have *any* output from the script if you choose this option, so you will not know if updates succeeded or failed."
-    newline
+  textBlockDefaults "(disabled: output to log file)"
-    textBlockSwitches "--examples"
+  newline
-    textBlock "Show some usage examples."
+  textBlockSwitches "-h | --help | -?"
-    newline
+  textBlock "Display this help screen."
-    textBlock "${magenta}--- DNS related parameters ---${norm}"
+  newline
-    newline
+  textBlockSwitches "--examples"
-    textBlockSwitches "-r | --record | --records"
+  textBlock "Show some usage examples."
-    textBlock "Comma-delimited list of hostnames for which IP addresses should be updated in Cloudflare DNS. This parameter is REQUIRED. Note that this script will only *update* records, it will not create new ones. If you supply hostnames that are not already defined in DNS, the script will log a warning and will skip those hostnames."
+  newline
-    newline
+  textBlock "${magenta}--- DNS related parameters ---${norm}"
-    textBlockSwitches "-i | --ip | --ip-address | -a | --address"
+  newline
-    textBlock "New IP address for DNS host records. If you omit this, the script will attempt to auto-detect your public IP address and use that."
+  textBlockSwitches "-r | --record | --records"
-    newline
+  textBlock "Comma-delimited list of hostnames for which IP addresses should be updated in Cloudflare DNS. This parameter is REQUIRED. Note that this script will only *update* records, it will not create new ones. If you supply hostnames that are not already defined in DNS, the script will log a warning and will skip those hostnames."
-    textBlockSwitches "-4 | --ip4 | --ipv4"
+  newline
-    textBlock "Switch value. Update Host 'A' records (IP4) only. Note that this script can only update either A *or* AAAA records. If you need to update both, you'll have to run the script once in IP4 mode and again in IP6 mode. If you specify both this switch and the IP6 switch, the last one specified will take effect."
+  textBlockSwitches "-i | --ip | --ip-address | -a | --address"
-    textBlockDefaults "(enabled: update A records)"
+  textBlock "New IP address for DNS host records. If you omit this, the script will attempt to auto-detect your public IP address and use that."
-    newline
+  newline
-    textBlockSwitches "-6 | --ip6 | --ipv6"
+  textBlockSwitches "-4 | --ip4 | --ipv4"
-    textBlock "Switch value. Update Host 'AAAA' records (IP6) only. Note that this script can only update either A *or* AAAA records. If you need to update both, you'll have to run the script once in IP4 mode and again in IP6 mode. If you specify both this switch and the IP4 switch, the last one specified will take effect."
+  textBlock "Switch value. Update Host 'A' records (IP4) only. Note that this script can only update either A *or* AAAA records. If you need to update both, you'll have to run the script once in IP4 mode and again in IP6 mode. If you specify both this switch and the IP6 switch, the last one specified will take effect."
-    textBlockDefaults "(disabled: update A records)"
+  textBlockDefaults "(enabled: update A records)"
-    newline
+  newline
-    textBlock "Please refer to the repo README for more detailed information regarding this script and how to automate and monitor it."
+  textBlockSwitches "-6 | --ip6 | --ipv6"
-    newline
+  textBlock "Switch value. Update Host 'AAAA' records (IP6) only. Note that this script can only update either A *or* AAAA records. If you need to update both, you'll have to run the script once in IP4 mode and again in IP6 mode. If you specify both this switch and the IP4 switch, the last one specified will take effect."
-    exit 0
+  textBlockDefaults "(disabled: update A records)"
+  newline
+  textBlock "Please refer to the repo README for more detailed information regarding this script and how to automate and monitor it."
+  newline
+  exit 0
 }
 
 stamp() {
-    (date +%F" "%T)
+  (date +%F" "%T)
 }
 
 newline() {
-    printf "\n"
+  printf "\n"
 }
 
 textBlock() {
-    printf "%s\n" "$1" | fold -w "$width" -s
+  printf "%s\n" "$1" | fold -w "$width" -s
 }
 
 textBlockDefaults() {
-    printf "%s%s%s\n" "$yellow" "$1" "$norm"
+  printf "%s%s%s\n" "$yellow" "$1" "$norm"
 }
 
 textBlockSwitches() {
-    printf "%s%s%s\n" "$cyan" "$1" "$norm"
+  printf "%s%s%s\n" "$cyan" "$1" "$norm"
 }
 
 writeLog() {
-    case "$1" in
+  case "$1" in
-    cf)
+  cf)
-        printf "[%s] CF-ERR: %s (code: %s)\n" "$(stamp)" "$2" "$3" >>"$logFile"
+    printf "[%s] CF-ERR: %s (code: %s)\n" "$(stamp)" "$2" "$3" >>"$logFile"
-        ;;
+    ;;
-    err)
+  err)
-        printf "%s[%s] ERR: %s%s\n" "$err" "$(stamp)" "$2" "$norm" >>"$logFile"
+    printf "%s[%s] ERR: %s%s\n" "$err" "$(stamp)" "$2" "$norm" >>"$logFile"
-        ;;
+    ;;
-    error)
+  error)
-        printf "%s[%s] ERROR: %s (code: %s)%s\n" "$err" "$(stamp)" "$2" "$3" "$norm" >>"$logFile"
+    printf "%s[%s] ERROR: %s (code: %s)%s\n" "$err" "$(stamp)" "$2" "$3" "$norm" >>"$logFile"
-        ;;
+    ;;
-    process)
+  process)
-        printf "%s[%s] %s... %s" "$cyan" "$(stamp)" "$2" "$norm" >>"$logFile"
+    printf "%s[%s] %s... %s" "$cyan" "$(stamp)" "$2" "$norm" >>"$logFile"
-        ;;
+    ;;
-    process-done)
+  process-done)
-        printf "%s%s%s\n" "$cyan" "$2" "$norm" >>"$logFile"
+    printf "%s%s%s\n" "$cyan" "$2" "$norm" >>"$logFile"
-        ;;
+    ;;
-    process-error)
+  process-error)
-        printf "%sERROR%s\n" "$err" "$norm" >>"$logFile"
+    printf "%sERROR%s\n" "$err" "$norm" >>"$logFile"
-        ;;
+    ;;
-    process-warning)
+  process-warning)
-        printf "%s%s%s\n" "$warn" "$2" "$norm" >>"$logFile"
+    printf "%s%s%s\n" "$warn" "$2" "$norm" >>"$logFile"
-        ;;
+    ;;
-    stamped)
+  stamped)
-        printf "[%s] %s\n" "$(stamp)" "$2" >>"$logFile"
+    printf "[%s] %s\n" "$(stamp)" "$2" >>"$logFile"
-        ;;
+    ;;
-    success)
+  success)
-        printf "%s[%s] SUCCESS: %s%s\n" "$ok" "$(stamp)" "$2" "$norm" >>"$logFile"
+    printf "%s[%s] SUCCESS: %s%s\n" "$ok" "$(stamp)" "$2" "$norm" >>"$logFile"
-        ;;
+    ;;
-    warn)
+  warn)
-        printf "%s[%s] WARN: %s%s\n" "$warn" "$(stamp)" "$2" "$norm" >>"$logFile"
+    printf "%s[%s] WARN: %s%s\n" "$warn" "$(stamp)" "$2" "$norm" >>"$logFile"
-        ;;
+    ;;
-    warning)
+  warning)
-        printf "%s[%s] WARNING: %s%s\n" "$warn" "$(stamp)" "$2" "$norm" >>"$logFile"
+    printf "%s[%s] WARNING: %s%s\n" "$warn" "$(stamp)" "$2" "$norm" >>"$logFile"
-        ;;
+    ;;
-    *)
+  *)
-        printf "%s\n" "$2" >>"$logFile"
+    printf "%s\n" "$2" >>"$logFile"
-        ;;
+    ;;
-    esac
+  esac
 }
 
 ### default variable values
 scriptPath="$(CDPATH='' \cd -- "$(dirname -- "$0")" && pwd -P)"
 scriptName="$(basename "$0")"
 logFile="$scriptPath/${scriptName%.*}.log"
+logToJournal=0
 accountFile="$scriptPath/cloudflare.credentials"
 colourizeLogFile=1
 dnsRecords=""
@@ -267,276 +272,293 @@ failedHostCount=0
 
 ### process startup parameters
 if [ -z "$1" ]; then
-    scriptHelp
+  scriptHelp
 fi
 while [ $# -gt 0 ]; do
-    case "$1" in
+  case "$1" in
-    -h | -\? | --help)
+  -h | -\? | --help)
-        # display help
+  # display help
-        scriptHelp
+    scriptHelp
-        ;;
+    ;;
-    --examples)
+  --examples)
-        # display sample commands
+  # display sample commands
-        scriptExamples
+    scriptExamples
-        ;;
+    ;;
-    -l | --log)
+  -l | --log)
-        # set log file location
+  # set log file location
-        if [ -n "$2" ]; then
+    if [ -n "$2" ]; then
-            logFile="${2%/}"
+      logFile="${2%/}"
-            shift
+      shift
-        else
+    else
-            badParam null "$@"
+      badParam null "$@"
-        fi
+    fi
-        ;;
+    ;;
-    --log-console)
+  --log-console)
-        # log to the console instead of a file
+  # log to the console instead of a file
-        logFile="/dev/stdout"
+    logFile="/dev/stdout"
-        ;;
+    ;;
-    --no-log)
+  --log-journal)
-        # do not log anything
+  # log to the journal system instead of a file
-        logFile="/dev/null"
+    logToJournal=1
-        ;;
+    ;;
-    --nc | --no-color | --no-colour)
+  --no-log)
-        # do not colourize log file
+  # do not log anything
-        colourizeLogFile=0
+    logFile="/dev/null"
-        ;;
+    ;;
-    -c | --cred* | -f)
+  --nc | --no-color | --no-colour)
-        # path to Cloudflare credentials file
+  # do not colourize log file
-        if [ -n "$2" ]; then
+    colourizeLogFile=0
-            if [ -f "$2" ] && [ -s "$2" ]; then
+    ;;
-                accountFile="${2%/}"
+  -c | --cred* | -f)
-                shift
+  # path to Cloudflare credentials file
-            else
+    if [ -n "$2" ]; then
-                badParam dne "$@"
+      if [ -f "$2" ] && [ -s "$2" ]; then
-            fi
+        accountFile="${2%/}"
-        else
+        shift
-            badParam null "$@"
+      else
-        fi
+        badParam dne "$@"
-        ;;
+      fi
-    -r | --record | --records)
+    else
-        # DNS records to update
+      badParam null "$@"
-        if [ -n "$2" ]; then
+    fi
-            dnsRecords=$(printf "%s" "$2" | sed -e 's/ //g')
+    ;;
-            shift
+  -r | --record | --records)
-        else
+  # DNS records to update
-            badParam null "$@"
+    if [ -n "$2" ]; then
-        fi
+      dnsRecords=$(printf "%s" "$2" | sed -e 's/ //g')
-        ;;
+      shift
-    -i | --ip | --ip-address | -a | --address)
+    else
-        # IP address to use (not parsed for correctness)
+      badParam null "$@"
-        if [ -n "$2" ]; then
+    fi
-            ipAddress="$2"
+    ;;
-            shift
+  -i | --ip | --ip-address | -a | --address)
-        else
+  # IP address to use (not parsed for correctness)
-            badParam null "$@"
+    if [ -n "$2" ]; then
-        fi
+      ipAddress="$2"
-        ;;
+      shift
-    -4 | --ip4 | --ipv4)
+    else
-        # operate in IP4 mode (default)
+      badParam null "$@"
-        ip4=1
+    fi
-        ip6=0
+    ;;
-        ;;
+  -4 | --ip4 | --ipv4)
-    -6 | --ip6 | --ipv6)
+  # operate in IP4 mode (default)
-        # operate in IP6 mode
+    ip4=1
-        ip6=1
+    ip6=0
-        ip4=0
+    ;;
-        ;;
+  -6 | --ip6 | --ipv6)
-    *)
+  # operate in IP6 mode
-        printf "\n%sUnknown option: %s\n" "$err" "$1"
+    ip6=1
-        printf "%sUse '--help' for valid options.%s\n\n" "$cyan" "$norm"
+    ip4=0
-        exit 1
+    ;;
-        ;;
+  *)
-    esac
+    printf "\n%sUnknown option: %s\n" "$err" "$1"
-    shift
+    printf "%sUse '--help' for valid options.%s\n\n" "$cyan" "$norm"
+    exit 1
+    ;;
+  esac
+  shift
 done
 
 ### pre-flight checks
 if ! command -v curl >/dev/null; then
-    printf "\n%sThis script requires 'curl' be installed and accessible. Exiting.%s\n\n" "$err" "$norm"
+  printf "\n%sThis script requires 'curl' be installed and accessible. Exiting.%s\n\n" "$err" "$norm"
-    exit 2
+  exit 2
 fi
 if ! command -v jq >/dev/null; then
-    printf "\n%sThis script requires 'jq' be installed and accessible. Exiting.%s\n\n" "$err" "$norm"
+  printf "\n%sThis script requires 'jq' be installed and accessible. Exiting.%s\n\n" "$err" "$norm"
-    exit 2
+  exit 2
 fi
 [ -z "$dnsRecords" ] && badParam errMsg "You must specify at least one DNS record to update. Exiting."
 # verify credentials file exists and is not empty (default check)
 if [ ! -f "$accountFile" ] || [ ! -s "$accountFile" ]; then
-    badParam errMsg "Cannot find Cloudflare credentials file (${accountFile}). Exiting."
+  badParam errMsg "Cannot find Cloudflare credentials file (${accountFile}). Exiting."
+fi
+if ! command -v logger >/dev/null 2>&1; then
+  printf "\n%sThis script requires 'logger' be installed to write entries to your journaling system. Exiting.%s\n\n" "$err" "$norm"
+  exit 2
 fi
 # turn off log file colourization if parameter is set
 if [ "$colourizeLogFile" -eq 0 ]; then
-    bold=""
+  bold=""
-    cyan=""
+  cyan=""
-    err=""
+  err=""
-    magenta=""
+  magenta=""
-    norm=""
+  norm=""
-    ok=""
+  ok=""
-    warn=""
+  warn=""
-    yellow=""
+  yellow=""
 fi
 
 ### initial log entries
 {
-    printf "%s[%s] -- Cloudflare DDNS update-script: starting --%s\n" "$ok" "$(stamp)" "$norm"
-    printf "Parameters:\n"
-    printf "script path: %s\n" "$scriptPath/$scriptName"
-    printf "credentials file: %s\n" "$accountFile"
 
+  printf "%s[%s] -- Cloudflare DDNS update-script: starting --%s\n" "$ok" "$(stamp)" "$norm"
+  printf "Parameters:\n"
+  printf "script path: %s\n" "$scriptPath/$scriptName"
+  printf "credentials file: %s\n" "$accountFile"
+
+  if [ "$ip4" -eq 1 ]; then
+    printf "mode: IP4\n"
+  elif [ "$ip6" -eq 1 ]; then
+    printf "mode: IP6\n"
+  fi
+
+  # detect and report IP address
+  if [ -z "$ipAddress" ]; then
+    # detect public ip address
     if [ "$ip4" -eq 1 ]; then
-        printf "mode: IP4\n"
+      if ! ipAddress="$(curl -s $ip4DetectionSvc)"; then
-    elif [ "$ip6" -eq 1 ]; then
+        printf "ddns ip address:%s ERROR%s\n" "$err" "$norm"
-        printf "mode: IP6\n"
+        exitError 10
+      fi
     fi
-
+    if [ "$ip6" -eq 1 ]; then
-    # detect and report IP address
+      if ! ipAddress="$(curl -s $ip6DetectionSvc)"; then
-    if [ -z "$ipAddress" ]; then
+        printf "ddns ip address:%s ERROR%s\n" "$err" "$norm"
-        # detect public ip address
+        exitError 10
-        if [ "$ip4" -eq 1 ]; then
+      fi
-            if ! ipAddress="$(curl -s $ip4DetectionSvc)"; then
-                printf "ddns ip address:%s ERROR%s\n" "$err" "$norm"
-                exitError 10
-            fi
-        fi
-        if [ "$ip6" -eq 1 ]; then
-            if ! ipAddress="$(curl -s $ip6DetectionSvc)"; then
-                printf "ddns ip address:%s ERROR%s\n" "$err" "$norm"
-                exitError 10
-            fi
-        fi
-        printf "ddns ip address (detected): %s\n" "$ipAddress"
-    else
-        printf "ddns ip address (supplied): %s\n" "$ipAddress"
     fi
+    printf "ddns ip address (detected): %s\n" "$ipAddress"
+  else
+    printf "ddns ip address (supplied): %s\n" "$ipAddress"
+  fi
 
-    # iterate DNS records to update
+  # iterate DNS records to update
-    dnsRecordsToUpdate="$(printf '%s' "${dnsRecords}" | sed "s/${dnsSeparator}*$//")$dnsSeparator"
+  dnsRecordsToUpdate="$(printf '%s' "${dnsRecords}" | sed "s/${dnsSeparator}*$//")$dnsSeparator"
-    while [ -n "$dnsRecordsToUpdate" ] && [ "$dnsRecordsToUpdate" != "$dnsSeparator" ]; do
+  while [ -n "$dnsRecordsToUpdate" ] && [ "$dnsRecordsToUpdate" != "$dnsSeparator" ]; do
-        record="${dnsRecordsToUpdate%%${dnsSeparator}*}"
+    record="${dnsRecordsToUpdate%%${dnsSeparator}*}"
-        dnsRecordsToUpdate="${dnsRecordsToUpdate#*${dnsSeparator}}"
+    dnsRecordsToUpdate="${dnsRecordsToUpdate#*${dnsSeparator}}"
 
-        if [ -z "$record" ]; then continue; fi
+    if [ -z "$record" ]; then
-        printf "updating record: %s\n" "$record"
+      continue
-    done
+    fi
+    printf "updating record: %s\n" "$record"
+  done
 
-    printf "(end of parameter list)\n"
+  printf "(end of parameter list)\n"
 } >>"$logFile"
 
 ### read Cloudflare credentials
 writeLog process "Reading Cloudflare credentials"
 case "$accountFile" in
 /*)
-    # absolute path, use as-is
+# absolute path, use as-is
-    # shellcheck source=./cloudflare.credentials
+# shellcheck source=./cloudflare.credentials
-    . "$accountFile"
+  . "$accountFile"
-    ;;
+  ;;
 *)
-    # relative path, rewrite
+# relative path, rewrite
-    # shellcheck source=./cloudflare.credentials
+# shellcheck source=./cloudflare.credentials
-    . "./$accountFile"
+  . "./$accountFile"
-    ;;
+  ;;
 esac
 if [ -z "$cfKey" ]; then
-    writeLog process-error
+  writeLog process-error
-    exitError 21
+  exitError 21
 fi
 if [ -z "$cfZoneId" ]; then
-    writeLog process-error
+  writeLog process-error
-    exitError 22
+  exitError 22
 fi
 writeLog process-done "DONE"
 
 ### connect to Cloudflare and do what needs to be done!
 dnsRecordsToUpdate="$dnsRecords$dnsSeparator"
 if [ "$ip4" -eq 1 ]; then
-    recordType="A"
+  recordType="A"
 elif [ "$ip6" -eq 1 ]; then
-    recordType="AAAA"
+  recordType="AAAA"
 fi
 
 # iterate hosts to update
 while [ -n "$dnsRecordsToUpdate" ] && [ "$dnsRecordsToUpdate" != "$dnsSeparator" ]; do
-    record="${dnsRecordsToUpdate%%${dnsSeparator}*}"
+  record="${dnsRecordsToUpdate%%${dnsSeparator}*}"
-    dnsRecordsToUpdate="${dnsRecordsToUpdate#*${dnsSeparator}}"
+  dnsRecordsToUpdate="${dnsRecordsToUpdate#*${dnsSeparator}}"
 
-    if [ -z "$record" ]; then continue; fi
+  if [ -z "$record" ]; then
-    writeLog process "Processing ${record}"
+    continue
+  fi
+  writeLog process "Processing ${record}"
 
-    # exit if curl/network error
+  # exit if curl/network error
-    if ! cfLookup="$(curl -s -X GET "https://api.cloudflare.com/client/v4/zones/${cfZoneId}/dns_records?name=${record}&type=${recordType}" \
+  if ! cfLookup="$(
-        -H "Authorization: Bearer ${cfKey}" \
+    curl -s -X GET "https://api.cloudflare.com/client/v4/zones/${cfZoneId}/dns_records?name=${record}&type=${recordType}" \
-        -H "Content-Type: application/json")"; then
+      -H "Authorization: Bearer ${cfKey}" \
-        writeLog process-error
+      -H "Content-Type: application/json"
-        exitError 3
+  )"; then
-    fi
+    writeLog process-error
+    exitError 3
+  fi
 
-    # exit if API error
+  # exit if API error
-    # exit here since API errors on GET request probably indicates authentication error which would affect all remaining operations
+  # exit here since API errors on GET request probably indicates authentication error which would affect all remaining operations
-    # no reason to continue processing other hosts and pile-up errors which might look like a DoS attempt
+  # no reason to continue processing other hosts and pile-up errors which might look like a DoS attempt
-    cfSuccess="$(printf "%s" "$cfLookup" | jq -r '.success')"
+  cfSuccess="$(printf "%s" "$cfLookup" | jq -r '.success')"
-    if [ "$cfSuccess" = "false" ]; then
+  if [ "$cfSuccess" = "false" ]; then
-        writeLog process-error
+    writeLog process-error
-        listCFErrors "$cfLookup"
+    listCFErrors "$cfLookup"
-        exitError 25
+    exitError 25
-    fi
+  fi
 
-    resultCount="$(printf "%s" "$cfLookup" | jq '.result_info.count')"
+  resultCount="$(printf "%s" "$cfLookup" | jq '.result_info.count')"
 
-    # skip to next host if cannot find existing host record (this script *updates* only, does not create!)
+  # skip to next host if cannot find existing host record (this script *updates* only, does not create!)
-    if [ "$resultCount" = "0" ]; then
+  if [ "$resultCount" = "0" ]; then
-        # warn if record of host not found
+    # warn if record of host not found
-        writeLog process-warning "NOT FOUND"
+    writeLog process-warning "NOT FOUND"
-        writeLog warn "Cannot find existing record to update for DNS entry: ${record}"
+    writeLog warn "Cannot find existing record to update for DNS entry: ${record}"
-        invalidDomainCount=$((invalidDomainCount + 1))
+    invalidDomainCount=$((invalidDomainCount + 1))
-        continue
+    continue
-    fi
+  fi
 
-    objectId=$(printf "%s" "$cfLookup" | jq -r '.result | .[] | .id')
+  objectId=$(printf "%s" "$cfLookup" | jq -r '.result | .[] | .id')
-    currentIpAddr=$(printf "%s" "$cfLookup" | jq -r '.result | .[] | .content')
+  currentIpAddr=$(printf "%s" "$cfLookup" | jq -r '.result | .[] | .content')
-    writeLog process-done "FOUND: IP = ${currentIpAddr}"
+  writeLog process-done "FOUND: IP = ${currentIpAddr}"
 
-    # skip to next hostname if record already up-to-date
+  # skip to next hostname if record already up-to-date
-    if [ "$currentIpAddr" = "$ipAddress" ]; then
+  if [ "$currentIpAddr" = "$ipAddress" ]; then
-        writeLog stamped "IP address for ${record} is already up-to-date"
+    writeLog stamped "IP address for ${record} is already up-to-date"
-        continue
+    continue
-    fi
+  fi
 
-    # update record
+  # update record
-    writeLog process "Updating IP address for ${record}"
+  writeLog process "Updating IP address for ${record}"
-    updateJSON="$(jq -n --arg key0 content --arg value0 "${ipAddress}" '{($key0):$value0}')"
+  updateJSON="$(jq -n --arg key0 content --arg value0 "${ipAddress}" '{($key0):$value0}')"
 
-    # exit if curl/network error
+  # exit if curl/network error
-    if ! cfResult="$(curl -s -X PATCH "https://api.cloudflare.com/client/v4/zones/${cfZoneId}/dns_records/${objectId}" \
+  if ! cfResult="$(
-        -H "Authorization: Bearer ${cfKey}" \
+    curl -s -X PATCH "https://api.cloudflare.com/client/v4/zones/${cfZoneId}/dns_records/${objectId}" \
-        -H "Content-Type: application/json" \
+      -H "Authorization: Bearer ${cfKey}" \
-        --data "${updateJSON}")"; then
+      -H "Content-Type: application/json" \
-        writeLog process-error
+      --data "${updateJSON}"
-        exitError 3
+  )"; then
-    fi
+    writeLog process-error
+    exitError 3
+  fi
 
-    # note update success or failure
+  # note update success or failure
-    cfSuccess="$(printf "%s" "$cfResult" | jq '.success')"
+  cfSuccess="$(printf "%s" "$cfResult" | jq '.success')"
-    if [ "$cfSuccess" = "true" ]; then
+  if [ "$cfSuccess" = "true" ]; then
-        writeLog process-done "DONE"
+    writeLog process-done "DONE"
-        writeLog success "IP address for ${record} updated."
+    writeLog success "IP address for ${record} updated."
-    else
+  else
-        writeLog process-error
+    writeLog process-error
-        listCFErrors "$cfResult"
+    listCFErrors "$cfResult"
-        writeLog err "Unable to update IP address for ${record}"
+    writeLog err "Unable to update IP address for ${record}"
-        # do not exit with error, API error here is probably an update issue specific to this host
+    # do not exit with error, API error here is probably an update issue specific to this host
-        # increment counter and note it after all processing finished
+    # increment counter and note it after all processing finished
-        failedHostCount=$((failedHostCount + 1))
+    failedHostCount=$((failedHostCount + 1))
-    fi
+  fi
 done
 
 # exit
 if [ "$invalidDomainCount" -ne 0 ]; then
-    writeLog warning "${invalidDomainCount} invalid host(s) supplied for updating."
+  writeLog warning "${invalidDomainCount} invalid host(s) supplied for updating."
 fi
 if [ "$failedHostCount" -ne 0 ]; then
-    exitError 26
+  exitError 26
 else
-    exitOK
+  exitOK
 fi
 
 ### exit return codes

logger.sh

@@ -0,0 +1,161 @@
+#!/bin/sh
+
+getTimeStamp() {
+  (date -u +"%Y-%m-%dT%H:%M:%SZ")
+}
+
+getHostname() {
+  (hostname -s)
+}
+
+lowercase() {
+  echo "$1" | tr '[:upper:]' '[:lower:]'
+}
+
+uppercase() {
+  echo "$1" | tr '[:lower:]' '[:upper:]'
+}
+
+standardizeLogLevels() {
+  LEVEL_TO_STANDARDIZE="$(lowercase "$1")"
+  case "$LEVEL_TO_STANDARDIZE" in
+  "critical" | "crit" | "fatal")
+    echo "CRIT"
+    ;;
+  "error" | "err")
+    echo "ERR"
+    ;;
+  "warning" | "warn")
+    echo "WARN"
+    ;;
+  "information" | "info")
+    echo "INFO"
+    ;;
+  "debug" | "verbose")
+    echo "DEBUG"
+    ;;
+  *)
+    echo "INFO"
+    ;;
+  esac
+}
+
+translateLogLevelsToJournalD() {
+  LEVEL_TO_TRANSLATE="$(standardizeLogLevels "$1")"
+  case "$LEVEL_TO_TRANSLATE" in
+  "CRIT")
+    echo 2
+    ;;
+  "ERR")
+    echo 3
+    ;;
+  "WARN")
+    echo 4
+    ;;
+  "INFO")
+    echo 6
+    ;;
+  "DEBUG")
+    echo 7
+    ;;
+  *)
+    echo 6
+  esac
+}
+
+# modified syslog fmt: <ISO-8601 timestamp> <hostname> <tag>[pid]: [LEVEL:$2] [STATUS:$3] <MESSAGE:$1> (<OPERATION:$4>:<CODE:$5>)
+writePlainTextLog() {
+  # not enough information to generate a meaningful log message
+  if [ -z "$1" ] || [ $# -lt 3 ]; then
+    return
+  fi
+
+  printf "%s %s %s[%s]: [%s] [%s] %s (%s:%s)\n" \
+    "$(getTimeStamp)" "$(getHostname)" "$LOG_PROGRAM_NAME" "$$" \
+    "$(standardizeLogLevels "$2")" "$(uppercase "$3")" "$1" "${4:-UNSPECIFIED}" "${5:-999}"
+}
+
+# $1: message, $2: level, $3: status, [$4: operation], [$5: code]
+writeJsonLog() {
+  # not enough information to generate a meaningful log message
+  if [ -z "$1" ] || [ $# -lt 3 ]; then
+    return
+  fi
+
+  PROPS="$(
+    jq --null-input \
+      --arg timestamp "$(getTimeStamp)" \
+      --arg hostname "$(getHostname)" \
+      --arg pName "$LOG_PROGRAM_NAME" \
+      --arg pid "$$" \
+      --arg level "$(standardizeLogLevels "$2")" \
+      --arg status "$(uppercase "$3")" \
+      --arg message "$1" \
+      --arg operation "${4:-UNSPECIFIED}" \
+      --arg code "${5:-999}" \
+      '{"timestamp":$timestamp, "hostname":$hostname, "programName":$pName, "pid":$pid, "level":$level, "status":$status, "message":$message, "operation":$operation, "code":$code}' \
+  )"
+
+  echo "$PROPS" | jq "."
+  return
+}
+
+# $1: message, $2: level, $3: status, $4: operation, $5: code
+writeJournalDLog() {
+  # not enough information to generate a meaningful log message
+  if [ -z "$1" ] || [ $# -lt 3 ]; then
+    return
+  fi
+
+  J_TIMESTAMP="$(getTimeStamp)"
+  J_PID="$$"
+  J_PRIO="$(translateLogLevelsToJournalD "$2")"
+  J_STAT="$(uppercase "$3")"
+
+  logger --journald <<end
+SYSLOG_TIMESTAMP=${J_TIMESTAMP}
+SYSLOG_FACILITY=3
+SYSLOG_IDENTIFIER=${LOG_PROGRAM_NAME}
+SYSLOG_PID=${J_PID}
+PRIORITY=${J_PRIO}
+STATUS=${J_STAT}
+MESSAGE=$1
+OPERATION=${4:-UNSPECIFIED}
+ERRNO=${5:-999}
+end
+
+  return
+}
+
+LOG_PROGRAM_NAME="cfddns"
+
+if [ "$1" = "text" ]; then
+  writePlainTextLog # this will do nothing
+  writePlainTextLog "Testing plain-text logging output" # this will also do nothing
+  writePlainTextLog "Informational plain-text log message" "information" "ok" # info message
+  writePlainTextLog "Plain-text message forced to info level" "whoops" "ok" # level translated to default
+  writePlainTextLog "Warning! This is plain-text." "warning" "flagged" # warning level with 'flagged' status
+  writePlainTextLog "Error sample! This is plain-text." "err" "error" # error level message
+  writePlainTextLog "Unable to continue, critical failure. (This is plain-text)" "fatal" "exit" "startup" "2" # critical level error with operation and error code
+elif [ "$1" = "json" ]; then
+  writeJsonLog # this will do nothing
+  writeJsonLog "This is a test message" # this will also do nothing
+  writeJsonLog "Informational JSON log message" "information" "ok" # info message
+  writeJsonLog "JSON message forced to info level" "whoops" "ok" # level translated to default
+  writeJsonLog "Warning! This is JSON." "warning" "flagged" # warning level with 'flagged' status
+  writeJsonLog "Error sample! This is JSON." "err" "error" # error level message
+  writeJsonLog "Unable to continue, critical failure. (This is JSON)" "fatal" "exit" "startup" "2" # critical level error with operation and error code
+elif [ "$1" = "journal" ]; then
+  writeJournalDLog # this will do nothing
+  writeJournalDLog "This is a test message" # this will also do nothing
+  writeJournalDLog "Informational JOURNALD log message" "information" "ok" # info message
+  writeJournalDLog "JOURNALD message forced to info level" "whoops" "ok" # level translated to default
+  writeJournalDLog "Warning! This is a JOURNALD message." "warning" "flagged" # warning level with 'flagged' status
+  writeJournalDLog "Error sample! This is a JOURNALD." "err" "error" # error level message
+  writeJournalDLog "Unable to continue, critical failure. (This is JOURNALD message)" "fatal" "exit" "startup" "2" # critical level error with operation and error code
+else
+  printf "\nPlease specify either 'text', 'json', or 'journal' after the script name. Exiting.\n\n"
+  exit 1
+fi
+
+exit 0