Annotation of embedaddon/ntp/ports/winnt/libntp/messages.h, revision 1.1.1.1
1.1 misho 1: /*
2: Microsoft Developer Support
3: Copyright (c) 1992 Microsoft Corporation
4:
5: This file contains the message definitions for the Win32
6: syslog support messages for the nntp firewall
7: -------------------------------------------------------------------------
8: HEADER SECTION
9:
10: The header section defines names and language identifiers for use
11: by the message definitions later in this file. The MessageIdTypedef,
12: SeverityNames, FacilityNames, and LanguageNames keywords are
13: optional and not required.
14:
15:
16:
17: The MessageIdTypedef keyword gives a typedef name that is used in a
18: type cast for each message code in the generated include file. Each
19: message code appears in the include file with the format: #define
20: name ((type) 0xnnnnnnnn) The default value for type is empty, and no
21: type cast is generated. It is the programmer's responsibility to
22: specify a typedef statement in the application source code to define
23: the type. The type used in the typedef must be large enough to
24: accomodate the entire 32-bit message code.
25:
26:
27:
28: The SeverityNames keyword defines the set of names that are allowed
29: as the value of the Severity keyword in the message definition. The
30: set is delimited by left and right parentheses. Associated with each
31: severity name is a number that, when shifted left by 30, gives the
32: bit pattern to logical-OR with the Facility value and MessageId
33: value to form the full 32-bit message code. The default value of
34: this keyword is:
35:
36: SeverityNames=(
37: Success=0x0
38: Informational=0x1
39: Warning=0x2
40: Error=0x3
41: )
42:
43: Severity values occupy the high two bits of a 32-bit message code.
44: Any severity value that does not fit in two bits is an error. The
45: severity codes can be given symbolic names by following each value
46: with :name
47:
48:
49: FacilityNames=(System=0x0:FACILITY_SYSTEM
50: Runtime=0x2:FACILITY_RUNTIME
51: Stubs=0x3:FACILITY_STUBS
52: Io=0x4:FACILITY_IO_ERROR_CODE
53: )
54:
55: The FacilityNames keyword defines the set of names that are allowed
56: as the value of the Facility keyword in the message definition. The
57: set is delimited by left and right parentheses. Associated with each
58: facility name is a number that, when shift it left by 16 bits, gives
59: the bit pattern to logical-OR with the Severity value and MessageId
60: value to form the full 32-bit message code. The default value of
61: this keyword is:
62:
63: FacilityNames=(
64: System=0x0FF
65: Application=0xFFF
66: )
67:
68: Facility codes occupy the low order 12 bits of the high order
69: 16-bits of a 32-bit message code. Any facility code that does not
70: fit in 12 bits is an error. This allows for 4,096 facility codes.
71: The first 256 codes are reserved for use by the system software. The
72: facility codes can be given symbolic names by following each value
73: with :name
74:
75:
76: The LanguageNames keyword defines the set of names that are allowed
77: as the value of the Language keyword in the message definition. The
78: set is delimited by left and right parentheses. Associated with each
79: language name is a number and a file name that are used to name the
80: generated resource file that contains the messages for that
81: language. The number corresponds to the language identifier to use
82: in the resource table. The number is separated from the file name
83: with a colon. The initial value of LanguageNames is:
84:
85: LanguageNames=(English=1:MSG00001)
86:
87: Any new names in the source file which don't override the built-in
88: names are added to the list of valid languages. This allows an
89: application to support private languages with descriptive names.
90:
91:
92: -------------------------------------------------------------------------
93: MESSAGE DEFINITION SECTION
94:
95: Following the header section is the body of the Message Compiler
96: source file. The body consists of zero or more message definitions.
97: Each message definition begins with one or more of the following
98: statements:
99:
100: MessageId = [number|+number]
101: Severity = severity_name
102: Facility = facility_name
103: SymbolicName = name
104:
105: The MessageId statement marks the beginning of the message
106: definition. A MessageID statement is required for each message,
107: although the value is optional. If no value is specified, the value
108: used is the previous value for the facility plus one. If the value
109: is specified as +number then the value used is the previous value
110: for the facility, plus the number after the plus sign. Otherwise, if
111: a numeric value is given, that value is used. Any MessageId value
112: that does not fit in 16 bits is an error.
113:
114: The Severity and Facility statements are optional. These statements
115: specify additional bits to OR into the final 32-bit message code. If
116: not specified they default to the value last specified for a message
117: definition. The initial values prior to processing the first message
118: definition are:
119:
120: Severity=Success
121: Facility=Application
122:
123: The value associated with Severity and Facility must match one of
124: the names given in the FacilityNames and SeverityNames statements in
125: the header section. The SymbolicName statement allows you to
126: associate a C/C++ symbolic constant with the final 32-bit message
127: code.
128: */
129: //
130: // Values are 32 bit values laid out as follows:
131: //
132: // 3 3 2 2 2 2 2 2 2 2 2 2 1 1 1 1 1 1 1 1 1 1
133: // 1 0 9 8 7 6 5 4 3 2 1 0 9 8 7 6 5 4 3 2 1 0 9 8 7 6 5 4 3 2 1 0
134: // +---+-+-+-----------------------+-------------------------------+
135: // |Sev|C|R| Facility | Code |
136: // +---+-+-+-----------------------+-------------------------------+
137: //
138: // where
139: //
140: // Sev - is the severity code
141: //
142: // 00 - Success
143: // 01 - Informational
144: // 10 - Warning
145: // 11 - Error
146: //
147: // C - is the Customer code flag
148: //
149: // R - is a reserved bit
150: //
151: // Facility - is the facility code
152: //
153: // Code - is the facility's status code
154: //
155: //
156: // Define the facility codes
157: //
158:
159:
160: //
161: // Define the severity codes
162: //
163: #define STATUS_SEVERITY_WARNING 0x2
164: #define STATUS_SEVERITY_SUCCESS 0x0
165: #define STATUS_SEVERITY_INFORMATIONAL 0x1
166: #define STATUS_SEVERITY_ERROR 0x3
167:
168:
169: //
170: // MessageId: NTP_ERROR
171: //
172: // MessageText:
173: //
174: // %1
175: //
176: #define NTP_ERROR ((DWORD)0xC0000001L)
177:
178: //
179: // MessageId: NTP_WARNING
180: //
181: // MessageText:
182: //
183: // %1
184: //
185: //
186: #define NTP_WARNING ((DWORD)0x80000002L)
187:
188: //
189: // MessageId: NTP_INFO
190: //
191: // MessageText:
192: //
193: // %1
194: //
195: //
196: //
197: //
198: #define NTP_INFO ((DWORD)0x40000003L)
199:
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>