fix(bkgpslog):fix pid float calc

test(bkgpslog):more pid float testing

fix(bkgpslog):Fix float calc in buffer PID adjust

test(bkgpslog):More PID testing

test(bkgpslog):Fix debug msgs

test(bkgpslog):Test different PID calc

test(bkgpslog):debug:Shift magicBufferSleepPID

test(bkgpslog):Add debug code and negative int catch

test(bkgpslog):Debug testing PID loop

feat(bkgpslog):Add PID correction of buffer round timing

Add function to apply PID (proportional, integral, derivative)
adjustments to the sleep period between each buffer round in order to
compensate for lag caused by synchronous calculations between each
buffer round (including the PID adjustment calculation itself).

fix(bkgpslog):Remove nuisance error if -R not set

Error was appearing if -e were set but -R wasn't. -R is not a required
option.

fix(bkgpslog):Fix recPubKeysValid array bloat

Implemented recPubKeysValidStatic array for magicParseRecipientDir to
process instead of recPubKeysValid array.

fix(bkgpslog):Actually add recipient watch dir check

test(bkgpslog):Add verbose debug msg to recipient dir code

fix(bkgpslog):Fix error in encryption option handling, bump ver

Note: 0.4.0 version includes new '-b', '-B' options for specifying buffer and
script time-to-live values.

Note: 0.4.0 version includes new '-R' option for specifying directory
containing files specifying recipient pubkeys.

feat(bkgpslog):Enable custom TTL for buffer and script

New options: '-b' (buffer), '-B' (script).

Updated showUsage().

fix(bkgpslog):Fix broken tempdir var name

fix(bkgpslog):Add '-e'/'-R' checks in -R parse

Also add comments to magic functions in main()

fix(bkgpslog):Check -e, -r, -R option combinations; update usage

feat(bkgpslog):Add functions, group code into functions

Add several fucntions to add future new feature (recipient dir watch)
as well as to group existing code blocks into their own functions for
readability. Changes include:

* Add checkAgePubkey() function: checks that a provided string doesn't
throw an error when fed as a recipient string to `age`.

* Pushed several code blocks into their own "magic" functions
** magicParseRecipientDir() : (future feature): To be run at each
buffer session to update the recipient array in response to changes in
a specified recipient directory.
** magicParseRecipientArgs(): Parses strings provided by '-r'
option and format output accordingly. Existing code.
** magicParseCompressionArgs(): Responds to '-c' option by specifying
compression function and output file suffix.
* Update showUsage() to document future '-R' recipient dir option.

chore(bkgpslog):Bump version number to include recent change

feat(bkgpslog):Add additional validation for age pubkeys

fix(bkgpslog):Use eval to build command strings

Use eval to build command strings instead of simply putting bare
unquoted variable. This is necessary because the `recipients` variable
used to build a command to encrypt files may contain quotes if one of
the recipients is an ssh key which may have a space:

    ssh-rsa AAAAB...

This should fix the inability of `bkgpslog` to accept quoted ssh
pubkey strings as a specified `-r` option argument.

test(bkgpslog):Test recipient string quoting

recipient strings with spaces in them don't fare well with `\"` in
them when such strings are used to create new strings.

fix(bkgpslog):Fix pubkey strings with spaces

ssh pubkeys have a space in them and caused age encryption operation
to fail.

doc(bkgpslog):Add TODO for future features

- recipient watch folder

- simplify gps data

doc(bkgpslog-plan):Closed TODO item

style(bkgpslog):Minor semicolons

chore(bkgpslog):Minor comment cleanup

fix(bkgpslog):Simplify main loop further

Move `gpspipe` command itself into write function.

fix(bkgpslog):Add missing gpspipe option

Need `-o` to write to file.

fix(bkgpslog):Reduce logging downtime between buffer rounds

Reduce logging downtime between buffer rounds by moving commands into
the asynchronous `magicWriteBuffer()` function that is spun off
immediately after `gpspipe` has collected data.

Add functionality to `dateTimeShort()` and `dateShort` so the start
time of each saved chunk appended to the `tar` archive can be
calculated indirectly from when `magicWriteBuffer()` starts rather
than performing slow `date` and associated bash variable changes in
the main loop. This start time is needed to name each inserted file as
well as to identify which `tar` file to insert into.

Save gpspipe buffer data `/dev/shm` instead of a Bash variable.

Add `appendFileTar()` function to facilitate reading and processing of
buffer data from `/dev/shm`.

doc(bkgpslog):Add note to simplify main loop

fix(bkgpslog):Increase buffer period 60s to 5m to reduce write freq

fix(bkgpslog):Remove debug yells

