Library: File system utilities (OMFSYS legacy) Include: omfsys.xin

Declaration

define external function FS_ChangeOwner
                value      stream  path
   owner        value      integer owner
   group        value      integer group
   status       modifiable stream  statusvalue

The omfsys library has been deprecated and will be removed from a future version of the language. Use omvfs instead.

This function allows you to change the ownership ID of a file or directory.

Input arguments:

• "path" -- the name of the file
• "owner" -- the new owner ID of the file
• "group" -- the new group ID of the file

Output argument:

• "statusvalue". This argument will contain either a zero length string if the function succeeds, or one of the following error codes:
  • "EACCES" -- no search permission on a component of the path name
  • "EINTR" -- a signal was caught during the function execution
  • "EIO" -- a file system I/O error occurred
  • "ELOOP" -- (UNIX only) link recursion was detected
  • "ENAMETOOLONG" -- the path name exceeds the system limits
  • "ENOENT" -- the specified path does not exist
  • "ENOLINK" -- (UNIX only) a required link to a remote machine is inactive
  • "ENOTDIR" -- the path name is not a valid directory
  • "EMULTIHOP" -- (UNIX only) remote machine access is required but not allowed
  • "EPERM" -- the user does not have the required permissions
  • "EROFS" -- the file resides on a read-only file system
  • "EINVAL" -- "group" or "owner" is out of range

Note that "newpath" must refer to a valid path name. Also, the user ID of the process must be the same as the file owner or the process must belong to the super-user.

Related Syntax FS_ChangePermissions

Other Library Functions

[ INDEX ] [ CONCEPTS ] [ TASKS ] [ SYNTAX ] [ LIBRARIES ] [ LEGACY LIBRARIES ] [ ERRORS ]