Full text search
function	FS_MakeDirectory

Library: File System Utilities Include: omfsys.xin

Declaration

  define external function FS_MakeDirectory
                  value      stream  path
     with         value      counter mode
     status       modifiable stream  statusvalue 

This function creates a new directory on a file system.

Input arguments:

• "path" is the name of the new directory.
• "mode" is the desired permissions mode for the new directory. It may be any combination of the following:
  • "020#0" -- enable mandatory file/record locking if "#" is 6, 4, 2, or 0 (zero)
  • "00700" -- give file owner read, write, and execute permissions
  • "00400" -- give file owner read permission
  • "00200" -- give file owner write permission
  • "00100" -- give file owner execute permission
  • "00070" -- give group read, write, and execute permissions
  • "00040" -- give group read permission
  • "00020" -- give group write permission
  • "00010" -- give group execute permission
  • "00007" -- give others read, write, and execute permissions
  • "00004" -- give others read permission
  • "00002" -- give others write permission
  • "00001" -- give others execute permission

Output argument:

• "statusvalue". This will contain either a zero length string if the function succeeds, or one of the following error codes in the current item:
  • "EACCES" -- the user does not have sufficient permission for the path
  • "EEXIST" -- the directory already exists
  • "EIO" -- a file system I/O error occurred
  • "ELOOP" -- (UNIX only) a link recursion was detected
  • "EMLINK" -- the maximum number of links to the parent directory would be exceeded
  • "EMULTIHOP" -- (UNIX only) remote machine access is required, but not allowed
  • "ENAMETOOLONG" -- the path name exceeds system limits
  • "ENOENT" -- the specified path does not exist
  • "ENOLINK" -- (UNIX only) a required link to a remote machine is inactive
  • "ENOSPC" -- no free space is available on the drive
  • "ENOTDIR" -- the path name is not a valid directory
  • "EROFS" -- the directory is on a read-only file system

Note that "path" must be a valid directory name. If the specified path is a symbolic link, that link is not followed. Also, the directory's owner ID is set to the process' effective user ID, and the directory's group ID is set to the process' effective group ID.