style(bkgpslog):checkMakeTar():Add/remove debug code

test(bkgpslog):Bump version number to 0.3.0

Incompatible changes from 0.2:

- File writes asynchronous from main script forced to be sequential to
one another to avoid simultaneous writes to same file. Tar write code
consolidated.

- VERSION file format changed to include more fields. VERSION file
generation code cosolidated.

fix(bkgpslog):Clarify echoed newlines per Shellcheck

Changed echo "blah""\n""blah" into echo "blah""\\n""blah"

style(bkgpslog):Update timeDuration

feat(bkgpslog):Include more fields in VERSION

These fields are included to automatically-generated VERSION file
included when a new tar is generated or the script is restarted:

- SCRIPT_VERSION  : Version of bkgpslog being run.
- SCRIPT_NAME     : Name of the script being run ("bkgpslog").
- SCRIPT_URL      : URL where script can be downloaded.
- AGE_VERSION     : Version of age (encryption program) used.
- AGE_URL         : URL where age can be downloaded.
- DATE            : Creation timestamp (ISO-8601).
- HOSTNAME        : Hostname of device running script.
- PUBKEY_[n]      : Pubkey string used by age to encrypt.

chore(bkgpslog):bump to version 0.2.1 from 0.2.0

feat(bkgpslog):Change format in VERSION file

From one line to multiline

doc(bkgpslog):Update plan doc

feat(bkgpslog): Consolidate VERSION writing, update functions

Bump version to 0.2.0 from 0.1.0.

style(timeUntilNextDay()). Set as version 1.0.0. Lowercased
returnState variable messages in function return code handling.

fix(timeDuration()). Fix missing $ in bash variable. Set to Version
1.0.0. Removed unused boolean variables.

feat(magicWriteVersion()): Add function to consolidate how VERSION
file is generated; VERSION file can be generated at start or if output
tar goes missing.

feat(magicWriteBuffer()): Take checkMakeTar() exit status into account
in order to determine whether or not to rerun
magicWriteVersion(). Relevant if output tar archive goes missing.

feat(bkgpslog):Include exit codes in checkMakeTar

The change is necessary to decide if VERSION file must be added in
case output tar is deleted between writes.

feat(bkgpslog):Consolidate tar validation/creation

Consolidate how output tar file is validated (if it already exists)
and/or created. checkMakeTar() function added for this purpose.

Add checkMakeTar() in `magicWriteBuffer()` in case output tar file is
deleted between writes.

feat(bkgpslog):Force ordered write operations with wait

Use `wait` built-in to force each detached process that appends
location data to the output tar to wait until all other detached
processes complete. This will prevent the magicWriteBuffer() and
appendArgTar() functions from attempting to append to the same tar at
the same time, causing script failure.

debug(bkgpslog):Minor syntax formatting: add semicolons

fix(bkgpslog):Fix command strings in magicWriteBuffer

fix(bkgpslog):Move chunk cleanup into magicWriteBuffer func

fix(bkgpslog):Disable old tar append code

debug(bkgpslog):Add debug messages for functions

fix(bkgpslog):Arg index error in appendArgTar()

debug(bkgpslog):Add more debug data

feat(bkgpslog):Consolidate write ops into one function

Create metafunction 'magicWriteBuffer' to be triggered for
asynchronous appending of location files into tar file via
appendArgTar function (new) once buffer filled in main logging loop.

Create appendArgTar function to append a bash variable as a file to a
tar file.

debug(bkgpslog):testing debug of gpx kml output

fix(bkgpslog):Fix output files having the same names

feat(bkgpslog):Added debug message when main function completes

fix(bkgpslog):Clean up how tar appended, version file included

chore(bkgpslog):Add timestamp to version content.

chore(bkgpslog):Include version in appendtest

debug(bkgpslog):Clarified debug messages

fix(bkgpslog):Fix secure chunk cleanup code

debug(bkgpslog):Add more debug messages; clarified tar workdir

debug(bkgpslog):Add more verbose debug messages

debug(bkgpslog):Add more verbose debug code

debug(bkgpslog):Add additional debug for output file path vars

fix(bkgpslog):Minor formatting

feat(bkgpslog):Append to preexisting tar if possible

fix(bkgpslog):Add missing shifts in processArguments()

feat(bkgpslog):Add more verbose error message in processArguments()

fix(bkgpslog):Fix incorrectly selected argument

doc(bkgpslog): Update usage

feat(bkgpslog): Remove termproary working dir at end

- Remove temporary working directory at end of main function.

- Initialize option variables in case they are set earlier.

- Add `--temp-dir` option to permit user to specify temporary working
directory.

fix(bkgpslog): Fix broken working dir name

