Previous section.

Protocols for Interworking: XNFS, Version 3W
Copyright © 1998 The Open Group


NLM_CANCEL - Cancel Lock

Call Arguments

struct nlm_cancargs { netobj cookie; bool block; bool exclusive; struct nlm_lock alock; };

Return Arguments

struct nlm_res { netobj cookie; nlm_stat stat; };

RPC Procedure Description

nlm_res NLM_CANCEL(nlm_cancargs) = 3;


This procedure cancels an outstanding blocked lock request.

If the client made an NLM_LOCK procedure with "nlm_lockargs.block" set to true, and the procedure was blocked by the server (that is, the procedure returned a status of "LCK_BLOCKED"), the client can choose to cancel this outstanding lock request by using this procedure.

The "block", "exclusive" and "alock" arguments must exactly match the corresponding arguments to the NLM_LOCK procedure.

Return Codes

When the procedure returns, "stat" will be set to one of the following values:

Indicates that the procedure completed successfully. The NLM may also return this code even if the "alock.oh" of the NLM_CANCEL procedure call does not match that of the outstanding lock request, or if there is no matching outstanding lock request.

Indicates that the procedure failed possibly because there was no lock to cancel.


Indicates that the procedure failed because the server host has recently been rebooted and the server NLM is re-establishing existing locks, and is not yet ready to accept normal service requests.

Why not acquire a nicely bound hard copy?
Click here to return to the publication details or order a copy of this publication.

Contents Next section Index