From: Kevin Day Date: Wed, 13 Mar 2024 02:09:36 +0000 (-0500) Subject: Update: FSS-000E specification, adding "salt" and "time" as suggested headers. X-Git-Url: https://git.kevux.org/?a=commitdiff_plain;h=c52429175116313ddb08b6fab150bd9288516f0b;p=fll Update: FSS-000E specification, adding "salt" and "time" as suggested headers. I intend to keep the recommended and now suggested headers to a bare minimum. I have decided that "salt" and "time" should be common enough and important enough to add to this small list. --- diff --git a/level_0/f_fss/c/fss/payload.c b/level_0/f_fss/c/fss/payload.c index d030f56..963b53f 100644 --- a/level_0/f_fss/c/fss/payload.c +++ b/level_0/f_fss/c/fss/payload.c @@ -45,6 +45,10 @@ extern "C" { const f_string_static_t f_fss_payload_object_payload_s = macro_f_string_static_t_initialize_1(F_fss_payload_object_payload_s, 0, F_fss_payload_object_payload_s_length); #endif // _di_f_fss_payload_object_payload_s_ + #ifndef _di_f_fss_payload_object_salt_s_ + const f_string_static_t f_fss_payload_object_salt_s = macro_f_string_static_t_initialize_1(F_fss_payload_object_salt_s, 0, F_fss_payload_object_salt_s_length); + #endif // _di_f_fss_payload_object_salt_s_ + #ifndef _di_f_fss_payload_object_signature_s_ const f_string_static_t f_fss_payload_object_signature_s = macro_f_string_static_t_initialize_1(F_fss_payload_object_signature_s, 0, F_fss_payload_object_signature_s_length); #endif // _di_f_fss_payload_object_signature_s_ @@ -57,6 +61,10 @@ extern "C" { const f_string_static_t f_fss_payload_object_status_s = macro_f_string_static_t_initialize_1(F_fss_payload_object_status_s, 0, F_fss_payload_object_status_s_length); #endif // _di_f_fss_payload_object_status_s_ + #ifndef _di_f_fss_payload_object_time_s_ + const f_string_static_t f_fss_payload_object_time_s = macro_f_string_static_t_initialize_1(F_fss_payload_object_time_s, 0, F_fss_payload_object_time_s_length); + #endif // _di_f_fss_payload_object_time_s_ + #ifndef _di_f_fss_payload_object_total_s_ const f_string_static_t f_fss_payload_object_total_s = macro_f_string_static_t_initialize_1(F_fss_payload_object_total_s, 0, F_fss_payload_object_total_s_length); #endif // _di_f_fss_payload_object_total_s_ diff --git a/level_0/f_fss/c/fss/payload.h b/level_0/f_fss/c/fss/payload.h index 6d06679..db12d0f 100644 --- a/level_0/f_fss/c/fss/payload.h +++ b/level_0/f_fss/c/fss/payload.h @@ -124,9 +124,11 @@ extern "C" { * - name: The header Content name Object (an optional string). * - part: The header Content part Object (an optional string). * - payload: The payload Object or signature Content payload Object. + * - salt: The header Content salt Object (an optional string). * - signature: The signature Object. * - size: The header Content size Object (an optional string). * - status: The header Content status Object (an optional string). + * - time: The header Content time Object (an optional string). * - total: The header Content total Object (an optional string). * - type: The header Content type Object (an optional string). */ @@ -142,9 +144,11 @@ extern "C" { #define F_fss_payload_object_name_s "name" #define F_fss_payload_object_part_s "part" #define F_fss_payload_object_payload_s "payload" + #define F_fss_payload_object_salt_s "salt" #define F_fss_payload_object_signature_s "signature" #define F_fss_payload_object_size_s "size" #define F_fss_payload_object_status_s "status" + #define F_fss_payload_object_time_s "time" #define F_fss_payload_object_total_s "total" #define F_fss_payload_object_type_s "type" @@ -159,9 +163,11 @@ extern "C" { #define F_fss_payload_object_name_s_length 4 #define F_fss_payload_object_part_s_length 4 #define F_fss_payload_object_payload_s_length 7 + #define F_fss_payload_object_salt_s_length 4 #define F_fss_payload_object_signature_s_length 9 #define F_fss_payload_object_size_s_length 4 #define F_fss_payload_object_status_s_length 6 + #define F_fss_payload_object_time_s_length 4 #define F_fss_payload_object_total_s_length 5 #define F_fss_payload_object_type_s_length 4 @@ -205,6 +211,10 @@ extern "C" { extern const f_string_static_t f_fss_payload_object_payload_s; #endif // _di_f_fss_payload_object_payload_s_ + #ifndef _di_f_fss_payload_object_salt_s_ + extern const f_string_static_t f_fss_payload_object_salt_s; + #endif // _di_f_fss_payload_object_salt_s_ + #ifndef _di_f_fss_payload_object_signature_s_ extern const f_string_static_t f_fss_payload_object_signature_s; #endif // _di_f_fss_payload_object_signature_s_ @@ -217,6 +227,10 @@ extern "C" { extern const f_string_static_t f_fss_payload_object_status_s; #endif // _di_f_fss_payload_object_status_s_ + #ifndef _di_f_fss_payload_object_time_s_ + extern const f_string_static_t f_fss_payload_object_time_s; + #endif // _di_f_fss_payload_object_time_s_ + #ifndef _di_f_fss_payload_object_total_s_ extern const f_string_static_t f_fss_payload_object_total_s; #endif // _di_f_fss_payload_object_total_s_ diff --git a/specifications/fss-000e.txt b/specifications/fss-000e.txt index be83fe5..141f36a 100644 --- a/specifications/fss-000e.txt +++ b/specifications/fss-000e.txt @@ -1,7 +1,7 @@ # fss-0002 iki-0000 # # license open-standard-license-1.0 -# version 2024/01/01 +# version 2024/03/12 # # This file (assumed to be named fss-000e.txt) can be more easily read using the following iki_read commands: # iki_read fss-000e.txt +Q -w -rr EOF EOF FLL FLL -WWW character "'" "'" code '"' '"' italic '"' '"' @@ -19,11 +19,14 @@ Featureless Settings Specification: 000e - Payload: The italic:"header"\: - The italic:"header"'s Content is of type code:"FSS-0001 (Extended)". - The italic:"header" is recommended to have the Objects italic:"length", italic:"status", italic:"part", italic:"total", and italic:"type". + - The italic:"header" is suggested to have the Objects italic:"salt" and italic:"time". - The recommended italic:"length" represents the size of the italic:"payload". - The recommended italic:"part" represents a single part of a set of packets for when the data being transmitted is split across multiple payloads. - The recommended italic:"status" represents status codes (such as success or failure) and multiple. - The recommended italic:"total" represents the total number of parts representing a complete data transmitted across multiple payloads. - The recommended italic:"type" represents the type of information being transmitted. + - The suggested italic:"salt" represents random arbitrary data to further assist in making packets more unique during compression. + - The suggested italic:"time" represents some form of time unit, such as a time stamp. - The Content for the recommended italic:"length" and italic:"status" are positive whole numbers (including zero) that may be in italic:"binary", italic:"octal", italic:"decimal", italic:"duodecimal", or italic:"hexidecimal" numerical format. - There may be multiple italic:"header" Object and associated Content but the behavior is not defined by this standard. - For guaranteed safe and compatible behavior, only a single italic:"header" Object and associated Content should be defined.