blank.gif (43 bytes)

Church Of The
Swimming Elephant

Search:
3.3.15 Procedure 15: LINK - Create Link to an object Connected: An Internet Encyclopedia
3.3.15 Procedure 15: LINK - Create Link to an object

Up: Connected: An Internet Encyclopedia
Up: Requests For Comments
Up: RFC 1813
Up: 3. Server Procedures
Up: 3.3. Procedure Descriptions
Prev: 3.3.14 Procedure 14: RENAME - Rename a File or Directory
Next: 3.3.16 Procedure 16: READDIR - Read From Directory

3.3.15 Procedure 15: LINK - Create Link to an object

3.3.15 Procedure 15: LINK - Create Link to an object

SYNOPSIS

      LINK3res NFSPROC3_LINK(LINK3args) = 15;

      struct LINK3args {
           nfs_fh3     file;
           diropargs3  link;
      };

      struct LINK3resok {
           post_op_attr   file_attributes;
           wcc_data       linkdir_wcc;
      };

      struct LINK3resfail {
           post_op_attr   file_attributes;
           wcc_data       linkdir_wcc;
      };

      union LINK3res switch (nfsstat3 status) {
      case NFS3_OK:
           LINK3resok    resok;
      default:
           LINK3resfail  resfail;
      };

DESCRIPTION

Procedure LINK creates a hard link from file to link.name, in the directory, link.dir. file and link.dir must reside on the same file system and server. On entry, the arguments in LINK3args are:

file

The file handle for the existing file system object.

link

The location of the link to be created:

link.dir

The file handle for the directory in which the link is to be created.

link.name

The name that is to be associated with the created link. Refer to General comments on filenames on page 17.

On successful return, LINK3res.status is NFS3_OK and LINK3res.resok contains:

file_attributes

The post-operation attributes of the file system object identified by file.

linkdir_wcc

Weak cache consistency data for the directory, link.dir.

Otherwise, LINK3res.status contains the error on failure and LINK3res.resfail contains the following:

file_attributes

The post-operation attributes of the file system object identified by file.

linkdir_wcc

Weak cache consistency data for the directory, link.dir.

IMPLEMENTATION

Changes to any property of the hard-linked files are reflected in all of the linked files. When a hard link is made to a file, the attributes for the file should have a value for nlink that is one greater than the value before the LINK.

The comments under RENAME regarding object and target residing on the same file system apply here as well. The comments regarding the target name applies as well. Refer to General comments on filenames on page 30.

ERRORS

NFS3ERR_IO NFS3ERR_ACCES NFS3ERR_EXIST NFS3ERR_XDEV NFS3ERR_NOTDIR NFS3ERR_INVAL NFS3ERR_NOSPC NFS3ERR_ROFS NFS3ERR_MLINK NFS3ERR_NAMETOOLONG NFS3ERR_DQUOT NFS3ERR_STALE NFS3ERR_BADHANDLE NFS3ERR_NOTSUPP NFS3ERR_SERVERFAULT

SEE ALSO SYMLINK, RENAME and FSINFO.


Next: 3.3.16 Procedure 16: READDIR - Read From Directory

Connected: An Internet Encyclopedia
3.3.15 Procedure 15: LINK - Create Link to an object

Cotse.Net

Protect yourself from cyberstalkers, identity thieves, and those who would snoop on you.
Stop spam from invading your inbox without losing the mail you want. We give you more control over your e-mail than any other service.
Block popups, ads, and malicious scripts while you surf the net through our anonymous proxies.
Participate in Usenet, host your web files, easily send anonymous messages, and more, much more.
All private, all encrypted, all secure, all in an easy to use service, and all for only $5.95 a month!

Service Details

 
.
www.cotse.com
Have you gone to church today?
.
All pages ©1999, 2000, 2001, 2002, 2003 Church of the Swimming Elephant unless otherwise stated
Church of the Swimming Elephant©1999, 2000, 2001, 2002, 2003 Cotse.com.
Cotse.com is a wholly owned subsidiary of Packetderm, LLC.

Packetderm, LLC
210 Park Ave #308
Worcester, MA 01609