]> Kevux Git Server - fll/log
fll
2 years agoUpdate: The example bzip2 now supports running the tests.
Kevin Day [Sun, 31 Jul 2022 20:12:00 +0000 (15:12 -0500)]
Update: The example bzip2 now supports running the tests.

Also update the documentation because step 5 is out of date.

2 years agoCleanup: Simplify the bzip2 example fakefile ever so slightly.
Kevin Day [Sun, 31 Jul 2022 19:49:39 +0000 (14:49 -0500)]
Cleanup: Simplify the bzip2 example fakefile ever so slightly.

2 years agoCleanup: Add missing return statements and remove unused variables.
Kevin Day [Sun, 31 Jul 2022 04:20:04 +0000 (23:20 -0500)]
Cleanup: Add missing return statements and remove unused variables.

2 years agoBugfix: Tests for f_color are failing due to missing source file.
Kevin Day [Sun, 31 Jul 2022 01:33:06 +0000 (20:33 -0500)]
Bugfix: Tests for f_color are failing due to missing source file.

The commit 46fcfb4b6fd4e39c0ba1f96df383db82e36af2a1 failed to also add the new source file to the unit test settings file.

2 years agoUpdate: Specifications and documentation, fixing mistakes and adding IKI support.
Kevin Day [Sat, 30 Jul 2022 22:37:19 +0000 (17:37 -0500)]
Update: Specifications and documentation, fixing mistakes and adding IKI support.

Fix discovered mistakes.
Utilize IKI variables for the fake specifications and documentation just like is done with the FLL specifications.

2 years agoUpdate: The f_color needs to follow latest practices with private functions.
Kevin Day [Sat, 30 Jul 2022 14:45:48 +0000 (09:45 -0500)]
Update: The f_color needs to follow latest practices with private functions.

The f_color project is now updated to use private functions.

Change the behavior of the color parameters to only append if the previous is provided.
This includes the relevant color medium.

Update the documentation comments to display the correct function dependencies and error return states.

2 years agoAdd documentation about disabling functions.
Kevin Day [Sat, 30 Jul 2022 00:55:55 +0000 (19:55 -0500)]
Add documentation about disabling functions.

2 years agoBugfix: private_f_file_open_at() has an incomplete set if ifdef conditions.
Kevin Day [Sat, 30 Jul 2022 00:22:10 +0000 (19:22 -0500)]
Bugfix: private_f_file_open_at() has an incomplete set if ifdef conditions.

The ifdef conditions for disabled functions is incomplete.
This results in the private_f_file_open_at() becoming incorrectly unavailable when the appropriate disable defines are set.

2 years agoCleanup: Spelling mistakes, styling mistakes, and improve documentation about Time.
Kevin Day [Fri, 29 Jul 2022 04:17:42 +0000 (23:17 -0500)]
Cleanup: Spelling mistakes, styling mistakes, and improve documentation about Time.

The documentation about Time vs Epoch time is a bit confusing.
Changes the sentences with the goal of improving the documentation.

I may also end up moving the Time documentation to the FLL core documentation rather than have it be part of Controller.

2 years agoCleanup: Fix problems in the specification files.
Kevin Day [Thu, 28 Jul 2022 00:37:29 +0000 (19:37 -0500)]
Cleanup: Fix problems in the specification files.

Add missing delimits.
Fix capitalization of words.
Fix spacing.
Remove out of place text.

2 years agoUpdate: Improve specification files.
Kevin Day [Thu, 28 Jul 2022 00:36:31 +0000 (19:36 -0500)]
Update: Improve specification files.

Expand the vocabulary to include more words such as "character".
This allows for more granular control over substitution.
This is a must to easily convert to both plain text and HTML from the same source file.

2 years agoUpdate: Clarify IKI standard in regards to delimits and improve specification file.
Kevin Day [Thu, 28 Jul 2022 00:09:16 +0000 (19:09 -0500)]
Update: Clarify IKI standard in regards to delimits and improve specification file.

Add additional commands to the specification iki_read example.
Expand the vocabulary to include more words such as "character".
This allows for more granular control over substitution.
This is a must to easily convert to both plain text and HTML from the same source file.

Fix incorrect example where the delimits are on the wrong characters (url:\' is not correct and instead should be url\;').
Add delimits to accidentally undelimited code.

These changes exposed a mistake in both the processing code and a detail on how I explained the specification.
The IKI processing only needs a delimit when the vocabulary name followed by a colon followed by either a single or a double quote.
That is to say, the matching closing single or double quote is irrelevant.
This simplifies the logic needed to both read and write the IKI content for both machines and humans.
Note that this is in contrast to how the FSS works.
IKI is designed for different purposes than FSS and thus has slightly different design paradigms.

The code processing this is incorrectly failing to apply delimits for any potentially valid IKI content inside an already valid but delimited IKI variable.
Fixing this conveniently also results in simpler code and fewer variables used (saving trivial memory).

2 years agoCleanup: Capitalization of wods and improve grammar in documentation.
Kevin Day [Mon, 25 Jul 2022 02:59:52 +0000 (21:59 -0500)]
Cleanup: Capitalization of wods and improve grammar in documentation.

2 years agoUpdate: Add +E/++error parameter to firewall.
Kevin Day [Sun, 24 Jul 2022 03:26:25 +0000 (22:26 -0500)]
Update: Add +E/++error parameter to firewall.

