Bugfix: do not include private headers

Manually including private headers from within public headers will result in compilation errors.
The private headers will still get included via the private source file.

Update: provide f_utf_is() and f_utf_is_character() functions

Update: handle invalid UTF-8 fragments

A 1-width UTF-8 character (that is not a valid ASCII character) is used to designate part of a complete UTF-8 character block (aka: 1-width UTF-8 characters are fragments).
Because this fragment cannot exist in isolation, it must be handled as either an invalid or an incomplete UTF-8 fragment.

Provide new status codes for handling incomplete UTF-8 fragments.
Update appropriate functions to detect and handle these invalid or incomplete fragments.

Update: redesign console processing code

Simplify the console structure and reduce the size of codes and parameters.

The "extra" parameter seems a bit overkill, remove it and help keep this project more along the lines of the idea of "Featureless".

Rewrite and document fl_process_parameters().

Implementing functions were only functionally updated.
Additional changes are likely necessary for the logic, such as supporting multiple calls like "program -h +n +l", which by order of operation the final "+l" should override the "+n".

Security: safely print f_dynamic_string

The f_dynamic_string is not NULL terminated and should never be directly passed to a function that assumes strings are NULL terminated.

Cleanup: f_color, fl_color, and related

In particular, some of the color print functions are not following the naming convention.
The function fl_print_color() should instead be fl_color_print().

Make sure appropriate #define statements have macro in their name.

Add some @fixme comments because f_dynamic_string is designed with the intentions of not being NULL terminated.
Directly using it with standard functions like fprint is dangerous.

Cleanup: rename f_errors to f_status, fl_errors to fl_status, and fll_errors to fll_status

Originally f_errors was meant only for error handling but it quickly turned into status code handling (which includes errors).
The naming system of f_errors is now confusing and misleading so change it to f_status.

This makes far more sense, for example:
- f_error_is_error vs f_status_is_error.
- f_error_set_error vs f_status_set_error

Cleanup: remove error test macros

This is legacy behavior that is no longer needed.
Update any existing uses of these deleted macros.

Cleanup: rename return_code to status_code and fss_return_code to fss_status_code

The "return codes" were originally intended to be literal return codes.
When the error codes were converted to have error bits, warning bits, and signal bits, this no longer became the case.
Refactor return_code into status_code to be more accurate.

Update: improve return code error conversion and support converting strings to numbers

Update: readme file and add additional notes on the FLL dependency structure

Cleanup: only use f_macro_ for defines that structurally mimic functions

Cleanup: define fl_directory_name_max as 255 to match PATH_NAME

Update: add UTF-8 support to fl_console

Also remove unnecessary looping.

Update: add more support for UTF-8 and improve effected functions

Use a 32-bit unsigned integer instead of a structure of 4 characters.

Add -lf_utf to dependencies on updated level projects.

Be more thorough when implementing simple fl_seek_* functions.
Support both processing char as well as f_utf_character in string processing.

Continue updating code documentation.

Update: add missing error code to string conversions

Update: implement UTF-8 support in fss processing code and add additional functionality

Additional functionality includes implementing f_utf_character in f_utf.

Includes numerous other small UTF-8 updates.

Some macros have been wrapped in parenthesis to avoid unobvious issues such as when adding an exclamation before a macro call (and the possible order of operation issues).

Update: use max_width instead of maxWidth, remove f_utf_bom check from f_is_space, and provide f_macro_utf_byte_width_is for UTF-8

Cleanup accidental use of maxWidth, when the proper syntax style is instead max_width.

After further review, I have decided to move the f_utf_bom check back outside of the f_is_space() function.

Provide f_macro_utf_byte_width_is() function for getting UTF-8 character widths but returning 0 if the character is ASCII.

Bugfix: f_socket and fl_socket, numerous problems

It looks like the f_socket and fl_socket were not completed or otherwise written incorrectly.
Change the behavior to at least compile.

Feature: implement monolithic build in the generate.sh and package.sh scripts

Update: add UTF-8 BOM detection

