man-pages/man1/chgrp.1.html
2021-03-31 01:06:50 +01:00

137 lines
4.1 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of CHGRP</TITLE>
</HEAD><BODY>
<H1>CHGRP</H1>
Section: User Commands (1)<BR>Updated: September 2019<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
chgrp - change group ownership
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>chgrp</B>
[<I>,OPTION/</I>]... <I>,GROUP FILE/</I>...
<BR>
<B>chgrp</B>
[<I>,OPTION/</I>]... <I>,--reference=RFILE FILE/</I>...
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
<P>
Change the group of each FILE to GROUP.
With <B>--reference</B>, change the group of each FILE to that of RFILE.
<DL COMPACT>
<DT id="1"><B>-c</B>, <B>--changes</B><DD>
like verbose but report only when a change is made
<DT id="2"><B>-f</B>, <B>--silent</B>, <B>--quiet</B><DD>
suppress most error messages
<DT id="3"><B>-v</B>, <B>--verbose</B><DD>
output a diagnostic for every file processed
<DT id="4"><B>--dereference</B><DD>
affect the referent of each symbolic link (this is
the default), rather than the symbolic link itself
<DT id="5"><B>-h</B>, <B>--no-dereference</B><DD>
affect symbolic links instead of any referenced file
(useful only on systems that can change the
ownership of a symlink)
<DT id="6"><B>--no-preserve-root</B><DD>
do not treat '/' specially (the default)
<DT id="7"><B>--preserve-root</B><DD>
fail to operate recursively on '/'
<DT id="8"><B>--reference</B>=<I>,RFILE/</I><DD>
use RFILE's group rather than specifying a
GROUP value
<DT id="9"><B>-R</B>, <B>--recursive</B><DD>
operate on files and directories recursively
</DL>
<P>
The following options modify how a hierarchy is traversed when the <B>-R</B>
option is also specified. If more than one is specified, only the final
one takes effect.
<DL COMPACT>
<DT id="10"><B>-H</B><DD>
if a command line argument is a symbolic link
to a directory, traverse it
<DT id="11"><B>-L</B><DD>
traverse every symbolic link to a directory
encountered
<DT id="12"><B>-P</B><DD>
do not traverse any symbolic links (default)
<DT id="13"><B>--help</B><DD>
display this help and exit
<DT id="14"><B>--version</B><DD>
output version information and exit
</DL>
<A NAME="lbAE">&nbsp;</A>
<H2>EXAMPLES</H2>
<DL COMPACT>
<DT id="15">chgrp staff /u<DD>
Change the group of /u to &quot;staff&quot;.
<DT id="16">chgrp -hR staff /u<DD>
Change the group of /u and subfiles to &quot;staff&quot;.
</DL>
<A NAME="lbAF">&nbsp;</A>
<H2>AUTHOR</H2>
Written by David MacKenzie and Jim Meyering.
<A NAME="lbAG">&nbsp;</A>
<H2>REPORTING BUGS</H2>
GNU coreutils online help: &lt;<A HREF="https://www.gnu.org/software/coreutils/">https://www.gnu.org/software/coreutils/</A>&gt;
<BR>
Report chgrp translation bugs to &lt;<A HREF="https://translationproject.org/team/">https://translationproject.org/team/</A>&gt;
<A NAME="lbAH">&nbsp;</A>
<H2>COPYRIGHT</H2>
Copyright &#169; 2018 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later &lt;<A HREF="https://gnu.org/licenses/gpl.html">https://gnu.org/licenses/gpl.html</A>&gt;.
<BR>
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
<A NAME="lbAI">&nbsp;</A>
<H2>SEE ALSO</H2>
<A HREF="/cgi-bin/man/man2html?1+chown">chown</A>(1), <A HREF="/cgi-bin/man/man2html?2+chown">chown</A>(2)
<P>
<BR>
Full documentation at: &lt;<A HREF="https://www.gnu.org/software/coreutils/chgrp">https://www.gnu.org/software/coreutils/chgrp</A>&gt;
<BR>
or available locally via: info '(coreutils) chgrp invocation'
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="17"><A HREF="#lbAB">NAME</A><DD>
<DT id="18"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="19"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT id="20"><A HREF="#lbAE">EXAMPLES</A><DD>
<DT id="21"><A HREF="#lbAF">AUTHOR</A><DD>
<DT id="22"><A HREF="#lbAG">REPORTING BUGS</A><DD>
<DT id="23"><A HREF="#lbAH">COPYRIGHT</A><DD>
<DT id="24"><A HREF="#lbAI">SEE ALSO</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:05:09 GMT, March 31, 2021
</BODY>
</HTML>