secure-application-logger/Wandi-SSAL-examples.c at main · wandi-ssal/secure-application-logger · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
#include	<stdlib.h>
#include	<stdio.h>

extern	int	LoggerStartUp();
extern	int	LoggerAppsMsg();
extern	int	LoggerShutDown();

enum components {
Main=100,
UI=101
};

enum secevirty {
Info=1,
Error=2
};

/***
This program shows how to use Wandi-SSAL API functions for the free version.

These examples are based on pre-defined fixed Bound Capability parameter
values which are listed in the section "These adjustable paraeters are fixed
for the free version" of the Capabilities document.

Also, refer to the Wandi-SSAL-Bound-Capabilities.pdf document on how these
values are used during validation.

The paid for versions allow these are other parameters to be dynamically adjusted.

***/

int main()
{
	char	*str = "String Argument Value";
	unsigned	int	hex_value = 0x3d59ba4f;
	char	char_value = 'A';

	LoggerStartUp();

	/** Example 1: Number of format string specifiers types per log message.
		1y – Maximum number of format string specifiers types allowed with a message is 6.
	**/
	LoggerAppsMsg(3,Main,Info,"1y - Maximum number of format string specifiers types allowed with a message is 6");
	LoggerAppsMsg(3,Main,Info,">>>> For example: [%d, %d, %d, %d, %d, %s]",91,92,93,94,95,str);

	/** Example 2: Different types of format string specifiers.
		2y – Different types of supported format string specifiers are %s, %d, %f, %c, %x, %p.
	**/
	LoggerAppsMsg(3,Main,Info,"2y - Different types of supported format specifiers are %%s %%d %%f %%c %%x %%p");
	LoggerAppsMsg(3,Main,Info,">>>> For example:  [string=%s, integer=%d, double=%f, char=%c, hex=%x, pointer=%p]",str,99,3.4,char_value,hex_value, str);

	/** Example 3: Length for format string specifier %s arguments.
		3y – Maximum length for format string specifier %s argument is 64 characters.
	**/
	LoggerAppsMsg(3,Main,Info,"3y - Maximum length for string specifier [%%s] argument is 64 characters]");
	LoggerAppsMsg(3,Main,Info,">>>> For example:  [%s]","This string is 64 characters long aaaaaaaaaaaaaaaaaaaaaaaaaaaaa");

	/** Example 4: Length for message format string.
		4y – Maximum length format string specification is 256 characters.
	**/
	LoggerAppsMsg(3,Main,Info,"4y - Maximum length format string specification is 256 characters");
	LoggerAppsMsg(3,Main,Info,"0 character aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaabbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbccccccccccccccccccccccccccccccccccccccccccccccccccdddddddddddddddddddddddddddddddddddddddddddddddddeeeeeeeeeeeeeeeeeeeeeeeee to 256 characters");

	/** Example 5: Subset of ASCII characters for both string arguments and output format strings.
		5y - Fixed subset of ASCII characters allowed: uppler/lower case alphanumeric, blank and  !#$%%&()*+,-./:;<=>?@[]_{|} characters.
	**/
	LoggerAppsMsg(3,Main,Info,"5y - Fixed subset of ASCII characters allowed: uppler/lower case alphanumeric, blank and ! #$%%&()*+,-./:;<=>?@[]_{|} characters."); // print allowed characters in format string specification
	LoggerAppsMsg(3,Main,Info,"[%s]", "! #$&()*+,-./:;<=>?@[]_{|}"); // print allowed characters in string argument
	LoggerAppsMsg(3,Main,Info,"%%"); // print %
	LoggerAppsMsg(3,Main,Info,"100%%"); // print 100%
	LoggerAppsMsg(3,Main,Info,"%%s = %s","STR"); // print %s = STR
	LoggerAppsMsg(3,Main,Info,"\\"); // print single backslash
	LoggerAppsMsg(3,Main,Info,"\""); // print single duble qoute
	LoggerAppsMsg(3,Main,Info,"\'"); // print single qoute

	/** Example 6: Number of severity id=value pairs and length of value string.
		6y – Maximum number of severity levels is 4 and length of value is 16 characters.
	**/
	LoggerAppsMsg(3,Main,Info,"6y - Maximum number of severity levels is 4 and length of value is 16 characters.");

	/** Example 7: Number of logical message grouping id=value pairs and length of value string.
		7y – Maximum number of logical message groups is 32 and length of value is 16 characters.
	**/
	LoggerAppsMsg(3,Main,Info,"7y - Maximum number of logical message groups is 32 and length of value is 16 characters.");

	LoggerShutDown();

	return(0);
}