Add support for detecting UTF-8 BOM in the f_utf_is_space() function.
Add new function f_utf_is_bom().

Feature: add initial UTF-8 support via f_utf

This provides the most basic functionality for processing UTF-8 characters.

Additional modules will be updated to natively process strings as UTF-8.

Cleanup: add build_sources_settings setting to build settings files

Cleanup: remove duplicate line in build settings file

Cleanup: remove the objects build directory during generate.sh cleanup

Update: implement bash support in generate.sh

The generate script now supports handling bash scripts.

Feature: support custom 'defines'

Some libraries or packages have custom defines, such as the firewall _en_firewall_debug_.

Provide simple documentation of the defines, in the data/build/defines file.
Provide build settings values for specifying these custom defines.
Provide parameter for manually overriding defines.

Some path settings have been renamed to avoid confusion (such as '--c_path' is now '--path_c').

Enable _en_firewall_debug_ by default.

Cleanup: remove 'DEBUG: ' from debug output

Update: add build_libraries_fll build setting

Add a new parameter to make it easier to switch between individual compilation, level compilation, and monolithic compilation.
This parameter will only be used for fll-specific libraries.

For programs (aka: "level 3") commented out examples for linking against level-based and monolithic are provided.
The configurations can then be easily swapped out by a couple of simple sed statements, such as:
  - sed -i -e 's|^build_libraries_fll\>|#&|g' data/build/settings
  - sed -i -e 's|^#build_libraries_fll-level\>|build_libraries_fll|g' data/build/settings

The above example will switch to the level based compiling, while disabling the individual compiling.

The level based compiling compiles each of the levels 0, 1, and 2 as a single library for each level, resulting in libraries such as:
  - libfll_0-0.5.0.so
  - libfll_1-0.5.0.so
  - libfll_2-0.5.0.so

The monolithic based compiling compiles all of the levels 0, 1, and 2 as a single library, resulting in libraries such as:
  - libfll-0.5.0.so

The standard names of individual, level, and monolithic do not overlap by default and can therefoe be installed side-by-side.

Update: replace f_const with const

The typedef f_const is no longer used in place of const.

Feature: work directory support

Work Directory provides an easier way for developers to compile and test a particular set of FLL libraries and programs without conflicting with the host system.

If the host system has some version of the FLL project installed, the versions in the work directory will be used instead of the system directories.

Specifying the work directory is done via the '-w' or '--work_directory' commands.

To better achieve this functionality in the install.sh script, four new additional parameters were created:
- --libraries-static
- --libraries-shared
- --programs-static
- --programs-shared

These provide additional relative or absolute paths for installing the programs and libraries into.
The relative paths for --libraries-static and --libraries-shared is the library directory (which can be specified via --libdir).
The relative paths for --programs-static and --programs-shared is the program directory (which can be specified via --bindir).

Update: version 0.5.0

Feature: level-1: fl_program

The version function is used between all programs in this project.
Move that functionality into its own library: fl_program.

Cleanup: private firewall files do not need to be #ifdef wrapped

The #ifdef wrappers are intended for custom overrides, which should apply only to functions treated as "public".
These firewall files beginning with private- are private and do not need these wrappings.

Bugfix: install script destination parameters not being respected

I used the wrong name in the grab_next variable when designating to grab the next includedir and libdir.
There is also a mistake where I was copying the destination_prefix onto itself.

Update: always return 1 on failure

There were some cases where exit is not being called and other cases where exit 0 is being called.
Make sure that exit 1 is called on error so that this script can then be scriptable.

Bugfix: level-specifc compile settings should compile against level-specific

Security: set default policy to DROP after deleting chains

Performing numerous syscalls can by slow.
During this time, if the default behavior is open, then unwanted packets may make it through.
By dropping by default, these packets will not go through.

Cleanup: update to newer style practices and fix existing style problems found

Use alphabetic whenever possible (structure context overrides this often).
Perform the initial prepatory work for new comment practices.

else end else if blocks are now to be on separate lines instead of inline with '}'.

