Previous section.

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


NLM_TEST_RES - Test Lock Result

Call Arguments

struct nlm_testres { netobj cookie; nlm_testrply test_stat; };

Return Arguments


RPC Procedure Description

void NLM_TEST_RES(nlm_testres) = 11;


This procedure is one of the asynchronous RPCs. The server calls this procedure to return results of the NLM_TEST_MSG procedure to the client (the host issuing the NLM_TEST_MSG call).

"test_stat.stat" will be set to one of the following values:

Indicates that the "NLM_TEST_MSG" procedure completed successfully. The server would be able to grant the lock in question.

Indicates that the "NLM_TEST_MSG" failed as it conflicted with existing lock reservations for the file. "test_stat.holder" describes the current holder of the lock as follows. The boolean "exclusive" indicates whether the lock is exclusively held by the current holder, or whether other locks are permitted. The integer "uppid" provides a unique per-process identifier for lock differentiation. The unsigned values "l_offset" and "l_len" define the region of the file locked by this holder.


Indicates that the "NLM_TEST_MSG" failed because the server NLM could not allocate the resources needed to process the request.


Indicates that the "NLM_TEST_MSG" failed because the server host has recently been rebooted and its 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