The previous security commit 7348813d0af17acda440eb66c038f6bdd07c1a6e is the result of an incomplete addition of the +E/++error parameter.
The size of the total parameters was incremented to ensure space for the +E/++error but the +E/++error was never added.

This increments the total parameters and adds the +E/++error row.

2 years agoSecurity: Invalid read in firewall program during resource clean up.
Kevin Day [Sun, 24 Jul 2022 03:22:38 +0000 (22:22 -0500)]
Security: Invalid read in firewall program during resource clean up.

The total parameters define has the wrong size resulting in an invalid read.

2 years agoCleanup: Use hard coded example in help.
Kevin Day [Sun, 24 Jul 2022 03:06:47 +0000 (22:06 -0500)]
Cleanup: Use hard coded example in help.

The example is under certain circumstances ending up as an empty string.
This results in a confusing example.

Switch to hard coded example rather than trying to use some dynamic variable.

2 years agoBugfix: Link operation is incorrect, support new link arguments, and clone and copy...
Kevin Day [Sat, 23 Jul 2022 22:41:30 +0000 (17:41 -0500)]
Bugfix: Link operation is incorrect, support new link arguments, and clone and copy operation failure problems.

The link operation target path is relative to the point path.
The previous code is trying to treat the target path in isolation.
Change the behavior to make the target path relative to the point path.

Add two new options to make creating symbolic linking easier to use:
1) "force": Used to forcibly overwrite an existing file or directory.
2) "strict": Used to require the target path to exist when creating the symbolic links.

The clone and copy operations now have better error return code processing.

2 years agoCleanup: Relocate all operation process type operations into functions.
Kevin Day [Sat, 23 Jul 2022 19:31:09 +0000 (14:31 -0500)]
Cleanup: Relocate all operation process type operations into functions.

Just like with commit 452b0189a610418420119a71907e7b9276ed5c28 do some re-organization.

The operate process type operations are not all in their own functions.
Change the code to move all of the operate process type operations into their own functions.

2 years agoUpdate: Organize the validate operation into separate type functions and improve...
Kevin Day [Sat, 23 Jul 2022 15:55:55 +0000 (10:55 -0500)]
Update: Organize the validate operation into separate type functions and improve error handling logic.

Move the contents of each validate operation if condition block into separate functions.
This makes the validate operation code more consistent with how the process operation code.
This simplifies some of the nesting.
This has a cost of adding and calling more functions.

Multi-purpose functions are used where applicable rather than having a single function for each operation type.

The error handling is improved in some cases where errors are printed for all arguments rather than the first.
This is done only in cases where I could obviously and quickly determine that this can be done.

There is the possibility of mistakes or regressions due to the structural changes and the condition block changes.

2 years agoUpdate: Call fake_make_operate_process_type_link().
Kevin Day [Sat, 23 Jul 2022 15:54:46 +0000 (10:54 -0500)]
Update: Call fake_make_operate_process_type_link().

This change was accidentally ommitted in the previous commit 854d08a0841b83e2010fed454c4f960c180ab5f3.

2 years agoCleanup: Move the link operation into its own function fake_make_operate_process_type...
Kevin Day [Sat, 23 Jul 2022 03:40:28 +0000 (22:40 -0500)]
Cleanup: Move the link operation into its own function fake_make_operate_process_type_link().

2 years agoCleanup: Update documentation comments to reference the current error return codes.
Kevin Day [Sat, 23 Jul 2022 03:11:57 +0000 (22:11 -0500)]
Cleanup: Update documentation comments to reference the current error return codes.

2 years agoCleanup: Style practices.
Kevin Day [Fri, 22 Jul 2022 03:56:11 +0000 (22:56 -0500)]
Cleanup: Style practices.

2 years agoBugfix: Apply recent bug fixes for the copy/clone operation to the move operation.
Kevin Day [Fri, 22 Jul 2022 03:53:48 +0000 (22:53 -0500)]
Bugfix: Apply recent bug fixes for the copy/clone operation to the move operation.

The move operation is very similar to the copy and clone operations.

Apply the fixes from these commits:
e70631a5463f7dcb7ad70a0f92040c2d59ad947a
f57654c80ecb53fd40bf2b2e18d41197718bbaa7

The commit e70631a5463f7dcb7ad70a0f92040c2d59ad947a also went a bit over kill and added unecessary trailing slashes.
I only tested directoreis at the time and it was not a problem.
This broke for non-directory file types.

2 years agoCleanup: Consistently return status codes on failure.
Kevin Day [Fri, 22 Jul 2022 03:13:43 +0000 (22:13 -0500)]
Cleanup: Consistently return status codes on failure.

Sometimes status is returned.
Other times F_status_set_error(F_failure) is returned.

Follow the second case.

2 years agoBugfix: Copy should destination should be the base name rather than the entire path.
Kevin Day [Fri, 22 Jul 2022 01:30:46 +0000 (20:30 -0500)]
Bugfix: Copy should destination should be the base name rather than the entire path.

The entire path is being appended to the destination when performing a clone or a copy operation.
Example:
  copy a/b/c.txt destination/

This should copy c.txt as "destination/c.txt".
What instead happens is this: "destination/a/b/c.txt".

Change the code to now detect the file base name and append the base name rather than append the entire path.

2 years agoUpdate: Improve user experience by defaulting specified fakefile and build settings...
Kevin Day [Fri, 22 Jul 2022 00:02:59 +0000 (19:02 -0500)]
Update: Improve user experience by defaulting specified fakefile and build settings file to present working directory.

Change the behavior to search the present working directory first.
If the file exists, then use it.
If not, then check the data/build/ directory.