Bugfix: type sizes autodetection is not reporting proper sizes

Expected sizes are not being returned.
Rewrite the logic to get casting to the highest value to work as desired.

Cleanup: remove empty source file

Cleanup: Use new comment structure at the tops of files

Just put the comments in the header files.
Simplify the comment stucture.
The git repository provides the authors/credits, no need to explicitly do so in the files anymore.
Do not provide the micro version, instead provide the major and minor versions in the files (which effectively represent the API version).

Revert: remove custom type defines, including use of f_autochar

The intent of these custom types is to allow for easily replacing what the type represents.
I have decided that this extent of doing such is overkill.
Revert the custom types to instead rely on the C/C++ defined types, where appropriate.

After having gained more experience with utf-8 an other unicode standards, I have come to conclude that the wchar type should not be used.
This project will support the char type instead of the wchar type.
All uses have been replaced with char.

Bugfix: bash/linux does not support setting high bits on return codes

These bits are generally reserved for process-specific behavior.
Explicitly return 0 for success and 1 for failure.
The firewall program already does this.

The return codes from the main functions of each project will continue to utilize all of the bits as designed.
This will allow for projects that link to the library to get the actual return codes while simultaneously being compatible with Linux and Bash.

Later versions may provide alternative ways to get the error code from within the shell.
For example, if a specific return code environment variable is set, then the program could populate that environment variable on exit (clearing it on start).

Update: add basic featureless settings specifications documentation

This was originally defined online, but I had lost the data at some point.
The internet archive didn't cache the page and the data lost happened during the time I was changing the website.

The specifications were simple enough to be rewritten, but I have done so in haste.
Some of the specifications will be documented at a later date.

I do not remember what advanced reverse mapping was intended to be, so I replaced it with the custom json-like specification.
The goal of the json-like specification is to write it such that it is still valid json (minus any comments).
It is currently added to preserve the idea but there are no immediate plans to implement this specification.

Update: replace advanced reverse mapping with simple json

Cleanup: fix comments and remove commented out memset

According to the standards that I have read, calloc() guarantees zero'd memory, so memset is not needed.
It so happens that the memset was commented out already, so just remove it.

There are some memset related comments that incorrectly use the word 'bool' when the word 'char' should be used.

Update: add the firewall settings files to the 'build_sources_settings' part of the build settings file

Update: Add additional options, fix minor problems, and other  miscellaneous fixes in regards to generate.sh and package.sh scripts

Add functionality provided in install.sh, such as configure based system compatible options: --enable-statuc, --disable-static, --enable-shared, and --disable-shared.

Fix some typos (such as failire which should instead be failure).
Tweak highlight colors used.

Use a separate "operation_failure" variable instead of recycling "operation" for parameter operation problems.

Add -S/--path_s parameter option for specifying a custom settings path.

If paths have a leading slash (/), remove duplicate slashes (such as "///bin/" -> "/bin/").

Make sure the new install.sh script gets added by the package.sh script.

The variable "sources_settings" is using the wrong source path (which was "path_c").
Instead, use the newly added "path_s".

Feature: add install.sh helper script

Provide a very basic install helper script for systems (or users) that do not have or do not want to use their package system to install the compiled files.

This is only intended to help someone install.
It is still recommended that a distribution or packager should povide their own tools to perform the installation.

Cleanup: use 'FILTER' instead of 'PORTS'

Cleanup: make sure 'iptables' appears in error message 'Failed to perform requested iptables operation'

Update: f_null no longer exists

Update: fix firewall utility and utilize recently added functionality

There were a few logic flaws in regards to the processing and memory management.
Switch to new logic where f_new_* and f_clear_* is utilized.
Update accodingly to the fll_execute changes.

Update the default configuration files.

Update the debugging code to work as expected.

Replace string cuntions with memory functions, such as replacing strncat with memcpy.

Add some new helper macros.

Delete all custom chains when rewriting rules to prevent problems.
Iptables unfortunately does not provide a way to check and see if a chain already exists.

