Previous section.

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


NFSPROC_LINK - Create Link to File

Call Arguments

struct linkargs { fhandle from; diropargs to; };

fhandle and diropargs are defined in Basic Data Types .

Return Arguments

stat status;

stat is defined in Basic Data Types .

RPC Procedure Description

stat NFSPROC_LINK(linkargs) = 12;


Creates the file in the directory given by to.dir, which is a hard link to the existing file given by from. If the return value is NFS_OK, a link was created. Any other return value indicates an error, and the link was not created.

Note that this is generally a non-idempotent operation. A server should attempt to provide this function in an idempotent fashion.

Return Codes

Indicates that the call completed successfully and the results are valid.

Not owner. The caller does not have correct ownership to perform the requested operation.

Some sort of hard error occurred when the operation was in progress. This could be a disk error, for example.

Permission denied. The caller does not have the correct permission to perform the requested operation.

File exists. The file specified already exists.

Not a directory. The caller specified a non-directory in a directory operation.

No space left on device. The operation caused the server's file system to reach its limit.

Read-only file system. Write attempted on a read-only file system.


File name too long. The filename in an operation was too long.

Disk quota exceeded. The client's disk quota on the server has been exceeded.

The fhandle given in the arguments was invalid. That is, the file referred to by that file handle no longer exists, or access to it has been revoked.

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