]> Kevux Git Server - fll/log
fll
2 months agoUpdate: Improve robustness of the fll_control_group_prepare() function.
Kevin Day [Wed, 11 Sep 2024 05:21:13 +0000 (00:21 -0500)]
Update: Improve robustness of the fll_control_group_prepare() function.

Add additional existence checks before attempting to create a directory within the cgroup path.

2 months agoBugfix: Get the FSS Embedded List Read working as expected based on runtime tests.
Kevin Day [Sat, 7 Sep 2024 00:08:42 +0000 (19:08 -0500)]
Bugfix: Get the FSS Embedded List Read working as expected based on runtime tests.

A good portion of clean ups and design changes to address special cases or anything overlooked.
The runtime tests now pass as expected.

This does not address the currently incomplete depth processing of the FSS Embedded List Read.

There are still some situations that need to be fixed.

2 months agoBugfix: Bad handling of comments due to not re-assigning line start and fix mispellin...
Kevin Day [Thu, 5 Sep 2024 02:41:04 +0000 (21:41 -0500)]
Bugfix: Bad handling of comments due to not re-assigning line start and fix mispelling in tests.

The `valud` should be `valid`.

2 months agoUpdate: The stand alone builds to handle the added use of f_utf_buffer_decrement().
Kevin Day [Wed, 4 Sep 2024 23:56:22 +0000 (18:56 -0500)]
Update: The stand alone builds to handle the added use of f_utf_buffer_decrement().

2 months agoBugfix: Incorrect parameter added to macro_fl_fss_data_embedded_list_t_initialize_1().
Kevin Day [Wed, 4 Sep 2024 23:50:36 +0000 (18:50 -0500)]
Bugfix: Incorrect parameter added to macro_fl_fss_data_embedded_list_t_initialize_1().

2 months agoBugfix: The delimited FSS lists are not properly setting the stop point.
Kevin Day [Wed, 4 Sep 2024 23:47:23 +0000 (18:47 -0500)]
Bugfix: The delimited FSS lists are not properly setting the stop point.

This uses existing variables and shuffles the data around rather than defining a new variable.

2 months agoUpdate: Recent changes to the FSS implementations did not account for the unit tests.
Kevin Day [Wed, 4 Sep 2024 23:31:38 +0000 (18:31 -0500)]
Update: Recent changes to the FSS implementations did not account for the unit tests.

2 months agoFeature: Add support for building under Android.
Kevin Day [Wed, 4 Sep 2024 23:29:17 +0000 (18:29 -0500)]
Feature: Add support for building under Android.

This is a forward port of the changes from the 0.6 branch without any testing.

This is not well tested or well supported.
This does have limited testing under the Termux project environment using CLang.

Add a new configuration option to build and run the project in an Android environment.

The test system had problems with text relocations but then required PIE.
This disables the relro in some spots (libraries) while enabling it in others (programs/executables).

Disable a lot of the functions that are not available or supported.

I have observed several warnings about `DT_FLAGS_1=0x41` being unsupported flag.
That is not a very helpful warning.
I have no idea what `0x41` is.
This causes a problem where the output of programs displays these warnings.
This can break programs that require I/O formatting and processing.

This has been tested to build using `bootstrap.sh` and then using `fake`.
Example build and install process:
# mkdir ~/software
# cd fll-0.6.X/
# ./bootstrap.sh build -m monolithic -m thread -m clang -m android && ./install.sh ~/software
# cd ../fake-0.6.X/
# ./bootstrap.sh build -m monolithic -m thread -m clang -m android -w ~/software && ./install.sh ~/software
# export LD_LIBRARY_PATH=~/software/libraries/shared
# export PATH=~/software/programs/shared
# cd ../byte_dump-0.6.X/
# fake -m monolithic -m thread -m clang -m android -w ~/software && ./install.sh ~/software

Example execution of `byte_dump` of `bash` program (this is a large dump).
# byte_dump -wt 7 $(type -p bash)

2 months agoBugfix: Incorrect disabled defines and missing disable wrapping defines.
Kevin Day [Wed, 4 Sep 2024 22:58:45 +0000 (17:58 -0500)]
Bugfix: Incorrect disabled defines and missing disable wrapping defines.

The `_di_f_fss_complete_e_` is required by multiple programs.

The `private_fl_fss_basic_write_object_trim()` is called by `private_fl_fss_basic_write()`.
This must now expose multiple types.

2 months agoBugfix: Replace index() with strchr().
Kevin Day [Wed, 4 Sep 2024 03:21:15 +0000 (22:21 -0500)]
Bugfix: Replace index() with strchr().

The `index()` function is deprecated.
Use the `strchr()` function instead.

2 months agoUpdate: Simplify and centralize reporting for FSS read errors.
Kevin Day [Wed, 4 Sep 2024 01:17:50 +0000 (20:17 -0500)]
Update: Simplify and centralize reporting for FSS read errors.

Use a single function to handle the common cases.

This is an improvement upon commit a9b37a3f8fd99e45feff22779e8d375314cbb925.

2 months agoUpdate: Improve error reporting resulting from unsupported file formats.
Kevin Day [Tue, 3 Sep 2024 03:59:59 +0000 (22:59 -0500)]
Update: Improve error reporting resulting from unsupported file formats.

The file is either an unsupported format or has syntax errors.
Provide a more human-friendly error message rather than the default catch-all error with a status code.

2 months agoUpdate: Implement Object alignment and trim expanding in FSS Read programs and restru...
Kevin Day [Mon, 2 Sep 2024 20:17:19 +0000 (15:17 -0500)]
Update: Implement Object alignment and trim expanding in FSS Read programs and restructure the program flags.

The program flags for the standard-specific functionality vs the program arguments were previously stored in the same bit space.
This breaks the two parts into the main program flags and the "feature" flags.

Implement support for new functionality where the Object structure can be optionally preserved.