Update: disable BUG_strnlen by default

This bug might actually be a bug related to uClibc.
Just disable it by default for now.
Future versions may remove this workaound entirely.

Cleanup: add space

Update: use memcpy instead of strncat

Update: add an f_standard_debug output similar to f_standard_warning

Update: rewrite fll_execute, ensuring f_eol are properly added (and auto-add progam name where possible)

Previously, the f_eol was added but it assumed that there was actual room at the end of the allocated buffer to do so.
This now explicilty allocates a new buffer with room for the terminating f_eol.

The progam name is already provided, so do not require it to be added to the arguments (auto-add it).

Update: make sure f_new_* calls exist and add f_clear_* calls

Bugfix: string lengths now use signed integers

Update: relocate the shared and static build paths to before the library arguments

Bugfix: firewall show command operating as lock

The debug parameters is conditionally enabled/disabled but the enum is not.
Make the enum conditionally enable/disable the debug option to prevent the wrong id from being used when debug is disabled.

Fix the alignment of the debug message.

Conditionally enable/disable displaying the debug in the help.

Bugfix: add missing closing parenthesis

Bugfix: project compiled libraries are not being found

This is the result of an oversight when I converted the libraries directory to have static and shared into subdirectories.
The explicit link path was not updated accordingly.

Feature: add package generation helper scrript

There are four intended package design modes:
1) individual - each package is separated into their own individual directory and version.
2) level - Each of the three levels (level 0, level 1, and level 2) are put into their own directory and version.
3) monolothic - All three levels (level 0, level 1, and level 2) are put into a single directory and version.

Monolithic is not currently implemented due to design limitations in the generate.sh script and build settings files.

Compression is not performed.

Cleanup: re-organize object file generation into separate directory

The object files should be added in an 'objects/' directory instead of in 'libraray/static/' directory.

Security: use signed integers for string lengths and array lenghts by default

Standard functions, such as strnlen(), appear to operate on signed integers instead of unsigned.
Not being able to handle unsigned integers provides unknown behavior that could lead to potential security vulnerabilities.
Future versions of this project will likely need to abandon these methods for more flexible alternatives.

Example problem:
  sources/c/console.c:36:23: warning: 'strnlen' specified bound 18446744073709551615 exceeds maximum object size 9223372036854775807 [-Wstringop-overflow=]
     36 |       string_length = strnlen(argv[location], f_console_max_size);

That is 2^63 instead of the expected 2^64.

The array lengths were converted to signed as well.

Bugfix: add missing includes

Cleanup: add missing build_static default setting and remove duplicates

Bugfix: variables not being stored in array

Do not directly use string in bash array arguments.
More recent versions of bash do not handle this as expected.
Move explicit string to a variable and then use that variable to access the array.

Progress: add the current (draft) of the custom init program

This is effectively a draft of my ideas and is entirely experimental and incomplete.
I am adding it now because of numerous hard-drive failures and data loss of late.

Update: add new rules to firewall (while fixing accident in previous commit)

The earlier commit that applied stale changes apparently had deleted all the rules in the firewall file.
This data has been added back in addition to the new rules and structure.

Progress: add socket libraries

There is likely more work to do with these libraries.
I will follow this up after reviewing with any changes, if needed.

Progress: miscellaneous changes

I was working on stuff a while back and was taken away from the project for quite a while.
These are some uncommitted changes that I would rather commit immediately and then move forward.

There are some other changes I will follow up in separate commits, such as the socket work and the init work.

Update: add support for separate build_static setting

This allows for building both shared and static libraries and programs.

Update: use firewall_default_allocation_step, +1 was being used and should have been +firewall_default_allocation_step

Update: change default rules for icmp traffic and cleanup some comments

I learned a little bit more about icmp and what is and is not deprecated.
Block certain icmp ports by default.

Shorten the file by removing unnecessary comments.

Update: do not resize strings when length = 0, instead just updated used

I was working on this before I moved.
I am not sure if there is more too this that needs to be done, but for now I will push this.