This is done only for fakefile and build settings file that are not specified using a directory separator.

2 years agoSecurity: Invalid read when processing an empty fakefile.
Kevin Day [Fri, 22 Jul 2022 00:01:21 +0000 (19:01 -0500)]
Security: Invalid read when processing an empty fakefile.

The check should be a greater than or equal to rather than a greater than.

The code really shouldn't get here anyway.
Do not continue processing if fakefile is empty.

2 years agoUpdate: Timeout changes and documentation updates.
Kevin Day [Thu, 21 Jul 2022 22:44:14 +0000 (17:44 -0500)]
Update: Timeout changes and documentation updates.

I seem to have forgotten to complete this functionality.
I believe it is too much work to do and this will not make the stable release.
Update the documentation to reflect this.

Add a new timeout option called "exit".
This allows for handling the timeout when exiting the program.
This is implemented and in use.
The implementation is dirt simple and sub-optimal but allows for the functionality to be quickly implemented.

The important addition here is the ability to disable the respective timeouts.
No child processes are killed when the exit timeout is disabled.
This can result in the program stalling for a long time or indefinitely.

A new flag property is added to controller_entry_t and controller_entry_action_t.

2 years agoUpdate: The standard program setup should explicitly unblock all signals other than...
Kevin Day [Thu, 21 Jul 2022 01:40:14 +0000 (20:40 -0500)]
Update: The standard program setup should explicitly unblock all signals other than the default.

The fll_program_standard_setup() function blocks certain signals.
Do not assume all other signals are unblocked.
Explicitly unblock all other signals.

2 years agoBugfix: Parameter after either the -N or -W is being processed.
Kevin Day [Wed, 20 Jul 2022 22:17:05 +0000 (17:17 -0500)]
Bugfix: Parameter after either the -N or -W is being processed.

These should not expect an argument and are configured to do so.
Set the expected arguments to 0.

The command:
  byte_dump /bin/bash -N --help

Should now print help.

2 years agoFeature: Add missing signal functions f_signal_action(), f_signal_pause(), and f_sign...
Kevin Day [Wed, 20 Jul 2022 03:19:51 +0000 (22:19 -0500)]
Feature: Add missing signal functions f_signal_action(), f_signal_pause(), and f_signal_suspend().

The f_signal_pause() just calls pause() and returns F_none.
The return value of pause() is meaningless if I am understanding the man pages correctly.
It should always return -1 and then sets errno despite this not being an actual error.

2 years agoRegression: Incomplete IKI variable expansion when an extra ':' is found.
Kevin Day [Wed, 20 Jul 2022 02:49:35 +0000 (21:49 -0500)]
Regression: Incomplete IKI variable expansion when an extra ':' is found.

The commit feb9184911c738b66c4181f58527cbfd94cdb25c introduced the use of F_next to restart the outer most loop.

I missed a single case where status should be set to F_next.
The problematic code is setting the status to F_false.

2 years agoSecurity: Invalid read when processing not condition minimum value.
Kevin Day [Wed, 20 Jul 2022 02:16:47 +0000 (21:16 -0500)]
Security: Invalid read when processing not condition minimum value.

The right side of the or condition should only perform the minimum check when j is within the range of the array.

2 years agoRegression: Pre-allocate is using the wrong array.
Kevin Day [Wed, 20 Jul 2022 02:04:50 +0000 (21:04 -0500)]
Regression: Pre-allocate is using the wrong array.

I mixed up the arrays, the code managed to compile, and the error went unnoticed.

The problem is introduced by this commit: 99e025d4b5b1110733e4049416d848f8bc632fb3.

2 years agoCleanup: Remove bad path part from string in testfiles.
Kevin Day [Wed, 20 Jul 2022 01:47:01 +0000 (20:47 -0500)]
Cleanup: Remove bad path part from string in testfiles.

The 'parameter:' is not valid and does nothing here.
This is likely the result of a copy and paste that didn't fully delete the parameter IKI variable.

2 years agoBugfix: Guarantee that the child processes are terminated.
Kevin Day [Tue, 19 Jul 2022 03:35:29 +0000 (22:35 -0500)]
Bugfix: Guarantee that the child processes are terminated.

The terminate signal is not being received for unknown reasons.
The signals are unblocked for the child process.
And yet, it continues to block.

The final part of the terminate due to signal is to forcibly terminate (sending the kill signal).
This is now happening for child processes.

Sending the kill signal allieviates the problem where the controller program will not terminate.
This fix causes the reduces the severity of the problem such that the terminate should still terminate.
However, this fix does not solve the problem with the terminate signal not being received by a child process that is not blocking the signal as far as I can tell.

2 years agoBugfix: The copy operation doesn't work properly with trailing slashes.
Kevin Day [Mon, 18 Jul 2022 03:36:55 +0000 (22:36 -0500)]
Bugfix: The copy operation doesn't work properly with trailing slashes.

The generated path might not be valid when a trailing slash is supplied on the source or the destination.
Increase the static array size to accommodate at least 2 added separators.
Only add the separators if one does not already exist.

This does not attempt to clean up the code if there are multiple separators beyond the first.
(That is to say "copy a/// b///" will not become "copy a/ b/".)

2 years agoCleanup: Tweak the delimits behavior to re-use the existing array to reduce memory...
Kevin Day [Mon, 18 Jul 2022 01:36:45 +0000 (20:36 -0500)]
Cleanup: Tweak the delimits behavior to re-use the existing array to reduce memory overhead.