- Fix broken working dir variable (was missing script start time)

- Remove UTC as default TZ (will use parent shell's env var TZ). Can
  still be customized using `--time-zone` option

- Add logic for creating temporary working directory for possible
future `--temp-dir` option. Working dir hard defaults to
`/dev/shm` (tmpfs) for now.

feat(bkgpslog): Append to daily tar

* Set version to 0.1.0.

* Rewrote write loop to append location data to tar file instead of
writing each file written by each buffer round directly to
disk. Tar contains individually encrypted and compressed files; no
attempt at merging location data between buffer rounds was attempted.

* Add functions:

- setTimeZoneEV (exports TZ)
- dateShort (returns current date in `YYYYmmdd` format via stdout)
- timeDuration (given seconds, returns ISO-8601 period; Ex: PT60S)
- displayMissing (displays missing apps, files, and dirs)
- setScriptTTL (sets script TTL given "day" or "hour")

* Set default script TTL to "day" (was "hour")

* Set default TZ to UTC. Added option `--time-zone`.

doc(loc/README): Show how to disable swap file

Disabling swap file is important for reducing probability that
unencrypted data is written to disk.

doc(location):Describe how to disable swap file

doc(location):Add html version of location README

doc(location): Updated README for loc, exported ODT version

feat(bkgpslog):Add ~/.local/bin to PATH

If apps for bkgpslog stored in `~/.local/bin`, make sure to add it to
front of PATH.

doc(location):Update README with compress and encrypt example

fix(bkgpslog):Add quotation marks for output path vars

May be necessary if path specified by `--output` option contains
whitespace.

test(bkgpslog): Test 'tee /dev/null' as passthrough-function

test(bkgpslog):Group all processing and save commands

fix(bkgpslog):Add missing dollarsign to vars

test(bkgpslog): Regroup file write commands

test(bkgpslog):Construct command string as var before executing

fix(bkgpslog):Fix file write command

Removed quotation marks so command chars taken literally, not treated
as a word.

fix(bkgpslog):Add missing fi

feat(bkgpslog):Implement compression and encryption

Add compression option.

Implement compression of output files.

Implement encryption of output files.

test(bkgpslog):Add age recipient string processing code

feat(bkgpslog):Add encryption option

Add encryption option via `age`. See:
https://github.com/FiloSottile/age .

Add `-e, --encrypt` option for specifying output to be encrypted.

Add `-r --recipient [ pubkey string ]` option for specifying
recipients of encrypted output.

Add code to validate recipient pubkey strings.

Not added (yet): encryption of output files.

doc(README.org):Update main README

All major sections populated. `age` use described.

fix(bkgpslog):processArguments: Shorten short option strings

doc(location):Add README for location logging, add age ref files

Create draft of README for Location Logging operations performed by
ninfacyzga-01.

Add copy of age encryption software (v1.0.0-beta2 binaries compatible
with Raspbian) and age version 1 specification.

feat(archive):Add baltakatei OpenPGP public key

Fingerprint:

pub   rsa4096/0xA0A295ABDC3469C9 2017-10-11 [C] [expires: 2022-07-08]
      Key fingerprint = 3457 A265 922A 1F38 39DB  0264 A0A2 95AB DC34 69C9
uid                   [ultimate] Steven Sandoval <baltakatei@gmail.com>
uid                   [ultimate] Steven Sandoval <baltakatei@alumni.stanford.edu>
uid                   [ultimate] [jpeg image of size 1846]
sub   rsa4096/0x6DD7D496916A1253 2018-05-16 [E] [expires: 2022-07-07]
      Key fingerprint = 5E55 5FC6 1C85 871E 813B  5BCF 6DD7 D496 916A 1253
sub   rsa4096/0x57DA57D9517E6F86 2018-05-16 [S] [expires: 2022-07-07]
      Key fingerprint = 38F9 6437 C83A C88E 28B7  A952 57DA 57D9 517E 6F86
sub   rsa4096/0x5F9D26B9A598A2D3 2018-05-16 [A] [expires: 2022-07-07]
      Key fingerprint = EDCA 7EE7 D09E 7F2E 1DF6  A229 5F9D 26B9 A598 A2D3

fix(bkgpslog):Comment out debug code causing /var/mail/ noise

feat(bkgpslog):Enable hour TTL, cleanup functions

Enable a new feature that breaks the while loop at the top of the next
hour.

Include commented-out code to break while loop at the top of the next
day.

Set buffer round time to 60 seconds (nominal time between writing of
buffer data to a new file on disk).

chore(bkgpslog):Remove unsetting of superfluous vars

Variables were removed in streamlining of buffer processing.