manual/GNU_coreutils/original/man1/rm.1

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