summaryrefslogtreecommitdiff
path: root/man/rm.1
diff options
context:
space:
mode:
Diffstat (limited to 'man/rm.1')
-rw-r--r--man/rm.1107
1 files changed, 107 insertions, 0 deletions
diff --git a/man/rm.1 b/man/rm.1
new file mode 100644
index 0000000..3f9525e
--- /dev/null
+++ b/man/rm.1
@@ -0,0 +1,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.