2 years agoBugfix: IKI substitution is incorrectly applied.
Kevin Day [Mon, 18 Jul 2022 01:26:23 +0000 (20:26 -0500)]
Bugfix: IKI substitution is incorrectly applied.

The function controller_rule_action_read_delimit_apply() is remapping the array and applies the delimits.
Another function is then applying the same delimits again, but against the remapped buffer.
This results in the delimits being applied to the wrong locations in the string.

Get rid of the controller_rule_action_read_delimit_apply().
The use of this function results in an incorrect string when printing validation.

Thoroughly clear the entire IKI data when processing the actions.

2 years agoSecurity: Invalid reads on NULL terminated strings with a max width greater than 1.
Kevin Day [Sun, 17 Jul 2022 23:42:21 +0000 (18:42 -0500)]
Security: Invalid reads on NULL terminated strings with a max width greater than 1.

The max width cannot be reliably trusted in NULL terminated strings.
Check if each character in the expected max width is not terminated early due to a NULL.
If it is, then adjust the max width.

2 years agoFeature: The fake program should support the "current" parameter.
Kevin Day [Sun, 17 Jul 2022 21:35:09 +0000 (16:35 -0500)]
Feature: The fake program should support the "current" parameter.

This is the compliment to the "top" variable parameter.

The current working directory, also known as the present working directory, should be an IKI variable.

Use the f_string_dynamic_append_assure() rather than f_string_dynamic_append() to only add the trailing slash if it is not already present.

Update the documentation.

2 years agoBugfix: Text is being incorrectly stripped out.
Kevin Day [Sun, 17 Jul 2022 21:19:03 +0000 (16:19 -0500)]
Bugfix: Text is being incorrectly stripped out.

Remove old code that is reset the used buffer when it should not be.

2 years agoUpdate: Reduce number of allocations by pre-determining size when easily possible.
Kevin Day [Sun, 17 Jul 2022 20:49:48 +0000 (15:49 -0500)]
Update: Reduce number of allocations by pre-determining size when easily possible.

There are several cases where the expected size can be calculated.
Pre-allocated the expected size to reduce reallocation and improve performance by reducing memory overhead.

I also noticed that the comment is no longer correct and that the not quoted check could be reversed.
Changing this simplified the code, slightly.

2 years agoBugfix: Reserved parameter IKI expansion is not adding spaces and the "top" reserved...
Kevin Day [Sun, 17 Jul 2022 20:34:16 +0000 (15:34 -0500)]
Bugfix: Reserved parameter IKI expansion is not adding spaces and the "top" reserved parameter should always end in a slash.

The IKI expansion on reserved parameters, such as "parameter:"fakefile"", should include spaces as appropriate.
For example, given a call to "fake -f my_fakefile", the parameter:"fakefile" should expand into "-f my_fakefile" but is instead expanding into "-fmy_fakefile".

For security reasons, the expanded paths, such as parameter:"top", should always have a trailing slash.
Consider "rm -Rf parameter:"top"tmp" vs "rm -Rf parameter:"top"/tmp".
On the left side, if parameter:"top" resolves into an empty string, then the command is: "rm -Rf tmp".
On the right side, if parameter:"top" resolves into an empty string, then the command is: "rm -Rf /tmp".
The right side would end up destroying a path outside of the project root, such as "/tmp"!

2 years agoFeature: The fake program should support the "top" parameter.
Kevin Day [Sun, 17 Jul 2022 15:28:46 +0000 (10:28 -0500)]
Feature: The fake program should support the "top" parameter.

The "top" is already available but it is not exposed through IKI variable parameter replacement.

Update the documentation, including adding missing documentation about "return".

Remove unused "return:option" and "return:value" parameter (this is not used because it is not valid).

2 years agoBugfix: IKI variable substitution results in incorrect parameter structure for reserv...
Kevin Day [Sun, 17 Jul 2022 14:35:06 +0000 (09:35 -0500)]
Bugfix: IKI variable substitution results in incorrect parameter structure for reserved parameters.

The commit 9ebfcc071f11f82b435cfa0f73e4961912571c38 didn't address this case.

There is an existing "separate = F_true;" that suggest that I was planning on working on this.
I probably overlooked and forgot about this block.

Do not increment the parameters array and instead prepend a single space only when needed.

2 years agoRegression: An if-condition followed by a completed if-condition is not being processed.
Kevin Day [Sun, 17 Jul 2022 14:07:56 +0000 (09:07 -0500)]
Regression: An if-condition followed by a completed if-condition is not being processed.

The commit 4ddc0910eb872bf242895e1e5e804f50f671901d did not address this use case.

Example:
  if == x x
    print x is x
  if == y y
    print y is y

2 years agoCleanup: Documentation in regards to the newly added +E/++Error and the changes from...
Kevin Day [Sun, 17 Jul 2022 03:36:45 +0000 (22:36 -0500)]
Cleanup: Documentation in regards to the newly added +E/++Error and the changes from +q to +Q.

2 years agoUpdate: Add support for +E/++error, change '+q' to '+Q', and fix some past tense...
Kevin Day [Sun, 17 Jul 2022 03:09:09 +0000 (22:09 -0500)]
Update: Add support for +E/++error, change '+q' to '+Q', and fix some past tense words.

Selecting a quiet mode that still prints errors is very helpful in embedded fakefiles inside of controller rules.

I noticed that almost all of the verbosity related parameters are upper case except for the "quiet" parameter.
Change the "quiet" parameter from "+q" to "+Q".