Implement support for new functionality where the tabbing of the Object can be preserved, even when trimmed.
This is a step towards a "pretty print" mode that is more or less an "original print" mode.
The tabbing structure is now well preserved for standards like FSS Extended List (FSS-0003).

The Object alignment can determined from the Object close.
Use the `closes` structure to identify how the Object end is tabbed.
Then use that tabbing for the Object.
When trimming is enabled, still apply that tabbing.
This is done only for standards where such behavior makes sense.

The original print is now better preserved.
Printing an Object can now print the before and after Object characters (usually white space).
The trimming and original print may be used together to produce the results where the is no white space before or after the Object but everything else from the original source is preserved.
This combination of trim and original essentially ensure that the old behavior can be still produced.

I would further note that the processing of the FSS Embedded List (FSS-0008) Objects is not recursively performed.
No trimming or anything like that is applied at this time.
Only the selected depth is recursed into such that the Object and Content are processed.
I made this decision to keep the design as simple as possible.
Should I get the motivation and the time, then I may at some point in the future decided to recursively process and format all of the embedded structures.

I happened to notice duplicate and unused flags.
These are now removed.

Update the runtime tests accordingly.

Add new runtime tests to test the updated behavior.
I used the 0.6 and 0.7 to test these and I compared the results.
There is a discrepancy in some of 0.6 and 0.7 tests.
I will have to follow this commit with additional test fixes as necessary pending further review.

2 months agoUpdate: The FSS Lists (FSS-0002, FSS-0003, FSS-0008, etc..) to match recent specifica...
Kevin Day [Sat, 31 Aug 2024 23:43:50 +0000 (18:43 -0500)]
Update: The FSS Lists (FSS-0002, FSS-0003, FSS-0008, etc..) to match recent specification changes and reduce redundancy.

Update the Object read functions to be in compliance with the latest specification changes.
Review and update the code, fixing any observed problems and perform some clean ups.

I noticed that several of the list functions for Object read are almost identical.
Move this logic into into a shared private function to reduce repeated code.

The runtime tests are also updated.

I still need to review the Content read functions.
I probably may be able to also find similar, if not identical, code for the list write functions as well.
I will review the code and create a private function similar to what is done here if deemed possible and reasonable.

2 months agoCleanup: Fix bad grammar in function documentation comments.
Kevin Day [Sat, 31 Aug 2024 23:42:52 +0000 (18:42 -0500)]
Cleanup: Fix bad grammar in function documentation comments.

2 months agoCleanup: The testfile for the FSS Read programs.
Kevin Day [Sat, 31 Aug 2024 00:47:18 +0000 (19:47 -0500)]
Cleanup: The testfile for the FSS Read programs.

2 months agoUpdate: The FSS Basic List (FSS-0002) to match recent specification changes regading...
Kevin Day [Fri, 30 Aug 2024 05:06:32 +0000 (00:06 -0500)]
Update: The FSS Basic List (FSS-0002) to match recent specification changes regading Objects.

The runtime tests are also updated.
The FSS Payload (FSS-000E) tests are also updated as they use the FSS-0002 code.

2 months agoUpdate: The FSS-0002 and FSS-0003 standards, modifying the space after Object rules.
Kevin Day [Fri, 30 Aug 2024 02:23:17 +0000 (21:23 -0500)]
Update: The FSS-0002 and FSS-0003 standards, modifying the space after Object rules.

My previous changes did not alter the behavior of the standard.
I spent some time considering this and decied that I should make this change.

The new behavior is that white spaces after the last printable character (aka "graph" character) in a valid Object is no longer considered part of the Object.
I decided to do this because supporting the space after the Object but not the space before the Object is awkward and also makes Object name matching more difficult.
One of the pillars of this project is "human first".
Doing this change makes it easier for a human to use by relaxing the exactness of a match when it comes to white spaces before or after a valid Object.

The specifications specifically include optionally supporting untrimmed Objects that include the white space before or after the Object to help accommodate the previous behavior.

I do not want to add quote support in the Object names here to keep it simple.
This new behavior seems to be a good compromise.

2 months agoUpdate: Clarify the FSS-0002 and FSS-0003 standards regarding the white space before...
Kevin Day [Thu, 29 Aug 2024 03:25:33 +0000 (22:25 -0500)]
Update: Clarify the FSS-0002 and FSS-0003 standards regarding the white space before and after a valid Object.

I updated my 0.7 code and back ported some of the generated runtime tests.
I discovered problems and realized that the standard could be more clear according to the spaces before and after the Object.

This does not change the FSS-0002 and FSS-0003 standards in any functional way.
The simply clarifies the standard regarding the spaces to make it more clear and reduce the chances for a mistake.

2 months agoProgress: Continue working on getting FSS Embedded Read working.
Kevin Day [Wed, 28 Aug 2024 03:26:32 +0000 (22:26 -0500)]
Progress: Continue working on getting FSS Embedded Read working.

The runtime tests currently pass but I am not done with the changes.

Fix several problems with the Embedded List processing from fl_fss.
- The comments are now being handled correctly along with the `close`.

I noticed that the `--columns` could be opposing `--object` and `--content`.
This would make more sense as the combination of `--object` is meaningless.
I could also just throw a parameter error the `--columns` cannot be used with `--object`.
Then I could update the runtime tests to make more sense regarding the combination of `--object` and `--columns`.

2 months agoProgress: Continue working on getting FSS Embedded Read working and tweak allocations.
Kevin Day [Tue, 27 Aug 2024 04:22:59 +0000 (23:22 -0500)]
Progress: Continue working on getting FSS Embedded Read working and tweak allocations.

The extended list needs a separate parameter and make the `line_start` match the `newline_last` at the start of the function.
Record `newline_last` and `line_start` whenever possible once a new line is found.
Use the variable `comment_start` to make the purpose more clear.