Bugfix: direction option was confusing because it was mixed with chains

- Separate direction command into two separate commands: direction, and chain.
- The chain command mimics iptables chains and is automatically populated by the custom lists (aka: custom chains).
- When direction is set to something other than none, then the active ethernet device is used.
- Code cleanup and changes were performed while working on this.
- Added basic support for debugging, define _en_firewall_debug_ to enable custom debugging parameter.

Update: add debug as a standard console parameter

Update: oops! don't block unicasts by default

Whoops, I overlooked that unicast was the name for the normal, expected, behavior of standard point to point network connections.

Update: improve the contents firewall settings files

- Add more information to the example firewall settings.
- Improve/fix dhcp client/server rules
- Block/Blackhole unicasts, multicasts, and broadcasts.
- Add some examples rules on conntrack and some security rules.

Bugfix: reverse order of library links

It seems I got the order backwards.
I was using -lc and all the lowest level libraries on the left of the libraries that depend on it.
This caused unobvious linkage errors down the road.
Reversing the order prevented the problem and allowed for static libraries to link.

It is possible the order issue is with ar and not with gcc.

Bugfix: remove more cases where build_alt variables where still being used

Bugfix: fix order of library linkage for firewall build settings

The ar command is sensitive to the order in which libraries are added.
Prior to this change, building a static library could have dependencies used before they are defined due to the order in which libraries were added.
Change the order so that libraries are to the right of their dependencies in the command line argument order

Bugfix: fix order of library linkage

The ar command is sensitive to the order in which libraries are added.
Prior to this change, building a static library could have dependencies used before they are defined due to the order in which libraries were added.
Change the order so that libraries are to the right of their dependencies in the command line argument order.

Bugfix: revert compiler workaround 5bdaa0b, place arguments after source

The problem turns out to be that, for gcc at the very least, linker options such as -lc are not properly passed to the linker when it is before the source files.
Using the examples:
  1) gcc -lc main.c
  2) gcc main.c -lc

In case of #1, the -lc is not passed to the linker.
In case of #2, the -lc is passed to the linker.

All arguments are now being moved after the source parts.

see: 5bdaa0b Workaround: compilers on some systems seem to be sensitive to the order of arguments
see: http://gcc.gnu.org/onlinedocs/gcc/Link-Options.html

Update: f_error changes and more signals

- Added more signal commands.
- Added more signal codes for up to 64 signals.
- Replaced f_error_unmask with f_error_set_fine to be more consistent with the other f_error_set_* names.
- The signal bit is intended to be both the error and warning bit set so it is mathematically the same as the mask bit.
- Change f_none starting point to 197 to handle all possible 64 signals.

Cleanup: explicitly initialize f_false enumerator to 0.

Update: add signal code support to f_errors and move error code starting point to 166

Signals are used as the high order bits in a process that exits, which is where I provide error and similar return codes.
For this reason I am adding wrappers to the x86 signal codes in f_errors instead of a separate custom project such as the non-existant f_signals.

It looks like bash mixes the exit codes and signals into the numbers 129 to 165, so start with 166 as well.

Update: uncomment pipe detection code in return_code and fss_return_code

Not sure why this was disabled, perhaps it was not implemented?
At least, enable the variable.

Feature: add support for -p, --project in generate.sh

This adds support for defining a custom name for the use of preparing and building a project.
The files will be called .built-$project and .prepare-$project.
This allows for building multiple projects in the same directory path back to back.

Cleanup: remove unused parameter 'settings_path'

Update: add level's 0, 1, and 2 settings file to build a single library per level

Update: define f_extern as extern

This should allow for mass changing or mass removing f_extern via a simple custom #define or a command line parameter such as -Df_extern= .

Feature: add support for defining the linker program via build_linker= setting

Bugfix: fix missing dependencies

Cleanup: correct the documentation on the file's level

Bugfix: add missing required library link dependencies

It seems I got away with forgetting some important libraries that were required by some libraries.
This makes me wonder if this is the cause of the bug that forced me to create the build_alt option.