I noticed some words in the past tense.
The goal is to use present tense.
Using past tense a habit I hope to get out of when programming.

2 years agoBugfix: Error verbosity is not being preserved.
Kevin Day [Sun, 17 Jul 2022 01:25:57 +0000 (20:25 -0500)]
Bugfix: Error verbosity is not being preserved.

2 years agoUpdate: Testfiles now need to use the "exist" rather than "exists".
Kevin Day [Sun, 17 Jul 2022 01:09:53 +0000 (20:09 -0500)]
Update: Testfiles now need to use the "exist" rather than "exists".

2 years agoBugfix: IKI variable substitutionr results in incorrect parameter structure.
Kevin Day [Sun, 17 Jul 2022 01:00:35 +0000 (20:00 -0500)]
Bugfix: IKI variable substitutionr results in incorrect parameter structure.

The commit d94d5337c44d7b2d6f3ed183e8d2c94b4bdad1f6 exposed an existing bug.

There parameters are not always expanding properly resulting in the parameter being empty, having the incorrect order, or being improperly merged with another parameter.
Change the array resize behavior to resize after incrementing the arguments rather than before.
Detect and handle special cases where separation needs to be applied and when separation does not need to be applied.
Remove random space that is being accidentally appended when printing arguments (probably an accident from a previous commit).

The commit 6012208c61e616a5d31d285ba8873f55b987bf70 did not fully solve the problems it attempted to solve.
Handle additional cases, such as:

  settings:
    parameter a iki <-assure_space unassure_space->
    parameter b value

  main:

    if exist 'parameter:"a"'
      print yes (parameter:"a")
    else
      print no (parameter:"a")

    print 0 parameter:"a"
    print 1 parameter:"b"
    print 2 parameter:"b".
    print 3 "parameter:"b""
    print 4 "parameter:"b\" between parameter:"b""
    print 5 'begin parameter:"a" middle parameter:"a" end'
    print 6 "begin parameter:"a\" middle parameter:"a\" end"
    print 7 begin parameter:"a" middle parameter:"a" end
    print 8 begin parameter:"a"! middle parameter:"a"@parameter:"a" end

Should produce results like:
  no (iki <-assure_space unassure_space->)
  0 iki <-assure_space unassure_space->
  1 value
  2 value.
  3 value
  4 value between value
  5 begin iki <-assure_space unassure_space-> middle iki <-assure_space unassure_space-> end
  6 begin iki <-assure_space unassure_space-> middle iki <-assure_space unassure_space-> end
  7 begin iki <-assure_space unassure_space-> middle iki <-assure_space unassure_space-> end
  8 begin iki <-assure_space unassure_space->! middle iki <-assure_space unassure_space->@iki <-assure_space unassure_space-> end

Move the relevant arguments and iki data into a shared cache to save memory consumption.
Rename path_cache to cache_path for consistency.

2 years agoBugfix: Single quotes are not being properly detected in FSS Extended Read functions.
Kevin Day [Fri, 15 Jul 2022 04:27:43 +0000 (23:27 -0500)]
Bugfix: Single quotes are not being properly detected in FSS Extended Read functions.

A copy and paste mistake where f_fss_quote_type_double_e when instead f_fss_quote_type_single_e should be used resulted in the quote being set to NULL.

Also do some code clean up.

2 years agoUpdate: Change "exists" to "exist" in fakefile syntax.
Kevin Day [Thu, 14 Jul 2022 02:05:08 +0000 (21:05 -0500)]
Update: Change "exists" to "exist" in fakefile syntax.

The use of "exists" is grammatically correct and the use of "exist" is grammatically incorrect.
This is not in English grammar.
The practices of this project are to focus on using "s" strictly for plural.
The practices of this project are to use simple or base words more often.

The area in which proper grammar is allowed is when interacting with the user rather than with code.
A project like Fake has a target user who is a programmer.
This is a grey area.

The project is already using "if define" rather than "if defined".
For the purpose of keeping a consistent design, I am favoring "exist" over "exists" for this grey area.
Another bonus is that "exist" is shorter than "exists" (however trivial).

2 years agoUpdate: Strip out NULL characters after applying delimits.
Kevin Day [Wed, 13 Jul 2022 23:19:21 +0000 (18:19 -0500)]
Update: Strip out NULL characters after applying delimits.

Once a rule is read and the IKI data is parsed, apply the IKI delimits.
NULL characters replace the delimits.
Strip out all NULL characters from the string after the delimits are applied.

2 years agoUpdate: Replace Unicode Terminate escape sequence with Non-printing escape sequence.
Kevin Day [Wed, 13 Jul 2022 12:07:45 +0000 (07:07 -0500)]
Update: Replace Unicode Terminate escape sequence with Non-printing escape sequence.

Use "\!" instead of "\U-".
It is simpler and has the convenience of not being part of an IKI variable.

Update the alphabetic ordering.

The documentation is missing context IKI variable.
Describe all supported context IKI variables.

2 years agoBugfix: Delimits are not being applied for IKI variables.
Kevin Day [Wed, 13 Jul 2022 12:05:32 +0000 (07:05 -0500)]
Bugfix: Delimits are not being applied for IKI variables.

The controller program is not applying the delimits for would-be-valid IKI variables.
This becomes a huge problem when these would-be-valid IKI variables are passed to the fake program.
If the would-be-valid IKI variables are properly delimited, then the fake program would see them as valid IKI variables.

