The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
CWEST / ppt-0.14 / html / commands / chown / chown.abigail.html 
<html><head><title>chown</title>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" >
</head>
<body class='pod'>
<!--
  generated by Pod::Simple::HTML v3.01,
  using Pod::Simple::PullParser v2.02,
  under Perl v5.008002 at Thu Aug  5 13:56:23 2004 GMT.

 If you want to change this HTML document, you probably shouldn't do that
   by changing it directly.  Instead, see about changing the calling options
   to Pod::Simple::HTML, and/or subclassing Pod::Simple::HTML,
   then reconverting this document from the Pod source.
   When in doubt, email the author of Pod::Simple::HTML for advice.
   See 'perldoc Pod::Simple::HTML' for more info.

-->

<!-- start doc -->
<a name='___top' class='dummyTopAnchor' ></a>

<h1><a class='u' href='#___top' title='click to go to top of document'
name="NAME"
>NAME</a></h1>

<p>chown -- change ownership of files.</p>

<h1><a class='u' href='#___top' title='click to go to top of document'
name="SYNOPSIS"
>SYNOPSIS</a></h1>

<p>chown [-R [-H | -L | -P]] user[:group] file [files ...]</p>

<h1><a class='u' href='#___top' title='click to go to top of document'
name="DESCRIPTION"
>DESCRIPTION</a></h1>

<p><i>chown</i> sets the ownership of files.
The first argument after the options is either a <i>user</i>,
or a <i>user</i>-<i>group</i> pair,
separated by a colon.
If the <i>group</i> is given,
group membership of the file is changed as well.</p>

<h2><a class='u' href='#___top' title='click to go to top of document'
name="OPTIONS"
>OPTIONS</a></h2>

<p><i>chown</i> accepts the options described below.
The options <i>-L</i>,
<i>-H</i> and <i>-P</i> are mutally exclusive,
and only the last given option will be honoured.
All of <i>-L</i>,
<i>-H</i> and <i>-P</i> require the <i>-R</i> option to be set first.</p>

<dl>
<dt><a name="-R"
>-R</a></dt><p class="pad"></p>

<dd>Recurse into directories.
Any directories are recursively traversed,
and all files and directories will change owner.</dd><p class="pad"></p>

<dt><a name="-L"
>-L</a></dt><p class="pad"></p>

<dd>Follow symbolic links.
By default,
<i>chown</i> will not follow symbolic links.
This is a potential dangerous option,
as <i>chown</i> will not check for cycles.
Be careful.
This option requires the <i>-R</i> option to be set.</dd><p class="pad"></p>

<dt><a name="-H"
>-H</a></dt><p class="pad"></p>

<dd>Follow symbolic links of command line files/directories only.
This option requires the <i>-R</i> option to be set.</dd><p class="pad"></p>

<dt><a name="-P"
>-P</a></dt><p class="pad"></p>

<dd>Do not follow symbolic links at all.
This option requires the <i>-R</i> option to be set.</dd><p class="pad"></p>
</dl>

<h1><a class='u' href='#___top' title='click to go to top of document'
name="ENVIRONMENT"
>ENVIRONMENT</a></h1>

<p>The working of <i>chown</i> is not influenced by any environment variables.</p>

<h1><a class='u' href='#___top' title='click to go to top of document'
name="BUGS"
>BUGS</a></h1>

<p><i>chown</i> can loop forever when symbolic links create cycles.</p>

<p><i>chown</i> uses <code lang='und' xml:lang='und'>File::Find</code> to recurse.</p>

<h1><a class='u' href='#___top' title='click to go to top of document'
name="REVISION_HISTORY"
>REVISION HISTORY</a></h1>

<pre lang='und' xml:lang='und'>    $Log: chown.abigail.html,v $
<pre lang='und' xml:lang='und'>    Revision 1.3  2004/08/05 14:18:01  cwest
<pre lang='und' xml:lang='und'>    cleanup, new version number on website
<pre lang='und' xml:lang='und'>
    Revision 1.1  2004/07/23 20:10:01  cwest
    initial import

    Revision 1.1  1999/02/28 19:59:17  abigail
    Initial revision</pre>

<h1><a class='u' href='#___top' title='click to go to top of document'
name="AUTHOR"
>AUTHOR</a></h1>

<p>The Perl implementation of <i>chown</i> was written by Abigail, <i>abigail@fnx.com</i>.</p>

<h1><a class='u' href='#___top' title='click to go to top of document'
name="COPYRIGHT_and_LICENSE"
>COPYRIGHT and LICENSE</a></h1>

<p>This program is copyright by Abigail 1999.</p>

<p>This program is free and open software. You may use, copy, modify, distribute and sell this program (and any modified variants) in any way you wish, provided you do not restrict others to do the same.</p>

<!-- end doc -->

</body></html>