summaryrefslogtreecommitdiff
path: root/man/rm.1
blob: 3f9525e1cc25c9076c11a28ea1a8cabd0ced8ef6 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
.TH RM "1" "March 2007" "GNU coreutils 6.9" "User Commands"
.SH NAME
rm \- remove files or directories
.SH SYNOPSIS
.B rm
[\fIOPTION\fR]... \fIFILE\fR...
.SH DESCRIPTION
This manual page
documents the GNU version of
.BR rm .
.B rm
removes each specified file.  By default, it does not remove
directories.
.P
If the \fI\-I\fR or \fI\-\-interactive\=once\fR option is given,
and there are more than three files or the \fI\-r\fR, \fI\-R\fR,
or \fI\-\-recursive\fR are given, then
.B rm
prompts the user for whether to proceed with the entire operation.  If
the response is not affirmative, the entire command is aborted.
.P
Otherwise, if a file is unwritable, standard input is a terminal, and
the \fI\-f\fR or \fI\-\-force\fR option is not given, or the
\fI\-i\fR or \fI\-\-interactive\=always\fR option is given,
.B rm
prompts the user for whether to remove the file.  If the response is
not affirmative, the file is skipped.
.SH OPTIONS
.PP
Remove (unlink) the FILE(s).
.TP
\fB\-f\fR, \fB\-\-force\fR
ignore nonexistent files, never prompt
.TP
\fB\-i\fR
prompt before every removal
.TP
\fB\-I\fR
prompt once before removing more than three files, or
when removing recursively.  Less intrusive than \fB\-i\fR,
while still giving protection against most mistakes
.TP
\fB\-\-interactive\fR[=\fIWHEN\fR]
prompt according to WHEN: never, once (\fB\-I\fR), or
always (\fB\-i\fR).  Without WHEN, prompt always
.TP
\fB\-\-one\-file\-system\fR
when removing a hierarchy recursively, skip any
directory that is on a file system different from
that of the corresponding command line argument
.TP
\fB\-\-no\-preserve\-root\fR
do not treat `/' specially
.TP
\fB\-\-preserve\-root\fR
do not remove `/' (default)
.TP
\fB\-r\fR, \fB\-R\fR, \fB\-\-recursive\fR
remove directories and their contents recursively
.TP
\fB\-v\fR, \fB\-\-verbose\fR
explain what is being done
.TP
\fB\-\-help\fR
display this help and exit
.TP
\fB\-\-version\fR
output version information and exit
.PP
By default, rm does not remove directories.  Use the \fB\-\-recursive\fR (\fB\-r\fR or \fB\-R\fR)
option to remove each listed directory, too, along with all of its contents.
.PP
To remove a file whose name starts with a `\-', for example `\-foo',
use one of these commands:
.IP
rm \fB\-\-\fR \fB\-foo\fR
.IP
rm ./\-foo
.PP
Note that if you use rm to remove a file, it is usually possible to recover
the contents of that file.  If you want more assurance that the contents are
truly unrecoverable, consider using shred.
.SH AUTHOR
Written by Paul Rubin, David MacKenzie, Richard Stallman, and Jim Meyering.
.SH "REPORTING BUGS"
Report bugs to <bug\-coreutils@gnu.org>.
.SH COPYRIGHT
Copyright \(co 2007 Free Software Foundation, Inc.
.br
This is free software.  You may redistribute copies of it under the terms of
the GNU General Public License <http://www.gnu.org/licenses/gpl.html>.
There is NO WARRANTY, to the extent permitted by law.
.SH "SEE ALSO"
unlink(1), unlink(2), chattr(1), shred(1)
.PP
The full documentation for
.B rm
is maintained as a Texinfo manual.  If the
.B info
and
.B rm
programs are properly installed at your site, the command
.IP
.B info rm
.PP
should give you access to the complete manual.