.\" pragma ident "@(#)KcsModifyLoadHints.3	1.3  04/21/95"
.TH KcsAvailable 3 "21 April 1995" "" "KCMS Library"
.SH NAME
KcsModifyLoadHints \- Apply a new set of load hints to a profile
.SH SYNOPSIS
.ft B
.nf
#include <kcms/kcs.h>
#include <kcms/kcstypes.h>
.sp
KcsStatusId KcsModifyLoadHints(
			KcsProfileId	profile, 
			KcsLoadHints	newHints)
.fi
.ft R
.SH MT-LEVEL
MT-Unsafe
.SH DESCRIPTION
.B KcsModifyLoadHints() 
applies a new set of load hints to a 
loaded profile. If something is specified as happening 
immediately, the KCMS framework attempts to perform the 
operation before returning. For example, if you no longer need to 
use the simulate functionality of a profile and memory is 
becoming tight, you can use this function to unload the simulate 
part of the profile immediately, making more memory available 
for the application.
.SH ARGUMENTS
.TP
.SB profile
The identifier of a loaded profile.
.TP
.SB newHints
The set of bits describing what/how/when/where to 
load/unload profile. 
.SH RETURN VALUES
Upon successful completion KCS_SUCCESS is returned. Otherwise
one of the following errors will be returned.
.SH ERRORS
.nf
KCS_PROF_ID_BAD
KCS_MEM_ALLOC_ERROR
.fi
.SH SEE ALSO
.BR KcsLoadProfile (3)
.br
.BR "KCMS Application Developers Guide"
.SH NOTE
Remember that the load hints are just that-hints to the KCMS 
framework. Although the KCMS framework will try its best to accomplish 
what is specified, and typically does, it cannot guarantee that it can do 
everything exactly as hinted.
.SH EXAMPLE
.nf
KcsProfileId 		profileid;
KcsErrDesc		errDesc;
KcsProfileDesc		profileDesc;
KcsProfileId 		profile;
KcsStatusId		status;
KcsLoadHints		newhints;

/* profile name is a command line argument */

profileDesc.type = KcsSolarisProfile;
profileDesc.desc.Solarisfile.fileName = argv[1];
profileDesc.desc.Solarisfile.hostName = NULL;
profileDesc.desc.Solarisfile.mode = 0;
profileDesc.desc.Solarisfile.oflag = NULL;

status = KcsLoadProfile(&profile, &profileDesc, KcsLoadAttributesNow);
if (status != KCS_SUCCESS) {
	status = KcsGetLastError(&errDesc);
	fprintf(stderr,"%s KcsLoadProfile failed error = %s\\n",
			argv[optind], errDesc.desc);
	exit(1);
}

/* suppose it was determined that this is the profile we want to *
 * use for evaluating data. We want to load it all in now. */

newhints = KcsLoadAllNow;
status = KcsModifyLoadHints(profile, newhints);
if (status != KCS_SUCCESS) {
	status = KcsGetLastError(&errDesc);
	fprintf(stderr," ModifyHints failed error = %s\\n", errDesc.desc);
	exit(1);
}
.fi