BOOTSTRAP (kutils) functions


LIBRARY ROUTINE

kinfo - print information messages in a standardized format

LIBRARY CALL

int kinfo(
   int  notify_type,
   char *format,
   kvalist)

INPUT

OUTPUT

none

RETURN VALUE

TRUE if the message was successfully printed, otherwise FALSE is returned.

DESCRIPTION

kinfo produces standardized information messages for Khoros library routines and Khoros applications. It should be called in EVERY instance of information messaging by EVERY Khoros function, subroutine, or main program.

If the notify_type variable is set to KFORCE, then the prompt will always appear regardless of the setting of the environment variable KHOROS_NOTIFY.

If the notify_type variable is set to KSTANDARD and the user has the environment variable KHOROS_NOTIFY set to either STANDARD or VERBOSE the prompt will appear.

And finally, if the notify_type variable is set to KVERBOSE and the environment variable KHOROS_NOTIFY set to VERBOSE, the prompt will appear.

Here is a summary table:

notify_type = FORCE always prompt, ignore the setting of the environment variable KHOROS_NOTIFY

notify_type = STANDARD only prompt when the environment variable KHOROS_NOTIFY is set to STANDARD or VERBOSE.

notify_type = VERBOSE only prompt when the environment variable KHOROS_NOTIFY is set to VERBOSE

ADDITIONAL INFORMATION

none

EXAMPLES

none

SIDE EFFECTS

none

RESTRICTIONS

none

MODIFICATION

none

FILES

$BOOTSTRAP/objects/library/kutils/src/notify.c

SEE ALSO

kutils(3)

COPYRIGHT

Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.