The `closes` array should be initialized before calling `fl_fss_extended_list_content_read()`.
Make sure the `closes` array value is reset when the Content is not found.
Make sure the `closes` array used length is incremented.

The FSS Read functions now handle printing the close strings.
I am now considering adding an `open` variable.
Doing this would then merit moving most things into the `f_fss_item_t`.

Tweak some of the allocations in other FSS functions for allocations that need explicit sizes (`f_memory_array_increase_by()`).

2 months agoProgress: Continue working on getting FSS Embedded Read working and also add Object...
Kevin Day [Sun, 25 Aug 2024 22:07:47 +0000 (17:07 -0500)]
Progress: Continue working on getting FSS Embedded Read working and also add Object close support.

This starts the work for the handling of the depths.
I noticed the tests now pass despite the depths being incomplete.
Looks like I need to add some runtime tests for depths for both 0.6 and 0.7.

This brings in the runtime test expects from the 0.6 branch.

I have some brain storming to do so that I can determine how I want to handle the depth processing logic.

I decided that now is a good time to add support for the Object close.
This is to address the problem where I cannot print the original Object close for FSS Extended List and FSS Embedded List.
The reason being that the necessary data is not actually recorded.
I have not yet updated the unit tests.
I have not yet did any actual tests to confirm that this works.
I have not yet actually utilized this in the FSS Extended List Read and FSS Embedded List Read programs.
I have only made the low level changes and made sure everything compiles.

2 months agoProgress: Continue working on getting FSS Embedded Read working.
Kevin Day [Sat, 24 Aug 2024 03:18:33 +0000 (22:18 -0500)]
Progress: Continue working on getting FSS Embedded Read working.

I noticed that I forgot that I had intentionally set the size of the static array to 777 to try and trigger any problems.
I forgot about that and committed this in my previous progress commit.
This is now restored to a valid value.

This adds additional checks to the quotes and delimits arrays.
These are used in such a way that they much match the length of the Objects and Contents.
The current, incomplete, design with the FSS Embedded Read is copying over the Objects and Contents but has not yet properly set the delimits and quotes.
This exposes that there needs to be explicit checks between the loosely associated Objects and Contents with the delimits and quotes.

I noticed that the `--object` should always result in showing things even if the `--select` number is infinitely large but does not.
This is now fixed so that it always does this.
The runtime tests are updated as appropriate.

3 months agoProgress: Begin working on getting FSS Embedded Read working.
Kevin Day [Thu, 22 Aug 2024 04:15:13 +0000 (23:15 -0500)]
Progress: Begin working on getting FSS Embedded Read working.

The FSS Embedded Read is not working because nothing is actually implemented.

The problem is that the Nest structure is different from the standard Object and Content structure.
Only a single depth is to be processed.
This means that I can construct an Objects and Contents from the Nest based on the depth and pass that to the existing functions.

The initial work has been started but it is very much incomplete.
There is a lot of work to do in this regard.

3 months agoUpdate: The runtime test files for FSS Embedded Read.
Kevin Day [Wed, 21 Aug 2024 01:10:55 +0000 (20:10 -0500)]
Update: The runtime test files for FSS Embedded Read.

Update these based on the 0.6 branch that currently works.
I neglected this format during the transition and the FSS Embedded Read is currently non-functional.
The runtime tests should fail in most cases.

I will follow this change with the appropriate fixes once I identify and solve the problems.

3 months agoBugfix: The FSS Embedded Read is incorrectly handling empty Content.
Kevin Day [Tue, 20 Aug 2024 23:58:06 +0000 (18:58 -0500)]
Bugfix: The FSS Embedded Read is incorrectly handling empty Content.

The empty Content is being incorrectly handled as noted in the 0.6 commit 93a70bece8ecdb30801744e492fec8bb2601d2a4.

The '}' gets printed on empty Content, which is invalid.
Set the range to out of range when the start position is the line start.
This should only happen for empty Content because valid Content is only closed when '}' is on its own line.

3 months agoBugfix: Mistake in verify.sh script for variable declaration.
Kevin Day [Tue, 20 Aug 2024 12:01:05 +0000 (07:01 -0500)]
Bugfix: Mistake in verify.sh script for variable declaration.

3 months agoUpdate: FSS Read unit tests to handle trailing space when dealing with --line.
Kevin Day [Tue, 20 Aug 2024 03:00:46 +0000 (22:00 -0500)]
Update: FSS Read unit tests to handle trailing space when dealing with --line.

The tests now handle the `--line` parameter such that a trailing space is not printed.
The code is now updated to handle this behavior.

3 months agoCleanup: Relocate depth increment to inline of the if condition.
Kevin Day [Mon, 19 Aug 2024 03:35:29 +0000 (22:35 -0500)]
Cleanup: Relocate depth increment to inline of the if condition.

3 months agoCleanup: Use consistent ordering in fss_read_cache_t.
Kevin Day [Mon, 19 Aug 2024 03:22:23 +0000 (22:22 -0500)]
Cleanup: Use consistent ordering in fss_read_cache_t.

3 months agoUpdate: Unit tests for FSS Embedded Read.
Kevin Day [Mon, 19 Aug 2024 03:21:29 +0000 (22:21 -0500)]
Update: Unit tests for FSS Embedded Read.

I forgot to update the unit tests in commit 104ed789a759a344146431ded54cde9fefb063ec.

3 months agoUpdate: FSS Embedded Read memory allocation logic.
Kevin Day [Mon, 19 Aug 2024 02:41:00 +0000 (21:41 -0500)]
Update: FSS Embedded Read memory allocation logic.

Move the internally managed allocation into externally managed allocation.
This allows for better memory control and optimization by the caller.

The use of `f_memory_array_increase()` is incorrect in several cases.
Switch to `f_memory_array_resize()`.
Add 2 when resizing to account for the depth position but also an additional element as a minor memory allocation optimization.

Get rid of headers that should not be included.

