.\" pragma ident "@(#)KcsSetAttribute.3	1.3  04/21/95"
.TH KcsSetAttribute 3 "21 April 1995" "" "KCMS Library"
.SH NAME
KcsSetAttribute \- Set or modify an attribute in a profile
.SH SYNOPSIS
.ft B
.nf
#include <kcms/kcs.h>
#include <kcms/kcstypes.h>
#include <kcms/icc.h>
.sp
KcsStatusId KcsSetAttribute(
		KcsProfileId		profile, 
		KcsAttributeName	name,
		KcsAttributeValue	*value)
.fi
.ft R
.SH MT-LEVEL
MT-Unsafe
.SH DESCRIPTION
Use 
.B KcsSetAttribute()
to create, to modify, or to delete a specific attribute in a profile. 
.SH ARGUMENTS
.TP
.SB profile
The identifier to the profile.
.TP
.SB name
The attribute to be created, modified, or deleted. If this attribute 
is already used in the profile, this function overwrites its value. If 
this attribute does not already exist, the function creates it.  Name
is an 
.B icTagSignature
as listed in the 
.B icc.h 
header file. 
.TP
.SB value
A pointer to the value for the attribute. If the attribute already 
exists, then 
.B value 
becomes the attribute's new value. If the 
attribute does not already exist, this function creates it and sets 
its original value to 
.B value. 
To delete an existing attribute, set 
.B value 
to 
.B NULL.
.SH RETURN VALUES
Upon successful completion KCS_SUCCESS is returned. Otherwise
one of the following errors will be returned.
.SH ERRORS
.nf
KCS_MEM_ALLOC_ERROR
KCS_PROF_ID_BAD
KCS_ATTR_NAME_OUT_OF_RANGE
KCS_ATTR_TYPE_UNKNOWN
KCS_ATTR_NEG_CT_SUPPLIED
KCS_ATTR_LARGE_CT_SUPPLIED (warning)
.fi
.SH SEE ALSO
.BR KcsCreateProfile (3)
.BR KcsLoadProfile (3)
.BR KcsModifyLoadHints (3)
.BR KcsSaveProfile (3)
.BR KcsUpdateProfile (3)
.br
.BR "KCMS Application Developers Guide"
.SH NOTE
For this function to execute correctly, you must check what needs to be 
set in the KcsAttributeBase structure (part of the KcsAttributeValue 
structure) a valid type and number of tokens found in the attribute.
.PP
icSigAtoB[0-2]Tag, icSigBToA[0-2]Tag, and icSigGamutTag are considered 
transforms by the KCMS library and are not valid values for name.