[Go to CFHT Home Page] Man Pages
Back to Software Index  BORDER=0Manpage Top Level
    fn_ctx_lookup_link(3N) manual page Table of Contents

Name

fn_ctx_lookup_link - look up the link reference bound to a name

Synopsis

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


#include <xfn/xfn.h>

FN_ref_t *fn_ctx_lookup_link(FN_ctx_t *ctx, const FN_composite_name_t *name, FN_status_t *status);

MT-Level

MT-Safe

Description

This operation returns the XFN link bound to name. The terminal atomic part of name must be bound to an XFN link.

The normal fn_ctx_lookup(3N) operation follows all links encountered, including any bound to the terminal atomic part of name. This operation differs from the normal lookup in that when the terminal atomic part of name is an XFN link, this link is not followed, and the operation returns the link.

Return Values

If fn_ctx_lookup_link() fails, a NULL pointer (0) is returned.

Errors

fn_ctx_lookup_link() sets status as described in FN_status_t(3N) and xfn_status_codes(3N) . Of special relevance for fn_ctx_lookup_link() is the following status code:
FN_E_MALFORMED_LINK
name resolved to a reference that was not a link.

See Also

FN_composite_name_t(3N) , FN_ctx_t(3N) , FN_ref_t(3N) , FN_status_t(3N) , fn_ctx_lookup(3N) , xfn(3N) , xfn_links(3N) , xfn_status_codes(3N)

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.

Table of Contents