2 years agoBugfix: IKI variables are incorrectly being processed when there is a non-IKI IKI...
Kevin Day [Wed, 13 Jul 2022 12:01:39 +0000 (07:01 -0500)]
Bugfix: IKI variables are incorrectly being processed when there is a non-IKI IKI-like string.

The delimits, after the first, are not being processed.

This is the result of an accidental double increment.
When checking against a possible IKI variable and it is determined that the string cannot be an IKI variable, a double increment occurs.
What is happening is that the break statement only breaks out of the immediate loop.
There is a second loop that does an increment is not being broken out of.

Utilize the separator_found boolean to determine whether or not to perform the additional break.

2 years agoCleanup: Fix alphabetic ordering.
Kevin Day [Tue, 12 Jul 2022 01:03:12 +0000 (20:03 -0500)]
Cleanup: Fix alphabetic ordering.

Some of the color structures cannot be alphabetically ordered.
These can be, so make it so.

2 years agoSecurity: Invalid read for formatted printing using partial ranges on a string.
Kevin Day [Mon, 11 Jul 2022 02:45:33 +0000 (21:45 -0500)]
Security: Invalid read for formatted printing using partial ranges on a string.

If the start position is greater than the used buffer, then an invalid read occurs.
Properly verify that the start position is not greater than or equal to the used length of the string.

2 years agoFeature: Add support to the "print" operation for escape sequences just like the...
Kevin Day [Sun, 10 Jul 2022 22:49:53 +0000 (17:49 -0500)]
Feature: Add support to the "print" operation for escape sequences just like the "write" operation has.

The print now prints raw data.

Fix documentation comments.

2 years agoCleanup: Converted type is actually uint32_t rather than f_utf_char_t.
Kevin Day [Sun, 10 Jul 2022 22:26:42 +0000 (17:26 -0500)]
Cleanup: Converted type is actually uint32_t rather than f_utf_char_t.

The f_utf_char_t is supposed to be an uint32_t so this is not a problem.

The intent and design of this, however, is that f_utf_char_t is a special case representing the character as a string rather than as a digit.
The f_utf_char_t is stored as a 4-byte integer to store each byte representing a character.

The uint32_t is simply a straight up 4-byte integer.

This is the numeric value of the code point rather than the representation as a string.
This is an important semantic difference.

2 years agoFeature: The featureless make program now supports the "write" operation.
Kevin Day [Sun, 10 Jul 2022 22:10:52 +0000 (17:10 -0500)]
Feature: The featureless make program now supports the "write" operation.

This is an oversight on my part.
There should be an operation to write to a file.

There are two forms of this new "write" operation.
1) Truncate a file (deletes all data within a file).
2) Append to a file.

A file is created if it does not already exist in both cases.

The "write" operation supports some standard escape sequences as well as some non-standard ones.

Standard Escape Sequences:
- "\f": Form Feed.
- "\n": New Line.
- "\r": Carriage Return.
- "\t": Tab.
- "\v": Vertical Tab.
- "\\": Backslash Character (may require additional slashes in certain circumstances.)
- "\0": NULL Character.

Non-Standard Escape Sequences:
- "\U+": Unicode Sequence (followed by a valid Unicode sequence with a minimum 4 hexidecimal digits and a maximum of 6 hexidecimal digits).
- "\U-": Terminate a Unicode Sequence, allowing for "\U+000A\U-5" to be equivalent to "\n5".

2 years agoCleanup: Fix documentation comments.
Kevin Day [Sun, 10 Jul 2022 22:04:57 +0000 (17:04 -0500)]
Cleanup: Fix documentation comments.

2 years agoBugfix: Incorrect information is printed on certain errors.
Kevin Day [Sun, 10 Jul 2022 05:45:05 +0000 (00:45 -0500)]
Bugfix: Incorrect information is printed on certain errors.

Remove unused line variable.

The f_fss_count_lines() function appends to the calculated length variable.
The number is not being reset.
This results in each iteration adding to the previous:
  Line number 1, count = 1.
  Line number 2, count = 3.
  Line number 3, count = 6.
  etc...

Reset the line number on each pass of the loop to get the correct line number.

An error message is printing "1" when it should be printing "2".

The "%Q" should be used instead of "%s" for the static string.

Replace "parameter" with "Content" to be consistent with other error messages.

2 years agoCleanup: Update controller examples.
Kevin Day [Sun, 10 Jul 2022 05:20:27 +0000 (00:20 -0500)]
Cleanup: Update controller examples.

2 years agoBugfix: "State is now ..." should not be printed when quiet is passed.
Kevin Day [Sun, 10 Jul 2022 04:52:15 +0000 (23:52 -0500)]
Bugfix: "State is now ..." should not be printed when quiet is passed.

2 years agoBugfix: Empty strings improperly pass validation checks.
Kevin Day [Sun, 10 Jul 2022 03:28:12 +0000 (22:28 -0500)]
Bugfix: Empty strings improperly pass validation checks.

An operation such as the following:
  if exists 'define:"does_not_exist"'

Results in an empty string.

The empty string is passing the existence check.
Empty strings should fail existence checks in this case.

Handle all such cases that I am able to quickly find.

2 years agoRefactor: "if defined" and "if not defined" to be easier to use in fake program.
Kevin Day [Sun, 10 Jul 2022 02:52:07 +0000 (21:52 -0500)]
Refactor: "if defined" and "if not defined" to be easier to use in fake program.

