NAME

fn_attr_multi_modify − modify multiple attributes associated with named object

SYNOPSIS

cc [ flag ... ] file ... −lxfn [ library ... ]

#include <xfn/xfn.h>

int fn_attr_multi_modify(FN_ctx_t ∗ctx, const FN_composite_name_t ∗name,

const FN_attrmodlist_t ∗mods, FN_attrmodlist_t ∗∗unexecuted_mods,

FN_status_t ∗status);

MT-LEVEL

Safe. 

DESCRIPTION

This operation modifies the attributes associated with the object named name relative to ctx.  If name is empty, the attributes associated with ctx are modified. 

In the mods parameter, the caller specifies a sequence of modifications that are to be done in order on the attributes.  Each modification in the sequence specifies a modification operation code (see fn_attr_modify(3N)) and an attribute on which to operate. 

The FN_attrmodlist_t type is described in FN_attrmodlist_t(3N). 

RETURN VALUE

fn_attr_multi_modify() returns 1 if all the modification operations were performed successfully.  The function returns 0 if it any error occurs.  If the operation fails, status and unexecuted_mods are set as described below. 

ERRORS

If an error is encountered while performing the list of modifications, status indicates the type of error and unexecuted_mods is set to a list of unexecuted modifications.  The contents of unexecuted_mods do not share any state with mods; items in unexecuted_mods are copies of items in mods and appear in the same order in which they were originally supplied in mods.  The first operation in unexecuted_mods is the first one that failed and the code in status applies to this modification operation in particular.  If status indicates failure and a NULL pointer is returned in unexecuted_mods, that indicates no modifications were executed. 

SEE ALSO

FN_attrmodlist_t(3N), FN_composite_name_t(3N), FN_ctx_t(3N), FN_status_t(3N), fn_attr_modify(3N), xfn_attributes(3N), xfn_status_codes(3N), xfn(3N)

SunOS 5.5  —  Last change: 4 Nov 1994