This does not address any of the other problems with the FSS Embedded Read functions.

3 months agoUpdate: Function documentation for f_memory_array_increase().
Kevin Day [Mon, 19 Aug 2024 02:38:26 +0000 (21:38 -0500)]
Update: Function documentation for f_memory_array_increase().

The documentation comment needs to communicate the current behavior of (used + amount <= size).

I may end up reviewing this behavior in the future.

3 months agoUpdate: Add additional runtime tests for FSS Read programs for the --original parameter.
Kevin Day [Sun, 18 Aug 2024 15:03:42 +0000 (10:03 -0500)]
Update: Add additional runtime tests for FSS Read programs for the --original parameter.

3 months agoUpdate: Add additional signal checks in loops.
Kevin Day [Sun, 18 Aug 2024 04:56:18 +0000 (23:56 -0500)]
Update: Add additional signal checks in loops.

3 months agoUpdate: Improve FSS Read function correctness based on runtime unit tests.
Kevin Day [Sun, 18 Aug 2024 01:09:30 +0000 (20:09 -0500)]
Update: Improve FSS Read function correctness based on runtime unit tests.

This improves the runtime unit tests to be more correct as per the standard.
The standard allows for spaces after an Object.

There is no reason to print these extra spaces.
Add additional logic to better handle this behavior.

The FSS Basic Read and FSS Extended Read should not print this extra space after the Object when there is no Content to be printed.

The pipe mode should wrap empty Content with the start and end pipe characters.
This pope mode is still not well tested (or reviewed) and will eventually need further review and runtime tests.

The handling of `--empty` should only apply to when there is empty Content and not when there is no Content at all.

This adds new callback and flags to better handle these situations.

Update the `verify.sh` script (and associated `testfile`) to print the test name.
Update the `generate.sh` and `verify.sh` scripts to safely pass arguments with spaces using `"$@"`.

3 months agoRegression: The UTF-8 program should be printing a new line when not in quiet mode.
Kevin Day [Wed, 14 Aug 2024 01:31:13 +0000 (20:31 -0500)]
Regression: The UTF-8 program should be printing a new line when not in quiet mode.

3 months agoBugfix: FSS Read functions are not handling the --columns and --empty properly.
Kevin Day [Mon, 12 Aug 2024 02:51:40 +0000 (21:51 -0500)]
Bugfix: FSS Read functions are not handling the --columns and --empty properly.

When the `--columns` is specified, then the max columns should only be calculated if the used array size is greater than zero.
In addition, if the `--empty` is not specified, then the columns must also have non-empty Content.

For single Content standards, such as with `fss_basic_read`, the max was always being set to one even if the `contents.used` is zero.

This change will need to be back ported.

This includes updates to the runtime tests.
I still need to do some in-depth review.
I overlooked a situation during the release of the 0.6.11 branch regarding the `--empty` or lack thereof.
I will likely have to fix a bug and update all of the runtime tests in the 0.6.11 for the FSS Read programs.

3 months agoBugfix: Incorrect runtime tests for FSS Read programs.
Kevin Day [Sun, 11 Aug 2024 21:45:02 +0000 (16:45 -0500)]
Bugfix: Incorrect runtime tests for FSS Read programs.

I mass updated the FSS Read tests in the 0.7 branch.
I chose the quick route of just using the program to generate the tests.
This requires that I trust the results to be correct.
I figured I would eventually go through each one and make sure that they are correct at a later time.
It is a development branch, after all.

However, back porting these tests to the stable 0.6 branch revealed some bugs.
I reviewed the failing tests and files and I confirmed that the 0.6 branch is getting correct results and that the tests are incorrect.
The runtime tests in the 0.7 development branches will have to be updated and the bugs there will have to be fixed.

3 months agoUpdate: Add comments in some of the fss_read runtime tests.
Kevin Day [Sat, 10 Aug 2024 03:54:14 +0000 (22:54 -0500)]
Update: Add comments in some of the fss_read runtime tests.

These comments should not end up in the results and so only the source files are changed.

This should help increase the chances of catching an fss_read bug for the particular standard.
The specific comments added would otherwise be valid Object and Content data except for being commented out.

3 months agoSecurity: Missing range checks on comment processing.
Kevin Day [Tue, 6 Aug 2024 03:12:48 +0000 (22:12 -0500)]
Security: Missing range checks on comment processing.

The fss_payload_read such as the runtime test is wrong:
  # fss_payload_read -ocn payload level_3/fss_read/tests/runtime/fss_000e/source/test-0002-mixed.fss -t

The output is 1 but should instead be 4.
  # fss_payload_read -ocn payload level_3/fss_read/tests/runtime/fss_000e/source/test-0002-mixed.fss | wc -l

Investigating this problem revealed that the comment handling code is failing to perform a range check.
The overflow is causing the stop range to point to some random memory address which is almost always larger than the file.
This results in the count being wrong.

This bug is a security concern.
Add the range check in all places where this range check is missing for the comments.

Add additional runtime tests to reflect the condition that exposed this issue.
There is now a "payload" test for all runtime tests.

Update the testfile to make manually generating and verifying the runtime tests easier.
The "generate" and "verify" fakefile operations could not be directly called due needing additional data setup.
Also expose the "test-" setting as a parameter to make changing it easier.

3 months agoCleanup: Remove unused and commented out callback in fss_read.
Kevin Day [Tue, 6 Aug 2024 02:59:22 +0000 (21:59 -0500)]
Cleanup: Remove unused and commented out callback in fss_read.

3 months agoBugfix: FSS Payload Read is not counting the Content when counting the total.
Kevin Day [Tue, 6 Aug 2024 02:56:46 +0000 (21:56 -0500)]
Bugfix: FSS Payload Read is not counting the Content when counting the total.

The fss_payload_read is returning the wrong results.
The "fss_read -A payload" is returning the correct results.
An incorrect flag is being specified.

