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.\" 3515856298SBruce Evans.\" @(#)chflags.1 8.4 (Berkeley) 5/2/95 36c3aac50fSPeter Wemm.\" $FreeBSD$ 379b50d902SRodney W. Grimes.\" 3815856298SBruce Evans.Dd May 2, 1995 399b50d902SRodney W. Grimes.Dt CHFLAGS 1 409b50d902SRodney W. Grimes.Os 419b50d902SRodney W. Grimes.Sh NAME 429b50d902SRodney W. Grimes.Nm chflags 439b50d902SRodney W. Grimes.Nd change file flags 449b50d902SRodney W. Grimes.Sh SYNOPSIS 459b50d902SRodney W. Grimes.Nm chflags 469b50d902SRodney W. Grimes.Oo 479b50d902SRodney W. Grimes.Fl R 489b50d902SRodney W. Grimes.Op Fl H | Fl L | Fl P 499b50d902SRodney W. Grimes.Oc 509b50d902SRodney W. Grimes.Ar flags 519b50d902SRodney W. Grimes.Ar file ... 529b50d902SRodney W. Grimes.Sh DESCRIPTION 539b50d902SRodney W. GrimesThe 549b50d902SRodney W. Grimes.Nm chflags 559b50d902SRodney W. Grimesutility modifies the file flags of the listed files 569b50d902SRodney W. Grimesas specified by the 579b50d902SRodney W. Grimes.Ar flags 589b50d902SRodney W. Grimesoperand. 599b50d902SRodney W. Grimes.Pp 609b50d902SRodney W. GrimesThe options are as follows: 619b50d902SRodney W. Grimes.Bl -tag -width Ds 629b50d902SRodney W. Grimes.It Fl H 639b50d902SRodney W. GrimesIf the 649b50d902SRodney W. Grimes.Fl R 659b50d902SRodney W. Grimesoption is specified, symbolic links on the command line are followed. 669b50d902SRodney W. Grimes(Symbolic links encountered in the tree traversal are not followed.) 679b50d902SRodney W. Grimes.It Fl L 689b50d902SRodney W. GrimesIf the 699b50d902SRodney W. Grimes.Fl R 709b50d902SRodney W. Grimesoption is specified, all symbolic links are followed. 719b50d902SRodney W. Grimes.It Fl P 729b50d902SRodney W. GrimesIf the 739b50d902SRodney W. Grimes.Fl R 749b50d902SRodney W. Grimesoption is specified, no symbolic links are followed. 759b50d902SRodney W. Grimes.It Fl R 769b50d902SRodney W. GrimesChange the file flags for the file hierarchies rooted 779b50d902SRodney W. Grimesin the files instead of just the files themselves. 789b50d902SRodney W. Grimes.El 799b50d902SRodney W. Grimes.Pp 809b50d902SRodney W. GrimesFlags are a comma separated list of keywords. 819b50d902SRodney W. GrimesThe following keywords are currently defined: 829b50d902SRodney W. Grimes.Bd -literal -offset indent compact 8362a1ce7aSBruce Evansarch set the archived flag (super-user only) 8415856298SBruce Evansopaque set the opaque flag (owner or super-user only) 8515856298SBruce Evansnodump set the nodump flag (owner or super-user only) 869b50d902SRodney W. Grimessappnd set the system append-only flag (super-user only) 879b50d902SRodney W. Grimesschg set the system immutable flag (super-user only) 8850dab48aSJulian Elischersunlnk set the system undeletable flag (super-user only) 899b50d902SRodney W. Grimesuappnd set the user append-only flag (owner or super-user only) 909b50d902SRodney W. Grimesuchg set the user immutable flag (owner or super-user only) 9150dab48aSJulian Elischeruunlnk set the user undeletable flag (owner or super-user only) 9250dab48aSJulian Elischerarchived, sappend, schange, simmutable, uappend, uchange, uimmutable, 9350dab48aSJulian Elischersunlink, uunlink 9462a1ce7aSBruce Evans aliases for the above 959b50d902SRodney W. Grimes.Ed 969b50d902SRodney W. Grimes.Pp 979b50d902SRodney W. GrimesPutting the letters 989b50d902SRodney W. Grimes.Dq no 999b50d902SRodney W. Grimesbefore an option causes the flag to be turned off. 1009b50d902SRodney W. GrimesFor example: 1019b50d902SRodney W. Grimes.Bd -literal -offset indent compact 10215856298SBruce Evansnouchg the immutable bit should be cleared 1039b50d902SRodney W. Grimes.Ed 1049b50d902SRodney W. Grimes.Pp 1059b50d902SRodney W. GrimesSymbolic links do not have flags, so unless the 1069b50d902SRodney W. Grimes.Fl H 1079b50d902SRodney W. Grimesor 1089b50d902SRodney W. Grimes.Fl L 1099b50d902SRodney W. Grimesoption is set, 1109b50d902SRodney W. Grimes.Nm chflags 1119b50d902SRodney W. Grimeson a symbolic link always succeeds and has no effect. 1129b50d902SRodney W. GrimesThe 1139b50d902SRodney W. Grimes.Fl H , 1149b50d902SRodney W. Grimes.Fl L 1159b50d902SRodney W. Grimesand 1169b50d902SRodney W. Grimes.Fl P 1179b50d902SRodney W. Grimesoptions are ignored unless the 1189b50d902SRodney W. Grimes.Fl R 1199b50d902SRodney W. Grimesoption is specified. 1209b50d902SRodney W. GrimesIn addition, these options override each other and the 1219b50d902SRodney W. Grimescommand's actions are determined by the last one specified. 1229b50d902SRodney W. Grimes.Pp 123601fc2b9SPhilippe CharnierYou can use "ls -lo" to see the flags of existing files. 124601fc2b9SPhilippe Charnier.Pp 1259b50d902SRodney W. GrimesThe 1269b50d902SRodney W. Grimes.Nm chflags 1279b50d902SRodney W. Grimesutility exits 0 on success, and >0 if an error occurs. 1289b50d902SRodney W. Grimes.Sh SEE ALSO 129601fc2b9SPhilippe Charnier.Xr ls 1 , 1309b50d902SRodney W. Grimes.Xr chflags 2 , 1319b50d902SRodney W. Grimes.Xr stat 2 , 1329b50d902SRodney W. Grimes.Xr fts 3 , 1339b50d902SRodney W. Grimes.Xr symlink 7 134995369a6SDavid E. O'Brien.Sh HISTORY 135995369a6SDavid E. O'BrienThe 136995369a6SDavid E. O'Brien.Nm chflags 137c8da9b75SMike Pritchardcommand first appeared in 138c8da9b75SMike Pritchard.Bx 4.4 . 139