The OpenNET Project / Index page

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

Интерактивная система просмотра системных руководств (man-ов)

 ТемаНаборКатегория 
 
 [Cписок руководств | Печать]

fn_status_set (3)
  • >> fn_status_set (3) ( Solaris man: Библиотечные вызовы )
  • 
    NAME
         FN_status_t,      fn_status_create,       fn_status_destroy,
         fn_status_copy,       fn_status_assign,      fn_status_code,
         fn_status_remaining_name,           fn_status_resolved_name,
         fn_status_resolved_ref,        fn_status_diagnostic_message,
         fn_status_link_code,          fn_status_link_remaining_name,
         fn_status_link_resolved_name,   fn_status_link_resolved_ref,
         fn_status_link_diagnostic_message,     fn_status_is_success,
         fn_status_set_success,   fn_status_set,  fn_status_set_code,
         fn_status_set_remaining_name,   fn_status_set_resolved_name,
         fn_status_set_resolved_ref,
         fn_status_set_diagnostic_message,   fn_status_set_link_code,
         fn_status_set_link_remaining_name,
         fn_status_set_link_resolved_name,
         fn_status_set_link_resolved_ref,
         fn_status_set_link_diagnostic_message,
         fn_status_append_resolved_name,
         fn_status_append_remaining_name,  fn_status_advance_by_name,
         fn_status_description - an XFN status object
    
    SYNOPSIS
         cc [ flag ... ] file ... -lxfn [ library ... ]
         #include <xfn/xfn.h>
    
         FN_status_t *fn_status_create(void);
    
         void fn_status_destroy(FN_status_t *stat);
    
         FN_status_t *fn_status_copy(const FN_status_t *stat);
    
         FN_status_t   *fn_status_assign(FN_status_t   *dst,    const
         FN_status_t *src);
    
         unsigned int fn_status_code(const FN_status_t *stat);
    
         const                                    FN_composite_name_t
         *fn_status_remaining_name(constFN_status_t *stat);
    
         const                                    FN_composite_name_t
         *fn_status_resolved_name(constFN_status_t *stat);
    
         const   FN_ref_t    *fn_status_resolved_ref(constFN_status_t
         *stat);
    
         const                                            FN_string_t
         *fn_status_diagnostic_message(constFN_status_t *stat);
    
         unsigned int fn_status_link_code(const FN_status_t *stat);
    
         const                                    FN_composite_name_t
         *fn_status_link_remaining_name(constFN_status_t *stat);
    
         const                                    FN_composite_name_t
         *fn_status_link_resolved_name(constFN_status_t *stat);
    
         const FN_ref_t *fn_status_link_resolved_ref(constFN_status_t
         *stat);
    
         const                                            FN_string_t
         *fn_status_link_diagnostic_message(constFN_status_t *stat);
    
         int fn_status_is_success(const FN_status_t *stat);
    
         int fn_status_set_success(FN_status_t *stat);
    
         int  fn_status_set(FN_status_t  *stat,  unsigned  int  code,
         const   FN_ref_t  *resolved_ref,  const  FN_composite_name_t
         *resolved_name, const FN_composite_name_t *remaining_name);
    
         int  fn_status_set_code(FN_status_t  *stat,   unsigned   int
         code);
    
         int  fn_status_set_remaining_name(FN_status_t  *stat,  const
         FN_composite_name_t *name);
    
         int  fn_status_set_resolved_name(FN_status_t  *stat,   const
         FN_composite_name_t *name);
    
         int  fn_status_set_resolved_ref(FN_status_t   *stat,   const
         FN_ref_t *ref);
    
         int   fn_status_set_diagnostic_message(FN_status_t    *stat,
         const FN_string_t *msg);
    
         int fn_status_set_link_code(FN_status_t *stat, unsigned  int
         code);
    
         int   fn_status_set_link_remaining_name(FN_status_t   *stat,
         const FN_composite_name_t *name);
    
         int   fn_status_set_link_resolved_name(FN_status_t    *stat,
         const FN_composite_name_t *name);
    
         int fn_status_set_link_resolved_ref(FN_status_t *stat, const
         FN_ref_t *ref);
    
         int fn_status_set_link_diagnostic_message(FN_status_t *stat,
         const FN_string_t *msg);
    
         int fn_status_append_resolved_name(FN_status_t *stat,  const
         FN_composite_name_t *name);
    
         int fn_status_append_remaining_name(FN_status_t *stat, const
         FN_composite_name_t *name);
         int   fn_status_advance_by_name(FN_status_t   *stat,   const
         FN_composite_name_t *prefix, const FN_ref_t *resolved_ref);
    
         FN_string_t *fn_status_description(const FN_status_t  *stat,
         unsigned int detail, unsigned int *more_detail);
    
    DESCRIPTION
         The result status of operations in the context interface and
         the  attribute  interface  is encapsulated in an FN_status_t
         object.  This object  contains  information  about  how  the
         operation completed: whether an error occurred in performing
         the operation, the nature of  the   error,  and  information
         that  helps  locate  where  the error occurred.  In the case
         that the error occurred while resolving  an  XFN  link,  the
         status  object  contains  additional  information about that
         error.
    
         The context status  object  consists  of  several  items  of
         information:
    
         primary status code
               An unsigned int code describing the disposition of the
               operation.
    
         resolved name
               In the case of a failure during the  resolution  phase
               of  the  operation, this is the leading portion of the
               name that was resolved successfully.   Resolution  may
               have  been successful beyond this point, but the error
               might not be pinpointed further.
    
         resolved reference
               The reference to which resolution was  successful  (in
               other  words, the reference to which the resolved name
               is bound).
    
         remaining name
               The remaining unresolved portion of the name.
    
         diagnostic message
               This contains any diagnostic message returned  by  the
               context implementation. This message provides the con-
               text implementation a way of notifying the end-user or
               administrator  of any implementation-specific informa-
               tion related to the returned error status.  The  diag-
               nostic  message  could then be used by the end-user or
               administrator  to take appropriate out-of-band  action
               to rectify the problem.
    
         link status code
               In the case that an error occurred while resolving  an
               XFN link, the primary status code has the value
                FN_E_LINK_ERROR and the link  status  code  describes
               the error that occurred while resolving the XFN link.
    
         resolved link name
               In the  case  of  a  link  error,  this  contains  the
               resolved portion of the name in the XFN link.
    
         resolved link reference
               In the case of a link error, this contains the  refer-
               ence to which the resolved link name is bound.
    
         remaining link name
               In the case of a link error, this contains the remain-
               ing unresolved portion of the name in the XFN link.
    
         link diagnostic message
               In the case of a link error, this  contains any  diag-
               nostic message related to the resolution of the link.
    
         Both the primary status code and the link  status  code  are
         values  of  type   unsigned int that are drawn from the same
         set of meaningful values. XFN reserves the values 0  through
         127  for  standard meanings.  The values and interpretations
         for   the    codes    are    determined    by    XFN.    See
         xfn_status_codes(3XFN).
    
         fn_status_create()  creates  a  status  object  with  status
         FN_SUCCESS. fn_status_destroy() releases the storage associ-
         ated with stat.  fn_status_copy()  returns  a  copy  of  the
         status  object  stat. fn_status_assign() makes a copy of the
         status object src and assigns it to dst, releasing  any  old
         contents  of  dst.  A  pointer  to the same object as dst is
         returned.
    
         fn_status_code()     returns      the      status      code.
         fn_status_remaining_name()  returns  the  remaining  part of
         name to be resolved. fn_status_resolved_name()  returns  the
         part   of   the  composite  name  that  has  been  resolved.
         fn_status_resolved_ref()  returns  the  reference  to  which
         resolution   was   successful.  fn_status_diagnostic_message
         returns any diagnostic message set by the context  implemen-
         tation.
    
         fn_status_link_code()  returns   the   link   status   code.
         fn_status_link_remaining_name()  returns  the remaining part
         of   the   link   name   that   has   not   been   resolved.
         fn_status_link_resolved_name()  returns the part of the link
         name that has been  resolved.  fn_status_link_resolved_ref()
         returns  the  reference  to which resolution of the link was
         successful. fn_status_link_diagnostic_message() returns  any
         diagnostic  message set by the context implementation during
         resolution of the link.
         fn_status_is_success() returns 1  if  the  status  indicates
         success, 0 otherwise.
    
         fn_status_set_success() sets the status code to   FN_SUCCESS
         and clears all other parts of stat. fn_status_set() sets the
         non-link   contents   of    the    status    object    stat.
         fn_status_set_code()  sets  the primary status code field of
         the status object stat. fn_status_set_remaining_name()  sets
         the  remaining  name part of the status object stat to name.
         fn_status_set_resolved_name() sets the resolved name part of
         the  status  object stat to name. fn_status_set_resolved_ref
         () sets the resolved reference part of the status objectstat
         to ref. fn_status_set_diagnostic_message() sets the diagnos-
         tic message part of the status object to
          msg.
    
         fn_status_set_link_code() sets the link status code field of
         the  status  object  stat  to indicate why resolution of the
         link failed.  fn_status_set_link_remaining_name()  sets  the
         remaining  link name part of the status object stat to name.
         fn_status_set_link_resolved_name() sets  the  resolved  link
         name   part   of   the   status   object   stat   to   name.
         fn_status_set_link_resolved_ref()  sets  the  resolved  link
         reference   part   of   the   status  object  stat  to  ref.
         fn_status_set_link_diagnostic_message() sets the link  diag-
         nostic message part of the status object to
          msg.
    
         fn_status_append_resolved_name() appends as additional  com-
         ponents  name to the resolved name part of the status object
         stat.  fn_status_append_remaining_name()  appends  as  addi-
         tional  components  name  to  the remaining name part of the
         status object stat. fn_status_advance_by_name() removes pre-
         fix  from the remaining name, and appends it to the resolved
         name.  The resolved reference part is set  to  resolved_ref.
         This  operation returns 1 on success, 0 if the prefix is not
         a prefix of the remaining name.
    
    RETURN VALUES
         The  fn_status_set_*() operations return 1 if the  operation
         succeeds, 0 if the operation fails.
    
    ATTRIBUTES
         See attributes(5) for descriptions of the  following  attri-
         butes:
    
         ____________________________________________________________
        |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
        |_____________________________|_____________________________|
        | MT-Level                    | MT-Safe                     |
        |_____________________________|_____________________________|
    
    SEE ALSO
         FN_composite_name_t(3XFN),                   FN_ref_t(3XFN),
         FN_string_t(3XFN), xfn(3XFN), xfn_status_codes(3XFN), attri-
         butes(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.
    
    
    
    


    Поиск по тексту MAN-ов: 




    Партнёры:
    PostgresPro
    Inferno Solutions
    Hosting by Hoster.ru
    Хостинг:

    Закладки на сайте
    Проследить за страницей
    Created 1996-2024 by Maxim Chirkov
    Добавить, Поддержать, Вебмастеру