3 months agoUpdate: Apply the not operator logic to avoid needing to literally specify it.
Kevin Day [Tue, 6 Aug 2024 02:00:29 +0000 (21:00 -0500)]
Update: Apply the not operator logic to avoid needing to literally specify it.

3 months agoRegression: IPv6 detection is failing after isdigit() and similar changes.
Kevin Day [Tue, 6 Aug 2024 01:48:57 +0000 (20:48 -0500)]
Regression: IPv6 detection is failing after isdigit() and similar changes.

The commit 50788517d37ece42f32f6906078d2d59330ec3c9 missed a not operator for the IPv6 address.
The unit tests revealed the problem.

This adds the missing exclamation character '!'.

I also overlooked some cases where I could perform the same optimization used for the referenced commit in some places.
Also use the literal ASCII characters rather than the strings.
The ASCII codes are required and expected and substitution of the characters for the algorithm do not make sense here.
These are characters rather than strings.

3 months agoBugfix: Incorrect settings in the fss_read runtime tests.
Kevin Day [Mon, 5 Aug 2024 01:14:19 +0000 (20:14 -0500)]
Bugfix: Incorrect settings in the fss_read runtime tests.

Several of the tests are "object" tests but use "content" data.
Some tests are both "object" and "content" tests but do not use both.
This is now updated, however there are too many tests to update and fix.
The output is simply re-generated, which to forces a success (even if they should fail).
I need to come back at a later time and review the output.

There are some known problems such as:
# fss_basic_list_read -oc -n hi -t level_3/fss_read/tests/runtime/fss_000e/source/test-0002-mixed.fss
Which results in a wrong count.

# fss_basic_list_read -c -n hi -t level_3/fss_read/tests/runtime/fss_000e/source/test-0002-mixed.fss
vs
# fss_basic_list_read -c -n hi level_3/fss_read/tests/runtime/fss_000e/source/test-0002-mixed.fss | wc -l

3 months agoUpdate: Greatly reduce memory consumption by implementing simple low allocation step.
Kevin Day [Sun, 4 Aug 2024 06:15:14 +0000 (01:15 -0500)]
Update: Greatly reduce memory consumption by implementing simple low allocation step.

Historically the step was always 3.
I found, over time, that increasing the step greatly to something like 128 could greatly reduce memory consumption and performance in many cases.
In the situation where a large number of small objects are allocated then this number like 128 becomes highly abusive.

The simple low allocation step will only allocate a single unit on the very first allocation.
If the next allocation is on an array that has a size greater than one and less than four (via the tiny define), then the step size is set to four during allocation.
If the next allocation is on an array that has a size greater than four and less than eight (via the small define), then the step size is set to eight during allocation.
If the next allocation is on an array that has a size greater than eight and less than sixty-four (via the large define), then the step size is set to sixty-four during allocation.
In all cases, if the request step is less than the calculated step, then the requested step is used.
For example, if the requested step is twelve, then after eight is allocation, then the next generated step size is twelve rather than sixty-four.

Using some test files, shows the following reduction:
- Old: ~8GB of RAM -> New: ~200MB of RAM.
- Old: ~500MB of RAM -> New: ~20MB of RAM.

Update the unit tests accordingly and fix any problems exposed.

3 months agoUpdate: Reduce memory usage by fl_fss_basic_content_read() in some circumstances.
Kevin Day [Sun, 4 Aug 2024 06:07:22 +0000 (01:07 -0500)]
Update: Reduce memory usage by fl_fss_basic_content_read() in some circumstances.

The fl_fss_basic_content_read() is simple enough that the allocation of the found array is only needed on success.

3 months agoUpdate: Optimize away the isdigit(), isalpha(), isalnum(), and isxdigit().
Kevin Day [Sun, 4 Aug 2024 00:40:49 +0000 (19:40 -0500)]
Update: Optimize away the isdigit(), isalpha(), isalnum(), and isxdigit().

I did some research and learned that the "is*()" functions can greatly affect performance due to locale and other manners.
I originally used these to allow for well established optimization to take place.

Replace these with some mathematical operations that should increase performance.
This also means no function call on the stack.
This project is already function stack heavy by design and so reducing functions when easy is a great thing.

Start using literal characters rather than the standard strings for the UTF related functions.
In these cases the ASCII expectation is guaranteed.
The ability to override these is also not practical as the meaning should not change.

I have not looked at all of the "is*()" functions and I may address any remaining ones at a later time.
I potentially may also investigate mapping tables to further improve performance.

These math calculations can be used in a lot of the non-ASCII UTF ranges as well.
I opted to not do these just yet given that such work will take a large amount of time.

I have not done any performance analysis yet but I plan to do so.

3 months agoFeature: Add clock get, set, and precision functions to f_time.
Kevin Day [Sat, 3 Aug 2024 05:14:05 +0000 (00:14 -0500)]
Feature: Add clock get, set, and precision functions to f_time.

3 months agoBugfix: The private_f_abstruses_delete_switch() and private_f_abstruses_destroy_switc...
Kevin Day [Sat, 3 Aug 2024 00:43:04 +0000 (19:43 -0500)]
Bugfix: The private_f_abstruses_delete_switch() and private_f_abstruses_destroy_switch() both need wrapping defines.

The previous commit a2e1999a3e5c02a980fcbe9977b059c4639ea741 has a wrong define wrapper added.
The _di_f_abstruses_delete_ was added when it should instead be _di_f_abstruse_map_delete_.

The private_f_abstruses_destroy_switch() is also overlooked by that commit.
This adds the _di_f_abstruse_map_destroy_ to the private_f_abstruses_destroy_switch().

3 months agoCleanup: Build settings and fakefile mode related settings and documentation.
Kevin Day [Thu, 1 Aug 2024 03:40:58 +0000 (22:40 -0500)]
Cleanup: Build settings and fakefile mode related settings and documentation.

