NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | ATTRIBUTES | SEE ALSO | NOTES
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);
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(3XFN) 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.
If fn_ctx_lookup_link() fails, a NULL pointer (0) is returned.
fn_ctx_lookup_link() sets status as described in FN_status_t(3XFN) and xfn_status_codes(3XFN). Of special relevance for fn_ctx_lookup_link() is the following status code:
name resolved to a reference that was not a link.
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE | ATTRIBUTE VALUE |
---|---|
MT-Level | MT-Safe |
FN_composite_name_t(3XFN), FN_ctx_t(3XFN), FN_ref_t(3XFN), FN_status_t(3XFN), fn_ctx_lookup(3XFN), xfn(3XFN), xfn_links(3XFN), xfn_status_codes(3XFN), attributes(5)
The Federated Naming Service based on the X/Open XFN standard might not be supported in a future release of the Solaris operating system.
NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | ATTRIBUTES | SEE ALSO | NOTES