'\" t
.\"     Title: rename
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.20
.\"      Date: 2024-05-14
.\"    Manual: User Commands
.\"    Source: util-linux 2.40.1
.\"  Language: English
.\"
.TH "RENAME" "1" "2024-05-14" "util\-linux 2.40.1" "User Commands"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "BEZEICHNUNG"
rename \- Dateien umbenennen
.SH "ÜBERSICHT"
.sp
\fBrename\fP [options] \fIexpression replacement file\fP...
.SH "BESCHREIBUNG"
.sp
\fBrename\fP will rename the specified files by replacing the first occurrence of \fIexpression\fP in their name by \fIreplacement\fP.
.SH "OPTIONEN"
.sp
\fB\-s\fP, \fB\-\-symlink\fP
.RS 4
benennt einen symbolischen Links nicht um, aber ändert das Ziel, auf das er verweist.
.RE
.sp
\fB\-v\fP, \fB\-\-verbose\fP
.RS 4
zeigt welche Dateien umbenannt wurden, falls vorhanden.
.RE
.sp
\fB\-n\fP, \fB\-\-no\-act\fP
.RS 4
nimmt keine Änderungen vor; fügen Sie \fB\-\-verbose\fP hinzu, um zu sehen, was geändert werden würde.
.RE
.sp
\fB\-a\fP, \fB\-\-all\fP
.RS 4
ersetzt alle Vorkommen des angegebenen \fIAusdrucks\fP, anstatt nur das erste Vorkommen zu ersetzen.
.RE
.sp
\fB\-l\fP, \fB\-\-last\fP
.RS 4
ersetzt das letzte Vorkommen des angegebenen \fIAusdrucks\fP anstatt des ersten.
.RE
.sp
\fB\-o\fP, \fB\-\-no\-overwrite\fP
.RS 4
überschreibt bestehende Dateien nicht. Wenn \fB\-\-symlink\fP aktiv ist, werden Symlinks, die auf bestehende Ziele zeigen, nicht überschrieben.
.RE
.sp
\fB\-i\fP, \fB\-\-interactive\fP
.RS 4
fragt nach, bevor vorhandene Dateien überschrieben werden.
.RE
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
zeigt einen Hilfetext an und beendet das Programm.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
zeigt Versionsinformationen an und beendet das Programm.
.RE
.SH "WARNUNG"
.sp
Für die Umbenennung gibt es außer den Optionen \fB\-\-no\-overwrite\fP, \fB\-\-interactive\fP oder \fB\-\-no\-act\fP keine eingebauten Sicherheitsmechanismen. Sofern der Benutzer über das Recht verfügt, Dateinamen zu ändern, wird die Aktion ohne Rückfrage ausgeführt. Das kann drastische Folgen haben, wenn der Befehl beispielsweise im Verzeichnis \fI/lib\fP mit Administratorrechten ausgeführt wird. Sichern Sie vor dem Aufruf des Befehls Ihre Daten, es sei denn, Sie wissen genau, was Sie tun.
.SH "GRENZFÄLLE"
.sp
Falls der \fIAusdruck\fP leer ist, wird die vorgegebene \fIErsetzung\fP am Anfang des Dateinamens eingefügt. Mit \fB\-\-all\fP wird die \fIErsetzung\fP überall zwischen jeweils Zeichen eingefügt sowie dem Dateinamen vorangestellt als auch daran angehängt.
.sp
Normalerweise wird nur die letzte Pfadkomponente eines Dateinamens aktualisiert (oder mit \fB\-\-symlink\fP nur die letzte Pfadkomponente des Links). Falls jedoch entweder der \fIAusdruck\fP oder die \fIErsetzung\fP einen Schrägstrich (\fI/\fP) enthalten, wir der vollständige Pfad aktualisiert. Dies kann dazu führen, dass Dateien innerhalb einer Verzeichnisstruktur verschoben werden. Die Erstellung von Verzeichnissen und das Verschieben von Dateien über Dateisystemgrenzen hinweg wird nicht unterstützt.
.SH "INTERAKTIVER MODUS"
.sp
Wie die meisten Standardwerkzeuge kann Rename im kanonischen Modus mit einem Terminal\-Gerät verwendet werden (kurz TTY), wobei die Zeile vom TTY gepuffert wird und Sie die EINGABETASTE drücken müssen, um die Benutzereingabe zu bestätigen. Wenn Sie Ihr TTY in den Cbreak\-Modus versetzen, erfordert Rename nur einen einzigen Tastendruck, um auf die Eingabeaufforderung zu antworten. Um den Cbreak\-Modus zu setzen, führen Sie beispielsweise Folgendes aus:
.sp
.if n .RS 4
.nf
.fam C
sh \-c \*(Aqstty \-icanon min 1; "$0" "$@"; stty icanon\*(Aq rename \-i from to files
.fam
.fi
.if n .RE
.SH "EXIT\-STATUS"
.sp
\fB0\fP
.RS 4
Alle angeforderten Umbenennungen wurden erfolgreich ausgeführt.
.RE
.sp
\fB1\fP
.RS 4
Alle angeforderten Umbenennungen sind gescheitert.
.RE
.sp
\fB2\fP
.RS 4
Einige der angeforderten Umbenennungen sind gescheitert.
.RE
.sp
\fB4\fP
.RS 4
Es wurde nichts umbenannt.
.RE
.sp
\fB64\fP
.RS 4
Es ist ein unvorhergesehener Fehler aufgetreten.
.RE
.SH "BEISPIELE"
.sp
Für die Dateien \fIfoo1\fP, ..., \fIfoo9\fP, \fIfoo10\fP, ..., \fIfoo278\fP benennen die Befehle
.sp
.if n .RS 4
.nf
.fam C
rename foo foo00 foo?
rename foo foo0 foo??
.fam
.fi
.if n .RE
.sp
in \fIfoo001\fP, ..., \fIfoo009\fP, \fIfoo010\fP, ..., \fIfoo278\fP um. Der Befehl
.sp
.if n .RS 4
.nf
.fam C
rename .htm .html *.htm
.fam
.fi
.if n .RE
.sp
gleicht die Endung Ihrer HTML\-Dateien an. Zum Kürzen geben Sie eine leere Zeichenkette an:
.sp
.if n .RS 4
.nf
.fam C
rename \*(Aq_mit_langem_Namen\*(Aq \*(Aq\(rs&\*(Aq Datei_mit_langem_Namen.*
.fam
.fi
.if n .RE
.sp
entfernt die Teilzeichenkette in den Dateinamen.
.SH "SIEHE AUCH"
.sp
\fBmv\fP(1)
.SH "FEHLER MELDEN"
.sp
Nutzen Sie zum Melden von Fehlern das Fehlererfassungssystem auf \c
.URL "https://github.com/util\-linux/util\-linux/issues" "" "."
.SH "VERFÜGBARKEIT"
.sp
Der Befehl \fBrename\fP ist Teil des Pakets util\-linux, welches aus dem \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "Linux\-Kernel\-Archiv" ""
heruntergeladen werden kann.