Name

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;

Description

Creates the file to.name 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

NFS_OK

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

NFSERR_PERM

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

NFSERR_IO

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

NFSERR_ACCES

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

NFSERR_EXIST

File exists. The file specified already exists.

NFSERR_NOTDIR

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

NFSERR_NOSPC

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

NFSERR_ROFS

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

NFSERR_NAMETOOLONG

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

NFSERR_DQUOT

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

NFSERR_STALE

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.