blank.gif (43 bytes)

Church Of The
Swimming Elephant

Search:
3.3.9 Procedure 9: MKDIR - Create a directory Connected: An Internet Encyclopedia
3.3.9 Procedure 9: MKDIR - Create a directory

Up: Connected: An Internet Encyclopedia
Up: Requests For Comments
Up: RFC 1813
Up: 3. Server Procedures
Up: 3.3. Procedure Descriptions
Prev: 3.3.8 Procedure 8: CREATE - Create a file
Next: 3.3.10 Procedure 10: SYMLINK - Create a symbolic link

3.3.9 Procedure 9: MKDIR - Create a directory

3.3.9 Procedure 9: MKDIR - Create a directory

SYNOPSIS

      MKDIR3res NFSPROC3_MKDIR(MKDIR3args) = 9;

      struct MKDIR3args {
           diropargs3   where;
           sattr3       attributes;
      };

      struct MKDIR3resok {
           post_op_fh3   obj;
           post_op_attr  obj_attributes;
           wcc_data      dir_wcc;
      };

      struct MKDIR3resfail {
           wcc_data      dir_wcc;
      };

      union MKDIR3res switch (nfsstat3 status) {
      case NFS3_OK:
           MKDIR3resok   resok;
      default:
           MKDIR3resfail resfail;
      };

DESCRIPTION

Procedure MKDIR creates a new subdirectory. On entry, the arguments in MKDIR3args are:

where

The location of the subdirectory to be created:

dir

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

name

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

attributes

The initial attributes for the subdirectory.

On successful return, MKDIR3res.status is NFS3_OK and the results in MKDIR3res.resok are:

obj

The file handle for the newly created directory.

obj_attributes

The attributes for the newly created subdirectory.

dir_wcc

Weak cache consistency data for the directory, where.dir. For a client that requires only the post-MKDIR directory attributes, these can be found in dir_wcc.after.

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

dir_wcc

Weak cache consistency data for the directory, where.dir. For a client that requires only the post-MKDIR directory attributes, these can be found in dir_wcc.after. Even though the MKDIR failed, full wcc_data is returned to allow the client to determine whether the failing MKDIR resulted in any change to the directory.

IMPLEMENTATION

Many server implementations will not allow the filenames, "." or "..", to be used as targets in a MKDIR operation. In this case, the server should return NFS3ERR_EXIST. Refer to General comments on filenames on page 30.

ERRORS

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

SEE ALSO CREATE, SYMLINK, MKNOD, and PATHCONF.


Next: 3.3.10 Procedure 10: SYMLINK - Create a symbolic link

Connected: An Internet Encyclopedia
3.3.9 Procedure 9: MKDIR - Create a directory

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