view docs/nitros9guide/attr.refentry @ 1053:b5ff125a1d60

Since this book was only typeset in fixed width, single-font, they used capitalization and quotes (") to show what was commands, files and just text. With today's formatting, this is not necessary, so everywhere capitalization was used to show a command the <command> element is now used instead, and everywhere a file is mentioned the <filename> element is used.
author roug
date Thu, 20 Mar 2003 20:19:53 +0000
parents c565a4700689
children 4dae346c4969
line wrap: on
line source

<refentry id="attr">
<refnamediv>
<refname id="attrname">ATTR</refname>
<refpurpose>Change file security attributes</refpurpose>
</refnamediv>

<refsynopsisdiv>
<cmdsynopsis>
<command>ATTR</command>
<arg choice="plain">
  <replaceable>path</replaceable>
</arg>
<arg choice="opt">&repeatst; <replaceable>permission abbreviations</replaceable> &repeaten;</arg>
</cmdsynopsis>
</refsynopsisdiv>

<refsect1><title>Description</title>
<para>
This command is used to examine or change the security permissions
of a file. To enter the command, type <command>attr</command> followed by the
pathlist for the file who's security permissions are to be changed,
followed by a list of permissions which are to be turned on or off.
A permission is turned on by giving its abbreviation, or turned off
by preceding its abbreviation with a minus sign. Permissions not
explicitly named are not affected. If no permissions are given the
current file attributes will be printed. You can not change the
attributes of a file which you do not own (except for user zero, who
can change the attributes of any file in the system).
</para>
<para>
The file permission abbreviations are:
</para>
<literallayout>
 d = Directory file
 s = Sharable file
 r = Read permit to owner
 w = Write permit to owner
 e = Execute permit to owner
pr = Read permit to public
pw = Write permit to public
pe = Execute permit to public
</literallayout>

<para>
The <command>attr</command> command may be used to change a directory file to a
non-directory file if all entries have been deleted from it. Since the
DEL command will only delete non-directory files, this is the only
way a directory may be deleted. You cannot change a non-directory
file to a directory file with this command (see MAKDIR).
</para>
<para>
For more information see: 3.8, 3.8.1
</para>
</refsect1>
<refsect1><title>Examples</title>
<screen>
attr myfile -pr -pw

attr myfile r w e pr rw pe


attr datalog
-s-wr-wr
</screen>
</refsect1>
</refentry>