[ новости /+++ | форум | теги | ]

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,
     unsigned       int       follow_link,       FN_attrmodlist_t
     **unexecuted_mods, FN_status_t *status);

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.

     The value of follow_link determines what  happens  when  the
     terminal  atomic  part of name is bound to an  XFN link.  If
     follow_link is non-zero, such a link is  followed,  and  the
     values  of  the  attribute  associated  with the final named
     object are returned; if follow_link is zero, such a link  is
     not followed. Any  XFN links encountered before the terminal

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

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

RETURN VALUES
     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  modifica-
     tions.  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 (0) is
     returned in unexecuted_mods, that indicates no modifications
     were executed.

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe                     |
    |_____________________________|_____________________________|


SEE ALSO
     FN_attrmodlist_t(3XFN),           FN_composite_name_t(3XFN),
     FN_ctx_t(3XFN),   FN_status_t(3XFN),   fn_attr_modify(3XFN),
     xfn(3XFN),   xfn_attributes(3XFN),   xfn_status_codes(3XFN),
     attributes(5)

NOTES
     The implementation of XFN in this Solaris release  is  based
     on  the  X/Open preliminary specification. It is likely that
     there will be minor changes to these interfaces  to  reflect
     changes in the final version of this specification. The next
     minor release of Solaris will offer binary compatibility for
     applications  developed using the current interfaces. As the
     interfaces evolve toward  standardization,  it  is  possible
     that  future  releases  of Solaris will require minor source
     code  changes  to  applications  that  have  been  developed
     against the preliminary specification.

Партнёры:

Хостинг: