AT&T UNIX™PC Unix System V Users Manual - tenox

EPRINTF ( 3T ) ( AT&T UNIX PC only ) EPRINTF ( 3T )
NAME
eprintf - send a message to the status manager
SYNOPSIS
#include
int eprintf (mtype, mact, uname, format [, arg ] ... )
int mtype, mact;
char * uname, *format;
DESCRIPTION
Eprintf formats the passed message a Ia print! and writes the message
to the error device. The status manager wakes up whenever
the error device is written to, queues the message, and displays an
icon to indicate a message is waiting.
Mtype (message type) can have one of the following values:
ST_MAIL Mail messages
ST_CAL Calendar messages
ST_OTHER Miscellaneous messages
ST_SYS Kernel error messages
ST_LOG Log message in log file
ST_POP Popup message
Mact (message action) can have one of the following values:
ST_DISPLA Y Just display message
ST_EXEC Execute process (message text is shell
command line in this case)
ST_NOTIFY Notify caller on display (sends caller
SIGUSR1)
ST_CONFIRM Signal caller with confirmation/denial
on display (SIGUSR1 = Yes, SIGUSR2
=No)
ST_OFF Remove messages from queue
ST_LOGFILE Log message in log file
Uname points to the user login name that the message is for. The
status manager will only display the message pending icon when
this user is logged in. If una me is NULL (or if it points to a null
�tring), then the message is displayed regardless of who is logged
Ill .
ST_POP will cause the message to be acted on immediately,
rather than displaying an icon and waiting for the user to click.
ST_LOG will take the first word of the formatted message (i.e.,
up to the first space) as a file name, which it will open as a logfile
in /usr/adm. The rest of the message will then be inserted in
the file, followed by a time stamp.
DIAGNOSTICS
Eprintf returns -1 if error (open of error device failed).
SEE ALSO
message (3T), tam(3T).
- 1 -