NAME
fn_ctx_unbind - unbind a name from a context
SYNOPSIS
cc [ flag ... ] file ... -lxfn [ library ... ]
#include <xfn/xfn.h>
int fn_ctx_unbind(FN_ctx_t *ctx, const FN_composite_name_t
*name, FN_status_t *status);
DESCRIPTION
This operation removes the terminal atomic name in name from
the the target context - that named by all but the terminal
atomic part of name.
This operation is successful even if the terminal atomic
name was not bound in target context, but fails if any of
the intermediate names are not bound. fn_ctx_unbind() is
idempotent.
RETURN VALUE
The operation returns 1 if successful, and 0 otherwise.
ERRORS
fn_ctx_unbind() sets status as described in FN_status_t
and xfn_status_codes (3XFN).
Certain naming systems may disallow unbinding a name if the
name is bound to an existing context in order to avoid
orphan contexts that cannot be reached via any name. In
such situations, the status code
FN_E_OPERATION_NOT_SUPPORTED is returned.
APPLICATION USAGE
In naming systems that support attributes, and store the
attributes along with the names, the unbind operation
removes the name and its associated attributes.
Normal resolution always follows links. In an
fn_ctx_unbind() operation, resolution of name continues to
the target context; the terminal atomic name is not
resolved. If the terminal atomic name is bound to a link,
the link is not followed and the link itself is unbound from
the terminal atomic name.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| MT-Level | Safe. |
|_____________________________|_____________________________|
SEE ALSO
FN_composite_name_t(3XFN), FN_ctx_t(3XFN), FN_ref_t(3XFN),
FN_status_t(3XFN), fn_ctx_bind(3XFN), fn_ctx_lookup(3XFN),
xfn_status_codes(3XFN), xfn(3XFN), attributes(5)
|
Закладки на сайте Проследить за страницей |
Created 1996-2025 by Maxim Chirkov Добавить, Поддержать, Вебмастеру |