xref: /freebsd/bin/chflags/chflags.1 (revision 9b50d9027575220cb6dd09b3e62f03f511e908b8)
19b50d902SRodney W. Grimes.\" Copyright (c) 1989, 1990, 1993, 1994
29b50d902SRodney W. Grimes.\"	The Regents of the University of California.  All rights reserved.
39b50d902SRodney W. Grimes.\"
49b50d902SRodney W. Grimes.\" This code is derived from software contributed to Berkeley by
59b50d902SRodney W. Grimes.\" the Institute of Electrical and Electronics Engineers, Inc.
69b50d902SRodney W. Grimes.\"
79b50d902SRodney W. Grimes.\" Redistribution and use in source and binary forms, with or without
89b50d902SRodney W. Grimes.\" modification, are permitted provided that the following conditions
99b50d902SRodney W. Grimes.\" are met:
109b50d902SRodney W. Grimes.\" 1. Redistributions of source code must retain the above copyright
119b50d902SRodney W. Grimes.\"    notice, this list of conditions and the following disclaimer.
129b50d902SRodney W. Grimes.\" 2. Redistributions in binary form must reproduce the above copyright
139b50d902SRodney W. Grimes.\"    notice, this list of conditions and the following disclaimer in the
149b50d902SRodney W. Grimes.\"    documentation and/or other materials provided with the distribution.
159b50d902SRodney W. Grimes.\" 3. All advertising materials mentioning features or use of this software
169b50d902SRodney W. Grimes.\"    must display the following acknowledgement:
179b50d902SRodney W. Grimes.\"	This product includes software developed by the University of
189b50d902SRodney W. Grimes.\"	California, Berkeley and its contributors.
199b50d902SRodney W. Grimes.\" 4. Neither the name of the University nor the names of its contributors
209b50d902SRodney W. Grimes.\"    may be used to endorse or promote products derived from this software
219b50d902SRodney W. Grimes.\"    without specific prior written permission.
229b50d902SRodney W. Grimes.\"
239b50d902SRodney W. Grimes.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
249b50d902SRodney W. Grimes.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
259b50d902SRodney W. Grimes.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
269b50d902SRodney W. Grimes.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
279b50d902SRodney W. Grimes.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
289b50d902SRodney W. Grimes.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
299b50d902SRodney W. Grimes.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
309b50d902SRodney W. Grimes.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
319b50d902SRodney W. Grimes.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
329b50d902SRodney W. Grimes.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
339b50d902SRodney W. Grimes.\" SUCH DAMAGE.
349b50d902SRodney W. Grimes.\"
359b50d902SRodney W. Grimes.\"	@(#)chflags.1	8.2 (Berkeley) 3/31/94
369b50d902SRodney W. Grimes.\"
379b50d902SRodney W. Grimes.Dd March 31, 1994
389b50d902SRodney W. Grimes.Dt CHFLAGS 1
399b50d902SRodney W. Grimes.Os
409b50d902SRodney W. Grimes.Sh NAME
419b50d902SRodney W. Grimes.Nm chflags
429b50d902SRodney W. Grimes.Nd change file flags
439b50d902SRodney W. Grimes.Sh SYNOPSIS
449b50d902SRodney W. Grimes.Nm chflags
459b50d902SRodney W. Grimes.Oo
469b50d902SRodney W. Grimes.Fl R
479b50d902SRodney W. Grimes.Op Fl H | Fl L | Fl P
489b50d902SRodney W. Grimes.Oc
499b50d902SRodney W. Grimes.Ar flags
509b50d902SRodney W. Grimes.Ar file ...
519b50d902SRodney W. Grimes.Sh DESCRIPTION
529b50d902SRodney W. GrimesThe
539b50d902SRodney W. Grimes.Nm chflags
549b50d902SRodney W. Grimesutility modifies the file flags of the listed files
559b50d902SRodney W. Grimesas specified by the
569b50d902SRodney W. Grimes.Ar flags
579b50d902SRodney W. Grimesoperand.
589b50d902SRodney W. Grimes.Pp
599b50d902SRodney W. GrimesThe options are as follows:
609b50d902SRodney W. Grimes.Bl -tag -width Ds
619b50d902SRodney W. Grimes.It Fl H
629b50d902SRodney W. GrimesIf the
639b50d902SRodney W. Grimes.Fl R
649b50d902SRodney W. Grimesoption is specified, symbolic links on the command line are followed.
659b50d902SRodney W. Grimes(Symbolic links encountered in the tree traversal are not followed.)
669b50d902SRodney W. Grimes.It Fl L
679b50d902SRodney W. GrimesIf the
689b50d902SRodney W. Grimes.Fl R
699b50d902SRodney W. Grimesoption is specified, all symbolic links are followed.
709b50d902SRodney W. Grimes.It Fl P
719b50d902SRodney W. GrimesIf the
729b50d902SRodney W. Grimes.Fl R
739b50d902SRodney W. Grimesoption is specified, no symbolic links are followed.
749b50d902SRodney W. Grimes.It Fl R
759b50d902SRodney W. GrimesChange the file flags for the file hierarchies rooted
769b50d902SRodney W. Grimesin the files instead of just the files themselves.
779b50d902SRodney W. Grimes.El
789b50d902SRodney W. Grimes.Pp
799b50d902SRodney W. GrimesFlags are a comma separated list of keywords.
809b50d902SRodney W. GrimesThe following keywords are currently defined:
819b50d902SRodney W. Grimes.Bd -literal -offset indent compact
829b50d902SRodney W. Grimes.\"arch	nothing yet.
839b50d902SRodney W. Grimesdump	set the dump flag
849b50d902SRodney W. Grimessappnd	set the system append-only flag (super-user only)
859b50d902SRodney W. Grimesschg	set the system immutable flag (super-user only)
869b50d902SRodney W. Grimesuappnd	set the user append-only flag (owner or super-user only)
879b50d902SRodney W. Grimesuchg	set the user immutable flag (owner or super-user only)
889b50d902SRodney W. Grimes.Ed
899b50d902SRodney W. Grimes.Pp
909b50d902SRodney W. GrimesPutting the letters
919b50d902SRodney W. Grimes.Dq no
929b50d902SRodney W. Grimesbefore an option causes the flag to be turned off.
939b50d902SRodney W. GrimesFor example:
949b50d902SRodney W. Grimes.Bd -literal -offset indent compact
959b50d902SRodney W. Grimesnodump	the file should never be dumped
969b50d902SRodney W. Grimes.Ed
979b50d902SRodney W. Grimes.Pp
989b50d902SRodney W. GrimesSymbolic links do not have flags, so unless the
999b50d902SRodney W. Grimes.Fl H
1009b50d902SRodney W. Grimesor
1019b50d902SRodney W. Grimes.Fl L
1029b50d902SRodney W. Grimesoption is set,
1039b50d902SRodney W. Grimes.Nm chflags
1049b50d902SRodney W. Grimeson a symbolic link always succeeds and has no effect.
1059b50d902SRodney W. GrimesThe
1069b50d902SRodney W. Grimes.Fl H ,
1079b50d902SRodney W. Grimes.Fl L
1089b50d902SRodney W. Grimesand
1099b50d902SRodney W. Grimes.Fl P
1109b50d902SRodney W. Grimesoptions are ignored unless the
1119b50d902SRodney W. Grimes.Fl R
1129b50d902SRodney W. Grimesoption is specified.
1139b50d902SRodney W. GrimesIn addition, these options override each other and the
1149b50d902SRodney W. Grimescommand's actions are determined by the last one specified.
1159b50d902SRodney W. Grimes.Pp
1169b50d902SRodney W. GrimesThe
1179b50d902SRodney W. Grimes.Nm chflags
1189b50d902SRodney W. Grimesutility exits 0 on success, and >0 if an error occurs.
1199b50d902SRodney W. Grimes.Sh SEE ALSO
1209b50d902SRodney W. Grimes.Xr chflags 2 ,
1219b50d902SRodney W. Grimes.Xr stat 2 ,
1229b50d902SRodney W. Grimes.Xr fts 3 ,
1239b50d902SRodney W. Grimes.Xr symlink 7
124