3 months agoBugfix: Incorrect wrapping defines around private_fl_fss_basic_write().
Kevin Day [Fri, 2 Aug 2024 06:12:31 +0000 (01:12 -0500)]
Bugfix: Incorrect wrapping defines around private_fl_fss_basic_write().

3 months agoBugfix: _di_f_file_write_range must instead be _di_f_file_write_range_.
Kevin Day [Fri, 2 Aug 2024 05:55:39 +0000 (00:55 -0500)]
Bugfix: _di_f_file_write_range must instead be _di_f_file_write_range_.

3 months agoBugfix: Missing define wrapper for private_f_rip_find_range(), private_f_abstruses_de...
Kevin Day [Fri, 2 Aug 2024 05:13:24 +0000 (00:13 -0500)]
Bugfix: Missing define wrapper for private_f_rip_find_range(), private_f_abstruses_delete_switch(), and private_fl_payload_header_map_maps().

3 months agoCleanup: Build settings and fakefile mode related settings and documentation.
Kevin Day [Thu, 1 Aug 2024 03:40:58 +0000 (22:40 -0500)]
Cleanup: Build settings and fakefile mode related settings and documentation.

3 months agoBugfix: The stand alone utf8 program should not be specifying build_sources_library.
Kevin Day [Thu, 1 Aug 2024 03:13:41 +0000 (22:13 -0500)]
Bugfix: The stand alone utf8 program should not be specifying build_sources_library.

3 months agoCleanup: Use a pointer to make the code more readable in fake_build_load_setting_proc...
Kevin Day [Thu, 1 Aug 2024 03:07:08 +0000 (22:07 -0500)]
Cleanup: Use a pointer to make the code more readable in fake_build_load_setting_process().

3 months agoBugfix: The build_name and version numbers should not support forward or backward...
Kevin Day [Thu, 1 Aug 2024 02:49:17 +0000 (21:49 -0500)]
Bugfix: The build_name and version numbers should not support forward or backward slashes.

This utilizes the logic from the "stage" setting that strips out invalid slashes.

The standard is updated accordingly to make this behavior more explicit.

3 months agoBugfix: Add stage setting to standards to prevent build state file conflicts.
Kevin Day [Thu, 1 Aug 2024 02:33:32 +0000 (21:33 -0500)]
Bugfix: Add stage setting to standards to prevent build state file conflicts.

The build state stage files are conflicting in some cases.
The old solution to this problem has been observed as insufficient.
The different build settings might have the same exact file name.

I have tossed around the idea of a settings Object such as "stage" in the past but I had previously opted against it.
I now believe that skipping over this was a mistake.

Add a new feature to the standards to fix this bug.
The "stage" value may now be specified.
The fakefile files accept the "stage" setting and passes the result along to any build settings.
The settings files accept the "stage" setting and uses the value by appending it to the stage files.

Only a single value is supported.
The forward and backward slashes are explicitly prohibited.
Other special characters are recommended to be avoided given the possibility of local file system problems.
Rather than erroring out, this slashes are stripped out.

The bootstrap.sh script is updated to support this.
The support for "stage" in the boostrap.sh script is very limited.

3 months agoRefactor: Change bit-wise enumerations into defines.
Kevin Day [Wed, 31 Jul 2024 02:45:20 +0000 (21:45 -0500)]
Refactor: Change bit-wise enumerations into defines.

I did some reviewing of how the enumerations used for flags are used.
These generally are not being used as a type.
An enumeration slightly increases the resulting binary size.
Enumeration values might be limited to just type of int.

This seems like an easy (small) optimization to just use defines rather than enumerations for flags and other bit-wise numbers.

3 months agoUpdate: Remove the control program.
Kevin Day [Wed, 31 Jul 2024 02:37:30 +0000 (21:37 -0500)]
Update: Remove the control program.

The control program is now in its own separate project.

3 months agoUpdate: Refresh the stand alone build files.
Kevin Day [Tue, 30 Jul 2024 04:47:18 +0000 (23:47 -0500)]
Update: Refresh the stand alone build files.

3 months agoUpdate: Add missing ifndef wrapping define for the FSS status codes.
Kevin Day [Tue, 30 Jul 2024 02:37:26 +0000 (21:37 -0500)]
Update: Add missing ifndef wrapping define for the FSS status codes.

3 months agoCleanup: Improve fakefile help using the bracketed IKI syntax.
Kevin Day [Mon, 29 Jul 2024 01:38:42 +0000 (20:38 -0500)]
Cleanup: Improve fakefile help using the bracketed IKI syntax.

3 months agoUpdate: The format sentence end strings, making their usage more clear.
Kevin Day [Sun, 28 Jul 2024 22:18:07 +0000 (17:18 -0500)]
Update: The format sentence end strings, making their usage more clear.

The sentence ends, unlike the other similar global static strings, does not have the "_single" in the name.
Add the "_single" in the name and then for consistency addthe case where there should be no "_single".

These cases are as a result now handled:
- ".%r".
- "'.%r".
- "%[.%]%r"
- "%['.%]%r"
- "%[%[.%]%]%r"
- "%[%['.%]%]%r"

3 months agoCleanup: Remove extra line.
Kevin Day [Fri, 26 Jul 2024 00:34:21 +0000 (19:34 -0500)]
Cleanup: Remove extra line.

3 months agoUpdate: Yet another file with a copyright year that needs to be updated.
Kevin Day [Thu, 25 Jul 2024 03:10:44 +0000 (22:10 -0500)]
Update: Yet another file with a copyright year that needs to be updated.

I overlooked this one it seems.

4 months agoCleanup: Fix grammar mistake in the standard.
Kevin Day [Sun, 14 Jul 2024 21:06:42 +0000 (16:06 -0500)]
Cleanup: Fix grammar mistake in the standard.

This does not alter the "content" of the standard and only alters the grammar.
The version does not, therefore, have to change.

