filchmod (Change an OpenTP1 file access authorization mode)

Format

filchmod mode OpenTP1-file-system-area-name/OpenTP1-file-name

Function

The filchmod command changes the access authorization for a specified OpenTP1 file to a specified mode.

Only the OpenTP1 administrator and the OpenTP1 file owner can execute the filchmod command.

Command arguments

mode

Specifies the new mode in absolute format or symbolic format.

The absolute format is explained below:

Absolute formatDescription
0400Right to read by the owner
0200Right to write by the owner
0040Right to read by the group
0020Right to write by the group
0004Right to read by others
0002Right to write by others
The symbolic format must be specified as follows:
[to-whom] operation [access-right]
to-whom: Specifies who is authorized:
u: Owner
g: Group
o: Others
a: Owner, group, and others
When this specification is omitted, a is assumed.
operation: Specifies the operation to be performed:
+: Add an access right
-: Remove an access right
=: Remove all access rights other than those specified
access-right: Specifies an access right
r: Authorized to read
w: Authorized to write

The access-right can be omitted only when "=" is specified as the operation. When the access-right is omitted, neither read nor write can be performed.

OpenTP1-file-system-area-name~<path name>

Specifies the name of the character special file or ordinary file containing the OpenTP1 file system.

OpenTP1-file-name~<OpenTP1 file name>

Specifies the name of the OpenTP1 file.

Output messages

Message IDDescriptionOutput destination
KFCA01508-IHelp messageStandard output, standard error output
KFCA01533-ESpecified OpenTP1 file was not found.Standard error output
KFCA01536-ESpecification of a command argument is invalid.Standard error output
KFCA01538-ESpecification of mode argument is invalid.Standard error output
KFCA01570-EFile versions do not match.Standard error output
KFCA01571-EUser does not have access right to the file.Standard error output
KFCA01572-EAn upper bound was exceeded during open processing.Standard error output
KFCA01573-ESpecified OpenTP1 file system area was not found.Standard error output
KFCA01574-ESpecified file name is too long.Standard error output
KFCA01575-ESpecified file is not a character special file or ordinary file; or, specified file was found, but there is no corresponding device.Standard error output
KFCA01576-ESpecified file is not an OpenTP1 file system.Standard error output
KFCA01577-EUser does not have right to execute filchmod command.Standard error output
KFCA01578-ELocking the OpenTP1 file system failed.Standard error output
KFCA01582-EMemory is inadequate.Standard error output
KFCA01583-EI/O error occurred.Standard error output
KFCA01599-EError occurred.Standard error output

Examples

Following are three examples of adding the read right to all users using the symbolic format, where the special file name is "/dev/rhp2a" and the OpenTP1 file name is "file":

filchmod ugo+r /dev/rdsk/rhd2a/file
filchmod a+r /dev/rdsk/rhd2a/file
filchmod +r /dev/rdsk/rhd2a/file