view docs/nitros9guide/attr.refentry @ 2187:dc01b8d40ee0

created new dw3.bl bootlist file, renamed mb to mb.floppy and created mb.dw3
author boisy
date Wed, 11 Mar 2009 02:07:19 +0000
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>