OpenTP1 Version 7 Operation

[Contents][Index][Back][Next]

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 format Description
0400 Right to read by the owner
0200 Right to write by the owner
0040 Right to read by the group
0020 Right to write by the group
0004 Right to read by others
0002 Right 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 ID Description Output destination
KFCA01508-I Help message Standard output, standard error output
KFCA01533-E Specified OpenTP1 file was not found. Standard error output
KFCA01536-E Specification of a command argument is invalid. Standard error output
KFCA01538-E Specification of mode argument is invalid. Standard error output
KFCA01570-E File versions do not match. Standard error output
KFCA01571-E User does not have access right to the file. Standard error output
KFCA01572-E An upper bound was exceeded during open processing. Standard error output
KFCA01573-E Specified OpenTP1 file system area was not found. Standard error output
KFCA01574-E Specified file name is too long. Standard error output
KFCA01575-E Specified 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-E Specified file is not an OpenTP1 file system. Standard error output
KFCA01577-E User does not have right to execute filchmod command. Standard error output
KFCA01578-E Locking the OpenTP1 file system failed. Standard error output
KFCA01582-E Memory is inadequate. Standard error output
KFCA01583-E I/O error occurred. Standard error output
KFCA01599-E Error 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