Use this command to change the access permissions of a file or
directory. The access permissions determine who can read, write, or
search a file or directory.
- Note:
- In a program, you can set the access permissions of a file or directory with
the chmod function.
Requirements and Restrictions
- The parameters for this command are case-sensitive. You
must enter the parameters exactly as shown in the syntax
diagram.
- You can enter this command only in CRAS state or higher.
Format
- -R
- recursively changes the access permissions of the specified file or
directory. If you specify a directory, the access permissions of all
files and subdirectories under that directory are changed. If you do
not specify this parameter, the access permissions for only the specified file
or directory are changed.
- permission
- is the permission setting specified in octal notation. Specify this
permission setting by adding the following values:
- 4000
- sets the effective user ID (UID) of the process that executes the
file. In the chmod function, this value is
S_ISUID. This setting has no effect on directories.
- 2000
- sets the effective group ID (GID) of the process that executes the
file. In the chmod function, this value is
S_ISGID. If you set this value for a directory, all files created in
that directory will have the same GID of that directory.
- 0400
- allows the owner to read the file or directory. In the
chmod function, this value is S_IRUSR.
- 0200
- allows the owner to write to the file or directory. In the
chmod function, this value is S_IWUSR.
- 0100
- allows the owner to execute (or run) the file or search the
directory. In the chmod function, this value is
S_IXUSR. Specify this permission only for directories or regular
files; you cannot set this permission for special files.
- 0040
- allows the group to read the file or directory. In the
chmod function, this value is S_IRGRP.
- 0020
- allows the group to write to the file or directory. In the
chmod function, this value is S_IWGRP.
- 0010
- allows the group to execute (or run) the file or search the
directory. In the chmod function, this value is
S_IXGRP. Specify this permission only for directories or regular
files; you cannot set this permission for special files.
- 0004
- allows others to read the file or directory. In the
chmod function, this value is S_IROTH.
- 0002
- allows others to write to the file or directory. In the
chmod function, this value is S_IWOTH.
- 0001
- allows others to execute (or run) the file or search the directory.
In the chmod function, this value is S_IXOTH. Specify
this permission only for directories or regular files; you cannot set
this permission for special files.
For example, to set the access permissions to allow the owner to read,
write, and execute the file, and to allow the group and others to read and
execute the file, specify 755 for permission.
- Note:
- You do not have to specify the leading zeros for the access permission
values.
- path
- is the path name of the file or directory whose access permissions you are
changing.
Additional Information
- Online help information is available for this command. To display
the help information, enter one of the following:
ZFILE HELP chmod
ZFILE HELP
ZFILE ?
In addition, the correct command syntax is displayed if you enter the syntax
incorrectly.
- You must set on the execute permission to use a directory as a
directory; for example, to list the directory contents or to remove
files.
- This command does not read from the standard input (stdin)
stream.
This command does not write to the standard output (stdout)
stream.
You can redirect the standard error (stderr) stream from the
display terminal to a file by specifying one of the redirection characters
(2> or 2>>) followed by the file name to which you want
the error output written. The 2> character writes the error
output to a file. The 2>> character appends the error output
to an existing file.
- Note:
- When you use the > or 2> character, if the file that
you are redirecting data to already exists, the file is overwritten and any
data in that file is lost. If you do not want to overwrite the file,
ensure that you use the >> or 2>> character.
- The ZFILE chmod command is based on a subset of the chmod utility of the
Portable Operating System Interface for Computer Environments (POSIX)
standards.
- You can use the following wildcard characters in the path name to select
files that satisfy a particular name pattern:
- Wildcard
- Description
- *
- Matches any string, including the empty string.
- ?
- Matches any single character.
- [..]
- Matches any one of the characters between the brackets. You can
specify a range of characters by separating a pair of characters with a dash
(-).
- This command supports the following three quoting mechanisms, which allow
you to override the special meaning of some characters:
- escape character (\)
- preserves the literal value of the character that follows. To
ignore the special meaning of a character, escape it by placing a backslash
(\) in front of it. In the example that follows, environment
variable PATH is /bin:/usr/bin:., the first
dollar sign ($) is escaped because of the preceding backslash, and the
second dollar sign takes on a special meaning.
User: ZFILE echo \$PATH is $PATH
System: $PATH is /bin:/usr/bin:.
- single quotation marks (' ')
- preserves the literal value of all characters between the opening single
quotation mark and the closing single quotation mark. For example,
entering ZFILE echo '*' displays an asterisk
character (*). Without the single quotation marks, the files
in the current working directory are displayed.
- double quotation marks (" ")
- preserves the literal value of all characters between the opening double
quotation mark and the closing double quotation mark except the dollar sign
($), the backquote (`), and the backslash (\).
This allows you to use the escape character inside double quotation marks,
which you cannot do in single quotation marks.
For example, entering ZFILE echo "\$PATH is \"$PATH\""
displays $PATH is "/bin:/usr/bin:."
If you want to use the literal meaning of any of the following
characters, you must always use a quoting mechanism:
left angle bracket (<)
| right angle bracket (>)
| ampersand (&)
|
backquote (`)
| backslash (\)
| dollar sign ($)
|
double quotation mark (")
| new-line (\n)
| left parenthesis ( ( )
|
right parenthesis ( ) )
| semicolon (;)
| single quotation mark (')
|
blank space
| tab
| vertical bar (|)
|
In addition, use a quoting mechanism when any of the following characters are
used in a way that takes on a special meaning but you want to use the literal
meaning:
asterisk (*)
| equal sign (=)
| left square bracket ( [ )
|
number sign (#)
| question mark (?)
| tilde (~)
|
Examples
In the following example, the access permissions for
/tmp/sample.1 are set to read and write by owner and
group.
+---------------------------------------------------------------------------------------------+
|User: ZFILE chmod 0660 /tmp/sample.1 |
| |
|System: FILE0003I 15.26.53 chmod 0660 ... COMPLETED SUCCESSFULLY. NO OUTPUT TO DISPLAY |
+---------------------------------------------------------------------------------------------+
Related Information