4 months agoUpdate: Add F_lock_spin and F_lock_spin_not to status codes.
Kevin Day [Sat, 13 Jul 2024 05:13:54 +0000 (00:13 -0500)]
Update: Add F_lock_spin and F_lock_spin_not to status codes.

I overlooked spin locks when I added the mutex and the read and write lock status codes.

4 months agoUpdate: Add initialize macros for time.h structures and fix initializer for f_date_t.
Kevin Day [Sat, 13 Jul 2024 03:04:57 +0000 (22:04 -0500)]
Update: Add initialize macros for time.h structures and fix initializer for f_date_t.

4 months agoUpdate: Add additional F_enter and F_enter_not status codes to act as the opposite...
Kevin Day [Fri, 12 Jul 2024 03:23:57 +0000 (22:23 -0500)]
Update: Add additional F_enter and F_enter_not status codes to act as the opposite of F_exit ad F_exit_not.

4 months agoUpdate: Documentation and specifications and add additional status codes.
Kevin Day [Thu, 11 Jul 2024 05:23:00 +0000 (00:23 -0500)]
Update: Documentation and specifications and add additional status codes.

I discovered that some of the documentation and specification files are out of date and are now updated.

Add additional status codes regarding locks.

4 months agoUpdate: Remove Controller program as it is now migrated into its own separate project.
Kevin Day [Tue, 9 Jul 2024 03:47:18 +0000 (22:47 -0500)]
Update: Remove Controller program as it is now migrated into its own separate project.

4 months agoCleanup: Documentation comments regarding optional parameters.
Kevin Day [Mon, 8 Jul 2024 03:05:43 +0000 (22:05 -0500)]
Cleanup: Documentation comments regarding optional parameters.

4 months agoCleanup: Minor style improvements and make pointers constant where possible.
Kevin Day [Mon, 8 Jul 2024 00:30:15 +0000 (19:30 -0500)]
Cleanup: Minor style improvements and make pointers constant where possible.

4 months agoCleanup: Use _1 and _2 consistently in fl_print_t macro functions.
Kevin Day [Mon, 8 Jul 2024 00:23:40 +0000 (19:23 -0500)]
Cleanup: Use _1 and _2 consistently in fl_print_t macro functions.

4 months agoUpdate: Use memmove() instead of memcpy() for memory append and memory append all...
Kevin Day [Sun, 7 Jul 2024 03:09:41 +0000 (22:09 -0500)]
Update: Use memmove() instead of memcpy() for memory append and memory append all functions.

These memory append functions do not state that the memory cannot overlap.
The use of memmove() is safer in that it allows for overlapping memory.

4 months agoBugfix: The f_memory array append and append all need to allow for sources to be...
Kevin Day [Sun, 7 Jul 2024 03:05:54 +0000 (22:05 -0500)]
Bugfix: The f_memory array append and append all need to allow for sources to be NULL.

A valid array that is not allocated will have a size of 0.
Passing these to the function should not result in an error.
If the size is 0, then there is nothing to copy even though array is NULL
This is all fine.

Update the documentation comments to be more explicit on NULL in the parameters.

4 months agoCleanup: Fix incorrect documentation regarding the print functions and the length...
Kevin Day [Sat, 6 Jul 2024 05:30:29 +0000 (00:30 -0500)]
Cleanup: Fix incorrect documentation regarding the print functions and the length parameters.

4 months agoCleanup: Add time based version in each of the documentation and specification files...
Kevin Day [Wed, 3 Jul 2024 04:53:19 +0000 (23:53 -0500)]
Cleanup: Add time based version in each of the documentation and specification files where it is missing.

I am just setting the current date rather than trying to figure out the date of last change.

5 months agoUpdate: Add F_file_empty_not to status codes.
Kevin Day [Mon, 17 Jun 2024 04:11:41 +0000 (23:11 -0500)]
Update: Add F_file_empty_not to status codes.

5 months agoUpdate: Change f_memory_array_increase() and f_memory_array_increase_by() design.
Kevin Day [Sat, 15 Jun 2024 03:21:54 +0000 (22:21 -0500)]
Update: Change f_memory_array_increase() and f_memory_array_increase_by() design.

Don't bother setting the *used size to F_number_t_size_unsigned_d on large size.
Instead, just return an error of F_array_too_large.

Add an unsigned overflow check such that if the increment results in an overflow, then the resulting length will be smaller than the original length.

Update the documentation comments.

5 months agoBugfix: Incorrect condition checks for wrap and replace parameters in iki_read.
Kevin Day [Fri, 14 Jun 2024 03:24:33 +0000 (22:24 -0500)]
Bugfix: Incorrect condition checks for wrap and replace parameters in iki_read.

5 months agoBugfix: Incorrect flag bits for combined flag hexidecimal digit.
Kevin Day [Fri, 14 Jun 2024 03:22:31 +0000 (22:22 -0500)]
Bugfix: Incorrect flag bits for combined flag hexidecimal digit.

5 months agoSecurity: Console parameter single short values array is too small.
Kevin Day [Fri, 14 Jun 2024 02:52:11 +0000 (21:52 -0500)]
Security: Console parameter single short values array is too small.

The short parameters "needs" variable now increases the array size before assignment.

The following command line calls are used to expose the problem and its resolution:
  # fss_basic_list_read specifications/fss.txt +Q -cn "Featureless Settings Specifications" | iki_read +Q -w -rrrrrrrr anti-KISS 'anti-<abbr title="Keep It Simple Stupid">KISS</abbr>' ASCII '<abbr title="American Standard Code for Information Interchange">ASCII</abbr>' BOM '<abbr title="Byte Order Mark">BOM</abbr>' FSS '<abbr title="Featureless Settings Specifications">FSS</abbr>' KISS '<abbr title="Keep It Simple Stupid">KISS</abbr>' UTF-8 '<abbr title="Unicode Transformation Format 8-bit">UTF-8</abbr>' URL '<abbr title="Byte Order Mark">URL</abbr>' XML '<abbr title="Extensible Markup Language">XML</abbr>' -WWW character '<code class="code">' "</code>" code '<code class="code">' '</code>' italic '<em class="em">' '</em>'