Using "if not defined parameter work" can be confusing.
Using "if not parameter work" is shorter and easier to understand.

Using "if defined environment PATH" can be very confusing.
Using "if define PATH" is shorter and a lot easier to understand.

Break apart the "if defined" (and "if not defined") logic into two operations:
1) "if define" (and "if not define").
2) "if parameter" (and "if not parameter").

This makes the behavior easier to understand as it directly maps to the "defined" and "parameter" settings.

2 years agoUpdate: Ensure first if block is initialized to operate.
Kevin Day [Sun, 10 Jul 2022 02:50:53 +0000 (21:50 -0500)]
Update: Ensure first if block is initialized to operate.

2 years agoCleanup: Remove unnecessary includes in fake program.
Kevin Day [Sun, 10 Jul 2022 00:30:25 +0000 (19:30 -0500)]
Cleanup: Remove unnecessary includes in fake program.

2 years agoCleanup: Fix spelling mistake, 'tread' should be 'treat'.
Kevin Day [Sun, 10 Jul 2022 00:00:59 +0000 (19:00 -0500)]
Cleanup: Fix spelling mistake, 'tread' should be 'treat'.

2 years agoUpdate: Use "settings" instead of "setting" for better consistency between fake progr...
Kevin Day [Sat, 9 Jul 2022 22:59:59 +0000 (17:59 -0500)]
Update: Use "settings" instead of "setting" for better consistency between fake program and controller program.

Featureless Make is using "settings" and the Controller program is using "setting".
Fix this inconsistency.
The term "settings" sounds more accurate than "setting".

2 years agoUpdate: Restrict environment to PATH and LD_LIBRARY_PATH by default.
Kevin Day [Sat, 9 Jul 2022 22:44:24 +0000 (17:44 -0500)]
Update: Restrict environment to PATH and LD_LIBRARY_PATH by default.

Change all of the setting files and fakefiles to restrict the environment variables.
Only PATH and LD_LIBRARY_PATH are exposed so that custom build environments can easily be used by default.

2 years agoFeature: The controller program should expose the "define" and "parameter" at the...
Kevin Day [Sat, 9 Jul 2022 22:33:21 +0000 (17:33 -0500)]
Feature: The controller program should expose the "define" and "parameter" at the Entry and Exit level.

The "define" and "parameter" should be made available in the Entry and Exit files.
This allows for passing data to all Rules.

Update documentation.

2 years agoSecurity: Invalid read when using -s/--settings in fake program.
Kevin Day [Sat, 9 Jul 2022 22:19:55 +0000 (17:19 -0500)]
Security: Invalid read when using -s/--settings in fake program.

The Featureless Make -s/--settings parameter handling code has a typoe where the wrong enumeration is used.
This results in an invalid read.

2 years agoUpdate: Make environment variable handling design consistent between fake and control...
Kevin Day [Sat, 9 Jul 2022 22:02:15 +0000 (17:02 -0500)]
Update: Make environment variable handling design consistent between fake and controller programs.

The Featureless Make system does not have a way of passing all environment variables.
Add a flag to designate whether or not environments is empty because it is not defined or is empty because it is defined as empty just like the controller program does.

This then allows for more flexible control over whether or not the environment variable security.

Update the example setting files and fakefiles to expose PATH and LD_LIBRARY_PATH by default.

2 years agoUpdate: Further reduce memory allocation pressure by increasing default small allocation.
Kevin Day [Sat, 9 Jul 2022 16:29:51 +0000 (11:29 -0500)]
Update: Further reduce memory allocation pressure by increasing default small allocation.

Double the default small allocation size from 4 to 8.
This accepts the compromise that this will increase the amount of memory used in certain cases.

2 years agoFeature: Add missing function f_environment_get_all().
Kevin Day [Sat, 9 Jul 2022 16:27:09 +0000 (11:27 -0500)]
Feature: Add missing function f_environment_get_all().

A get all environment variables function should exist.
The POSIX/libc standards do not seem to provide one.

Utilize the "environ" variable to load all of the environment variables into a string map array.

2 years agoSecurity: Environment value has invalid read.
Kevin Day [Sat, 9 Jul 2022 16:14:12 +0000 (11:14 -0500)]
Security: Environment value has invalid read.

The string may not be allocated.
Check that the string.used is not 0 but if it is then pass an empty string.

2 years agoBugfix: Condition blocks are still being processed when they should be skipped.
Kevin Day [Sat, 9 Jul 2022 04:58:16 +0000 (23:58 -0500)]
Bugfix: Condition blocks are still being processed when they should be skipped.

Re-design the block code to simplify the logic and make the code more readable.
This is only a partial re-design.
I did not perform an extensive review.
I am considering writing some runtime/program tests to better catch problems and regressions.

2 years agoUpdate: The "engine" rule setting should support parameters.
Kevin Day [Tue, 5 Jul 2022 15:34:35 +0000 (10:34 -0500)]
Update: The "engine" rule setting should support parameters.

2 years agoCleanup: Remove unused task feature.
Kevin Day [Tue, 5 Jul 2022 13:53:42 +0000 (08:53 -0500)]
Cleanup: Remove unused task feature.

This functionality did not make the cut for the 0.6.x stable release series.
I may revisit this in the future.

2 years agoUpdate: Change default controller settings path to './'.
Kevin Day [Tue, 5 Jul 2022 13:47:27 +0000 (08:47 -0500)]
Update: Change default controller settings path to './'.

