BOOTSTRAP (kutils) functions
LIBRARY ROUTINE
koverwrite - request an acknowledgement for overwriting files
LIBRARY CALL
int koverwrite(
int notify_type,
char *filename)
INPUT
- notify_type - the notify level specified by the programmer
KFORCE, KSTANDARD, KVERBOSSE
- filename - the filename in question to overwrite
OUTPUT
none
RETURN VALUE
TRUE if the prompt was successfully acknowledged,
otherwise if the message was not acknowledged FALSE
is returned. In the event of an error TRUE
is returned. If the file does not exist,
TRUE is returned.
DESCRIPTION
koverwrite will call the specified prompt handler
to request or demand an acknowledgement from the user.
This utility will as the user if it is ok to overwrite the
file in question, and can operate in several different modes.
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.