view docs/nitros9guide/attr.refentry @ 2798:b70d93f8d7ce lwtools-port

Updated coco1/modules/makefile and coco3/modules/makefile to help resolve issues with i(x) and s(x) descriptors. Updated level1/coco1/modules/makefile & level2/coco3/modules/makefile so that correct values would be sent to assembler when building superdesc.asm for s(x).dd and i(x).dd descriptors.
author drencor-xeen
date Mon, 28 Jan 2013 16:13:05 -0600
parents 4dae346c4969
children
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 <command>makdir</command>).
</para>
<para>
For more information see: <xref linkend="sec3.8"/>, <xref linkend="sec3.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>