function
|
vfsChangePermissions
|
Available in:
Professional
Enterprise
|
Declaration define external function vfsChangePermissions
value stream path
on value vfsDir location optional
to value stream mode
contents value switch contents optional initial {VFS-NOT-INCLUDED}
where:
where
- path
- the file or directory name of the ownership change
- location
- a connected directory
- mode
- the permission change directive
- contents
- specifies if the directory contents are also to have changed permissions
Purpose
You use this function to change the permissions of a file or subdirectory.
PARAMETERS
Path must be in one of the following formats:
- file name only
- file name plus an absolute directory path
- file name plus a relative directory path
- an absolute directory path
- a relative directory path
Mode values must be in the string format used by the chmod function
Contents value must be one of the following:
- VFS-NOT-INCLUDED
- VFS-INCLUDED
Location must be connected to a directory.
Location must be connected through the following scheme:
OPERATION
- When location is supplied, path applies to that vfsDir.
- When location is not supplied, path applies to the current directory on the local file system.
- When contents is VFS-NOT-INCLUDED, only the specified file or directory has its permissions changed.
- When contents is VFS-INCLUDED and path is a directory reference, the directory, and all its contents have their permissions changed.
Sample function call:
; where Sydney is a currently connected vfsDir
vfsChangePermissions "Programs" on Sydney to "rw"
OmniMark 6.5 Documentation Generated: December 23, 2002 at 6:25:47 pm
If you have any comments about this section of the documentation, send email to [email protected]
Copyright © OmniMark Technologies Corporation, 1988-2002.