.\" Hey Emacs! This file is -*- nroff -*- source.
.\"
.\" This manpage is Copyright (C) 1992 Drew Eckhardt;
.\"                               1993 Michael Haardt;
.\"                          1993,1995 Ian Jackson.
.\"
.\" Permission is granted to make and distribute verbatim copies of this
.\" manual provided the copyright notice and this permission notice are
.\" preserved on all copies.
.\"
.\" Permission is granted to copy and distribute modified versions of this
.\" manual under the conditions for verbatim copying, provided that the
.\" entire resulting derived work is distributed under the terms of a
.\" permission notice identical to this one
.\" 
.\" Since the Linux kernel and libraries are constantly changing, this
.\" manual page may be incorrect or out-of-date.  The author(s) assume no
.\" responsibility for errors or omissions, or for damages resulting from
.\" the use of the information contained herein.  The author(s) may not
.\" have taken the same level of care in the production of this manual,
.\" which is licensed free of charge, as they might when working
.\" professionally.
.\" 
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
.\" Modified Sat Jul 24 00:35:52 1993 by Rik Faith (faith@cs.unc.edu)
.\" German Translation Tue Mar 29 20:25:00 1996 Elmar Jansen (ej@pumuckel.gun.de)
.\" Modified Mon Jun 10 13:32:10 1996 by Martin Schulze (joey@linux.de)
.\"
.TH RENAME 2 "29 Mrz 1996" "Linux" "Systemaufrufe"
.SH BEZEICHNUNG
rename \- ndert den Namen oder die Lage einer Datei
.SH BERSICHT
.B #include <unistd.h>
.sp
.BI "int rename(const char *" oldpath ", const char *" newpath );
.SH BESCHREIBUNG
.B rename
benennt eine Datei um, wobei sie gegebenenfalls in ein anderes
Verzeichnis verlegt werden kann.

Andere Hardlinks der Datei (angelegt mit
.BR link )
bleiben davon unberhrt.

Wenn
.I newpath
schon existiert wird er berschrieben (fr Ausnahmen siehe Abschnitt
FEHLER), so da kein anderer Prozes^ der versucht 
.I newpath 
zu erreichen, diesen nicht findet.

Wenn
.I newpath
schon existiert aber das Umbenennen aus irgendeinem Grund fehlschlgt,
oder das System crasht, garantiert
.B rename
das 
.I newpath
vorhanden erhalten bleibt.

Beim ndern gibt es ein Zeitfenster zu dem sowohl
.I oldpath
als auch
.I newpath
auf die Datei zeigen die umbenannt werden soll.

Wenn
.I oldpath
auf einen symbolischen Link zeigt wird der Link umbenannt; wenn
.I newpath
auf einen symbolischen Link zeigt wird der Link berschrieben.
.SH "RCKGABEWERT"
Bei Erfolg wird Null zurckgegeben.  Bei einem Fehler wird \-1 zurckgegeben
und
.I errno
entsprechend gesetzt.
.SH FEHLER
.TP 0.8i
.B EISDIR
.I newpath
ist ein vorhandenes Directory aber
.I oldpath
ist kein vorhandenes Directory.
.TP
.B EXDEV
.IR oldpath " und " newpath
befinden sich nicht im gleichen Filesystem.
.TP
.B ENOTEMPTY
.IR newpath
ist ein Directory das nicht leer ist.
.TP
.B EBUSY
.I newpath
ist ein vorhandenes Directory und ist aktuelles Directory oder Root
Directory eines Prozesses.
.TP
.B EINVAL
Es wurde versucht ein Directory als Subdiretory von sich selbst zu erzeugen.
.TP
.B EMLINK
.I oldpath
hat schon die maximale Anzahl Links, oder es ist ein Directory und das 
Directory welches 
.I newpath 
enthlt hat schon die maximale Anzahl Links.
.TP
.B ENOTDIR
Ein Teil des Directory
.IR oldpath " oder " newpath
ist in Wirklichkeit kein Directory.
.TP
.B EFAULT
.IR oldpath " oder " newpath " zeigt auerhalb des Benutzer-Adressraums."
.TP
.B EACCES
Die effektive uid des Prozesses hat kein Schreibrecht in dem Directory in dem
.IR oldpath " oder " newpath
angelegt werden soll, oder eines der Directory's
.IR oldpath " oder " newpath
verbietet das Suchen (execute permission fehlt), oder 
did not allow search (execute) permission, or
.I oldpath
ist ein Directory und hat keine Schreibberechtigung (wird zum ndern des
.B ..
bentigt).
.TP
.B EPERM
Das Directory welches
.I oldpath 
enthlt
hat das Sticky Bit gesetzt und die effektive Userid des Prozesses ist
ungleich der Userid der Datei die gelscht werden soll , oder das
Dateisystem welches
.IR pathname
enthlt erlaubt nicht das Umbenenen einer Datei.
.TP
.B ENAMETOOLONG
.IR oldpath " oder " newpath " sind zu lang."
.TP
.B ENOENT
Eine Komponente des Directory's
.I oldpath " oder " newpath
existiert nicht oder ist ein unsicherer symbolischer Link.
.TP
.B ENOMEM
Es war nicht gengend Kernel-Memory verfgbar.
.TP
.B EROFS
Die Datei ist in einem nur lesbaren Dateisystem.
.TP
.B ELOOP
.IR oldpath " oder " newpath
beinhalten einen Verweis auf einen kreisenden symbolischen Link,
beziehungsweise auf einen symbolischen Link der auf sich selbst
verweist.
.TP
.B ENOSPC
Die Gertedatei die die Datei enthlt hat keinen Platz fr einen
neuen Directoryeintrag.
.SH "KONFORM ZU"
POSIX, BSD 4.3, ANSI C
.SH BUGS
Momentan (Linux 0.99pl7) erlauben die meisten Dateisysteme auer Minix
kein berschreiben.  Sie erhalten beim Versuch
.BR EEXIST .

Auf NFS Dateisystemen kann bei einer fehlgeschlagenen Operation nicht
davon ausgegangen werden das die Datei nicht umbenannt wurde.  Wenn der
Server die Datei umbenennt und dann crasht, gibt der RPC einen Fehler
zurck.  Die Applikation mu dies bercksichtigen.  Siehe
.IR link (2)
fr ein hnliches Problem.
.SH "SIEHE AUCH"
.BR link (2),
.BR unlink (2),
.BR symlink (2),
.BR mv (1),
.BR link (8).