vsyslog()

log an event message using variable argument list 

Function

SYNOPSIS

#include <syslog.h>

#include <varargs.h>

vsyslog(int priority, char *message, va_list ap);

DESCRIPTION

The vsyslog() function is the same as the syslog() function except that instead of being called with a variable number of arguments, it is called with an argument list defined by <stdarg.h>.

PARAMETERS

priority 

Is encoded within the NuTCRACKER Platform to reflect the Microsoft Win32 event type. The UNIX priority is translated as follows:

LOG_EMERG 

An error event. This priority logs the event as a Win32 error event and displays the alert box containing the message on the screen. The process is terminated when the user selects OK in the dialog box.

LOG_ALERT, LOG_CRIT, LOG_ERR 

An error event. This priority logs the event as a Win32 error event and returns control to the calling process.

LOG_WARNING 

A warning event. This priority logs the event as a Win32 warning event and returns control to the calling process.

LOG_NOTICE, LOG_INFO, LOG_DEBUG 

An information event. This priority logs the event as a Win32 information event and returns control to the calling process.

message 

Is used with the following arguments to generate the message body in the same manner as if these were arguments to printf(), except that occurrences of %m in the format string pointed to by the message argument are replaced by the error messages string associated with the current value of errno. A trailing newline character is added if needed.

vp 

Arguments previously captured by the variable-length argument facilities of va_arg(), va_start(), and va_end().

RETURN VALUES

None.

CONFORMANCE

4.4BSD.

MULTITHREAD SAFETY LEVEL

MT-Safe.

PORTING ISSUES

On 8.1/2012R2/10/2016/2019/11/2022, messages are logged in the system's Application Event log. The ident string passed to openlog() is used as the Event Source name. The priority passed to vsyslog() is used as the event priority. You can use the Windows Event Viewer to display the Application Event log.

On Windows 95/98, messages are logged to the file ident.log.txt in the logs subdirectory of the NuTCRACKER Platform installation directory, where ident is the parameter as passed to openlog().

AVAILABILITY

PTC MKS Toolkit for Professional Developers
PTC MKS Toolkit for Professional Developers 64-Bit Edition
PTC MKS Toolkit for Enterprise Developers
PTC MKS Toolkit for Enterprise Developers 64-Bit Edition

SEE ALSO

Functions:
closelog(), openlog(), setlogmask(), syslog()

PTC MKS Toolkit 10.4 Documentation Build 39.