1 .\" Written by Andries E. Brouwer (aeb@cwi.nl)
2 .\" Placed in the public domain
4 .TH RENAME 1 "June 2011" "util-linux" "User Commands"
10 .IR "expression replacement file" ...
13 will rename the specified files by replacing the first occurrence of
19 \fB\-v\fR, \fB\-\-verbose\fR
20 Give visual feedback which files where renamed, if any.
22 \fB\-V\fR, \fB\-\-version\fR
23 Display version information and exit.
25 \fB\-s\fR, \fB\-\-symlink\fR
26 Peform rename on symlink target
28 \fB\-h\fR, \fB\-\-help\fR
29 Display help text and exit.
32 .IR foo1 ", ..., " foo9 ", " foo10 ", ..., " foo278 ,
43 .IR foo001 ", ..., " foo009 ", " foo010 ", ..., " foo278 .
48 rename .htm .html *.htm
52 will fix the extension of your html files.
54 The renaming has no safeguards. If the user has permission to rewrite file names,
55 the command will perform the action without any questions. For example, the
56 result can be quite drastic when the command is run as root in the /lib
57 directory. Always make a backup before running the command, unless you truly
58 know what you are doing.
64 all requested rename operations were successful
67 all rename operations failed
70 some rename operations failed
76 unanticipated error occurred
82 The rename command is part of the util-linux package and is available from
83 ftp://ftp.kernel.org/pub/linux/utils/util-linux/.