8292383df7
mandoc: ./misc-utils/cal.1:214:2: WARNING: skipping paragraph macro: br after sp mandoc: ./misc-utils/cal.1:216:2: WARNING: skipping paragraph macro: br before sp mandoc: ./misc-utils/cal.1:225:2: WARNING: skipping paragraph macro: PP after SH mandoc: ./misc-utils/findfs.8:36:2: WARNING: skipping paragraph macro: br after sp mandoc: ./misc-utils/findfs.8:38:2: WARNING: skipping paragraph macro: br before sp mandoc: ./misc-utils/findfs.8:41:2: WARNING: skipping paragraph macro: br before sp mandoc: ./misc-utils/findfs.8:44:2: WARNING: skipping paragraph macro: br before sp mandoc: ./misc-utils/findfs.8:48:2: WARNING: skipping paragraph macro: PP empty mandoc: ./misc-utils/logger.1:118:15: STYLE: unterminated quoted argument mandoc: ./misc-utils/logger.1:231:2: WARNING: skipping paragraph macro: IP empty mandoc: ./misc-utils/look.1:116:2: STYLE: fill mode already disabled, skipping: nf mandoc: ./misc-utils/hardlink.1:1:5: STYLE: lower case character in document title: TH hardlink mandoc: ./misc-utils/hardlink.1:1:2: WARNING: missing date, using today's date: TH mandoc: ./misc-utils/hardlink.1:9:2: WARNING: skipping paragraph macro: PP after SH mandoc: ./misc-utils/hardlink.1:52:2: WARNING: skipping paragraph macro: PP after SH mandoc: ./misc-utils/hardlink.1:65:2: WARNING: skipping paragraph macro: PP after SH mandoc: ./misc-utils/rename.1:65:2: WARNING: skipping paragraph macro: PP empty mandoc: ./misc-utils/rename.1:65:2: WARNING: skipping paragraph macro: PP empty mandoc: ./misc-utils/rename.1:97:2: WARNING: skipping paragraph macro: PP empty mandoc: ./misc-utils/rename.1:107:2: WARNING: skipping paragraph macro: PP empty mandoc: ./misc-utils/rename.1:116:2: WARNING: skipping paragraph macro: PP empty mandoc: ./misc-utils/whereis.1:82:2: WARNING: line scope broken: IP breaks TP mandoc: ./misc-utils/whereis.1:152:2: WARNING: skipping paragraph macro: PP empty #### There is no change in the ouput of "nroff" or "groff", except for 1) a very long line in "logger.1". 2) '-' changed to '\-' for a option in "logger.1". Signed-off-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
122 lines
2.7 KiB
Groff
122 lines
2.7 KiB
Groff
.\" Written by Andries E. Brouwer (aeb@cwi.nl)
|
|
.\" Placed in the public domain
|
|
.\"
|
|
.TH RENAME 1 "June 2011" "util-linux" "User Commands"
|
|
.SH NAME
|
|
rename \- rename files
|
|
.SH SYNOPSIS
|
|
.B rename
|
|
[options]
|
|
.IR "expression replacement file" ...
|
|
.SH DESCRIPTION
|
|
.B rename
|
|
will rename the specified files by replacing the first occurrence of
|
|
.I expression
|
|
in their name by
|
|
.IR replacement .
|
|
.SH OPTIONS
|
|
.TP
|
|
.BR \-s , " \-\-symlink"
|
|
Do not rename a symlink but its target.
|
|
.TP
|
|
.BR \-v , " \-\-verbose"
|
|
Show which files were renamed, if any.
|
|
.TP
|
|
.BR \-n , " \-\-no\-act"
|
|
Do not make any changes; add
|
|
.B \-\-verbose
|
|
to see what would be made.
|
|
.TP
|
|
.BR \-o , " \-\-no\-overwrite"
|
|
Do not overwrite existing files. When
|
|
.B \-\-symlink
|
|
is active, do not overwrite symlinks pointing to existing targets.
|
|
.TP
|
|
.BR \-i , " \-\-interactive"
|
|
Ask before overwriting existing files.
|
|
.TP
|
|
.BR \-V , " \-\-version"
|
|
Display version information and exit.
|
|
.TP
|
|
.BR \-h , " \-\-help"
|
|
Display help text and exit.
|
|
.SH WARNING
|
|
The renaming has no safeguards by default or without any one of the options
|
|
.B \-\-no-overwrite\fR,
|
|
.B \-\-interactive
|
|
or
|
|
.B \-\-no\-act\fR.
|
|
If the user has
|
|
permission to rewrite file names, the command will perform the action without
|
|
any questions. For example, the result can be quite drastic when the command
|
|
is run as root in the /lib directory. Always make a backup before running the
|
|
command, unless you truly know what you are doing.
|
|
.SH INTERACTIVE MODE
|
|
As most standard utilities rename can be used with a terminal device (tty in
|
|
short) in canonical mode, where the line is buffered by the tty and you press
|
|
ENTER to validate the user input. If you put your tty in cbreak mode however,
|
|
rename requires only a single key press to answer the prompt. To set cbreak
|
|
mode, run for example:
|
|
.PP
|
|
.RS
|
|
.nf
|
|
sh \-c 'stty \-icanon min 1; "$0" "$@"; stty icanon' rename \-i from to files
|
|
.fi
|
|
.RE
|
|
.SH EXIT STATUS
|
|
.RS
|
|
.PD 0
|
|
.TP
|
|
.B 0
|
|
all requested rename operations were successful
|
|
.TP
|
|
.B 1
|
|
all rename operations failed
|
|
.TP
|
|
.B 2
|
|
some rename operations failed
|
|
.TP
|
|
.B 4
|
|
nothing was renamed
|
|
.TP
|
|
.B 64
|
|
unanticipated error occurred
|
|
.PD
|
|
.RE
|
|
.SH EXAMPLES
|
|
Given the files
|
|
.IR foo1 ", ..., " foo9 ", " foo10 ", ..., " foo278 ,
|
|
the commands
|
|
.PP
|
|
.RS
|
|
.nf
|
|
rename foo foo00 foo?
|
|
rename foo foo0 foo??
|
|
.fi
|
|
.RE
|
|
.PP
|
|
will turn them into
|
|
.IR foo001 ", ..., " foo009 ", " foo010 ", ..., " foo278 .
|
|
And
|
|
.PP
|
|
.RS
|
|
.nf
|
|
rename .htm .html *.htm
|
|
.fi
|
|
.RE
|
|
.PP
|
|
will fix the extension of your html files.
|
|
Provide an empty string for shortening:
|
|
.PP
|
|
.RS
|
|
.nf
|
|
rename '_with_long_name' '' file_with_long_name.*
|
|
.fi
|
|
.RE
|
|
.PP
|
|
will remove the substring in the filenames.
|
|
.SH SEE ALSO
|
|
.BR mv (1)
|
|
.SH AVAILABILITY
|
|
The rename command is part of the util-linux package and is available from
|
|
https://www.kernel.org/pub/linux/utils/util-linux/.
|