libutil: add O_NOCTTY back to old pty open code
[minix.git] / man / man1 / chmod.1
bloba4e35c99f0d099e33cd72ac75fb7083d77880701
1 .TH CHMOD 1
2 .SH NAME
3 chmod \- change access mode for files
4 .SH SYNOPSIS
5 \fBchmod [\fB\-R\fR] \fImode \fIfile\fR ...\fR
6 .br
7 .de FL
8 .TP
9 \\fB\\$1\\fR
10 \\$2
12 .de EX
13 .TP 20
14 \\fB\\$1\\fR
15 # \\$2
17 .SH OPTIONS
18 .TP 5
19 .B \-R
20 # Change hierarchies recursively
21 .SH EXAMPLES
22 .TP 20
23 .B chmod 755 file
24 # Owner: rwx Group: r\-x Others: r\-x
25 .TP 20
26 .B chmod +x file1 file2
27 # Make \fIfile1\fR and \fIfile2\fR executable
28 .TP 20
29 .B chmod a\-w file
30 # Make \fIfile\fR read only
31 .TP 20
32 .B chmod u+s file
33 # Turn on SETUID for \fIfile\fR
34 .TP 20
35 .B chmod \-R o+w dir
36 # Allow writing for all files in dir
37 .SH DESCRIPTION
38 .PP
39 The given mode is applied to each file in the file list. If the \fB\-R\fR
40 flag is present, the files in a directory will be changed as well.
41 The mode can be either absolute or symbolic. Absolute modes are given as an
42 octal number that represents the new file mode. The mode bits are defined as
43 follows: 
44 .ta 0.25i
45 .nf
46 .PP
47         4000    Set effective user id on execution to file's owner id
48         2000    Set effective group id on execution to file's group id
49         0400    file is readable by the owner of the file
50         0200    writeable by owner
51         0100    executable by owner
52         0070    same as above, for other users in the same group
53         0007    same as above, for all other users
54 .PP
55 .fi
56 Symbolic modes modify the current file mode in a specified way. The form is:
57 .PP
58         [who] op permissions { op permissions ...} {, [who] op ... }
59 .PP
60 The possibilities for \fIwho\fR are \fIu\fR, \fIg\fR, \fIo\fR, and \fIa\fR,
61 standing for user, group, other and all, respectively.  
62 If \fIwho\fR is omitted, \fIa\fR is assumed, but the current umask is used.  
63 The op can be \fI+\fR, \fI-\fR, or \fI=\fR;  \fI+\fR turns on the 
64 given permissions, \fI\- \fRturns them off; \fI=\fR sets the permissions 
65 exclusively for the given \fIwho\fR.  
66 For example \fIg=x\fR sets the group permissions to \fI--x\fR. 
67 .PP
68 The possible permissions are \fIr\fR, \fIw\fR, \fIx\fR; which stand for read, 
69 write, and execute;  \fIs\fR turns on the set effective user/group id bits.  
70 \fIs\fR only makes sense with \fIu\fR and \fIg\fR;\fR o+s\fR is 
71 harmless.
72 .SH "SEE ALSO"
73 .BR ls (1),
74 .BR chmod (2).