5 months agoCleanup: Fix section name of Magic Block structure.
Kevin Day [Thu, 13 Jun 2024 01:13:44 +0000 (20:13 -0500)]
Cleanup: Fix section name of Magic Block structure.

This is not a functional change to the specification and so the version s not changed.

5 months agoUpdate: f_iki unit test to include changes from 0.6.
Kevin Day [Tue, 11 Jun 2024 23:34:02 +0000 (18:34 -0500)]
Update: f_iki unit test to include changes from 0.6.

The 0.6 branch has added support for grave.
The unit tests were then updated.
This forward ports those unit test changes.

5 months agoUpdate: Specifications to use 'grave' as the common term for 'backtick'.
Kevin Day [Tue, 11 Jun 2024 23:16:26 +0000 (18:16 -0500)]
Update: Specifications to use 'grave' as the common term for 'backtick'.

5 months agoBugfix: The fl_directory_create() needs to also handle F_file_found_not.
Kevin Day [Tue, 11 Jun 2024 00:12:18 +0000 (19:12 -0500)]
Bugfix: The fl_directory_create() needs to also handle F_file_found_not.

Creating an entire directory tree is not working as expected when creating non-existent directories that are two levels or greater deep.
For example take "a/b/c", if "a" exists but neither "a/b" nor "a/b/c" then the create fails.
For example take "a/b", if "a exists but not "a/b" then the create succeeds (or appears to because I never noticed the bug before).

The ENOENT (aka: F_file_found_not) is sometimes returned rather than ENOTDIR (aka: F_false) from f_directory_exists().
Process the ENOENT F_file_found_not.

I noticed some problems in the logic of the fl_directory_create() function as well.
The memcpy() needs to start from the same offset as the source copy offset.
Otherwise, the copy is overwriting the string.
Make sure to place the NULL at the "at_path" rather at "at_path - at_tree".

The initial assignment of "tree.used" is not necessary.

5 months agoUpdate: Add all of the fl_print_format() replacement sequences as a static string.
Kevin Day [Mon, 10 Jun 2024 00:00:24 +0000 (19:00 -0500)]
Update: Add all of the fl_print_format() replacement sequences as a static string.

I probably should create a single and double context for every sequence as well.
That is rather time consuming so I will do this some time in the future.

5 months agoUpdate: The f_capability styles and use constant pointers in more places.
Kevin Day [Sat, 8 Jun 2024 04:07:15 +0000 (23:07 -0500)]
Update: The f_capability styles and use constant pointers in more places.

5 months agoFeature: Add "Magic Bit" to the FSS-000F (Simple Packet) format.
Kevin Day [Thu, 6 Jun 2024 01:11:37 +0000 (20:11 -0500)]
Feature: Add "Magic Bit" to the FSS-000F (Simple Packet) format.

Make the FSS-000F (Simple Packet) format more generalized and flexible by allowing other payload formats than only formally supporting FSS-000E (Payload).

This adds a new optional "Magic Block" that is designated via the "Magic Bit", which is the third bit from the left.

This should make it easy to store the Simple Packet as a local file.
This should make it easier for routing to optimize processing of the packet by quickly identifying the packet.

The "Control Block" and the "Size Block" have static sizes and positions, which should make it easy to identify the "Magic Block".
The third bit should be checked and then the "Magic Block" should be checked when trying to quickly identify the packet type via the "Magic Block".

5 months agoCleanup: Remove ++first and ++last parameters that was overlooked.
Kevin Day [Sun, 2 Jun 2024 20:42:47 +0000 (15:42 -0500)]
Cleanup: Remove ++first and ++last parameters that was overlooked.

The man pages are now updated to remove these.
The control program will eventually be in its own project but for now just update it.

5 months agoUpdate: Add F_instance status codes.
Kevin Day [Sun, 2 Jun 2024 17:42:06 +0000 (12:42 -0500)]
Update: Add F_instance status codes.

I am now using "instance" in parallel with "process".
Provide an "instance" codes in a similar manner.

5 months agoCleanup: Add newline before NULL comment and add dash to de-allocate.
Kevin Day [Sun, 2 Jun 2024 15:44:32 +0000 (10:44 -0500)]
Cleanup: Add newline before NULL comment and add dash to de-allocate.

The "Must not be NULL." documentation comments are not consistently structured.
I don't remember which decision I made and so now I am just forcibly setting the same structure with a new line before it.

Improve grammar by adding a dash to de-allocate.

5 months agoBugfix: f_date_simple_t_initialize is using wrong initializer.
Kevin Day [Sun, 2 Jun 2024 15:43:53 +0000 (10:43 -0500)]
Bugfix: f_date_simple_t_initialize is using wrong initializer.

6 months agoUpdate: Remove the ++first and ++last parameters and relating logic.
Kevin Day [Thu, 23 May 2024 03:23:23 +0000 (22:23 -0500)]
Update: Remove the ++first and ++last parameters and relating logic.

I have used this for a while and have decided these are not worth the effort.
The addition is very nice but the additional code and logic is just extra maintenance and complexity for very little gain.

6 months agoCleanup: Fix grammar in comment.
Kevin Day [Thu, 23 May 2024 01:36:41 +0000 (20:36 -0500)]
Cleanup: Fix grammar in comment.

6 months agoCleanup: Warning in unit f_utf tests under GCC 14 regarding type.
Kevin Day [Wed, 22 May 2024 02:38:56 +0000 (21:38 -0500)]
Cleanup: Warning in unit f_utf tests under GCC 14 regarding type.

The string comparison of an integer based value is correct.
Add an explicit cast to make this intent clear and to silence the warnings.