This feels more natural to me now that I am writing and testing the controller settings.
I originally wanted the default to be self contained.
If I want to run in a sub-directory such as 'controller/', then just pass '-s controller'.

2 years agoRefactor: Rename "script" setting to "engine".
Kevin Day [Tue, 5 Jul 2022 13:43:31 +0000 (08:43 -0500)]
Refactor: Rename "script" setting to "engine".

The scripting engine is now called "engine".
This fixes ambiguity issues between the "script" action and the scripting engine.
This makes the code and configuration files easier to read and understand.

2 years agoUpdate: Change execute error code handling to better accommodate standard GNU Bash...
Kevin Day [Tue, 5 Jul 2022 12:50:07 +0000 (07:50 -0500)]
Update: Change execute error code handling to better accommodate standard GNU Bash return codes.

This introduces the status codes F_call and F_call_not as part of the required changes.
This also introduces F_yes, F_yes_not, F_no, and F_no_not.

Improve the wording of some of the error messages.

2 years agoCleanup: Fix word mistake.
Kevin Day [Tue, 5 Jul 2022 01:30:27 +0000 (20:30 -0500)]
Cleanup: Fix word mistake.

2 years agoFeature: The fake progam is supposed to support a piped fakefile.
Kevin Day [Tue, 5 Jul 2022 01:17:48 +0000 (20:17 -0500)]
Feature: The fake progam is supposed to support a piped fakefile.

I thought I implemented this already.
I just tried to use it and found it that I had not implemented.
This feature is supposed to be in the stable release.

2 years agoUpdate: Next minor version (0.6.0).
Kevin Day [Mon, 4 Jul 2022 20:16:47 +0000 (15:16 -0500)]
Update: Next minor version (0.6.0).

2 years agoUpdate: Improve design in f_conversion to be safer when handling variables allowed... 0.5.10
Kevin Day [Sat, 2 Jul 2022 03:28:42 +0000 (22:28 -0500)]
Update: Improve design in f_conversion to be safer when handling variables allowed to be replaced.

The constants are allowed (and encouraged) to be changed as desired by some developer or distributor.
This means constant strings like f_string_ascii_1_s could, in theory, be any length.

Change the do..while loops into normal while loops.
Change the while loop using sizeof(f_char_t) to instead use the actual constant string structure(via a pointer).

This situations was identified by the -fanalyzer functionality of GCC-12.1.
The -fanalyzer from earlier GCC versions, such as GCC 11, did not identify this.

The sizeof(f_char_t) is not strictly needed for the fwrite_unlocked() calls because they are wrapped in a loop.
The sizeof(f_char_t) can be assumed to be 1 in general and even if it is greater than 1, the loop will still ensure success.
Removing the sizeof(f_char_t) simplifies the design.

2 years agoBugfix: Signal code is not being set when accepted signal is received.
Kevin Day [Sat, 2 Jul 2022 03:00:49 +0000 (22:00 -0500)]
Bugfix: Signal code is not being set when accepted signal is received.

2 years agoUpdate: Add additional checks just in case execution is attempted with both program...
Kevin Day [Fri, 1 Jul 2022 22:55:29 +0000 (17:55 -0500)]
Update: Add additional checks just in case execution is attempted with both program name and arguments have no data.

2 years agoCleaup: Spelling mistake in debugging documentation.
Kevin Day [Fri, 1 Jul 2022 22:29:48 +0000 (17:29 -0500)]
Cleaup: Spelling mistake in debugging documentation.

2 years agoUpdate: Example bootstrap script now supports building all programs.
Kevin Day [Fri, 1 Jul 2022 22:22:05 +0000 (17:22 -0500)]
Update: Example bootstrap script now supports building all programs.

Looping over all programs, building them, and installing them is a very common process.
Adding support for this to the example bootstrap script should save me some time and effort.

Also change the separate clean and build commands into a single command using the rebuild command.

2 years agoUpdate: Add note about ulimit privileges potentially causes failure of example contro...
Kevin Day [Fri, 1 Jul 2022 21:19:54 +0000 (16:19 -0500)]
Update: Add note about ulimit privileges potentially causes failure of example controller rules.

2 years agoUpdate: Add the last of the unit tests for f_thread.
Kevin Day [Fri, 1 Jul 2022 05:36:16 +0000 (00:36 -0500)]
Update: Add the last of the unit tests for f_thread.

This implements the last of the intended unit tests for f_thread.

2 years agoBugfix: Problems exposed by f_thread unit tests.
Kevin Day [Fri, 1 Jul 2022 05:32:38 +0000 (00:32 -0500)]
Bugfix: Problems exposed by f_thread unit tests.

Notable fixes:
- Rename f_thread_semaphore_file_create() to f_thread_semaphore_file_open().
- Rename f_thread_semaphore_file_delete() to f_thread_semaphore_file_close().
- Rename f_thread_semaphore_file_destroy() to f_thread_semaphore_file_delete().
- Have f_thread_semaphore_file_open() accept a double pointer for semaphore because sem_open() returns a pointer.
- Initializer f_thread_semaphore_t_initialize is on a union which is initialized differently from a normal digit.

2 years agoProgress: Add more unit tests for f_thread.
Kevin Day [Thu, 30 Jun 2022 05:40:06 +0000 (00:40 -0500)]
Progress: Add more unit tests for f_thread.

2 years agoBugfix: Problems exposed by f_thread unit tests.
Kevin Day [Thu, 30 Jun 2022 05:39:12 +0000 (00:39 -0500)]
Bugfix: Problems exposed by f_thread unit tests.