int rename(const char *oldpath, const char *newpath);
ОПИСАНИЕ
rename
переименовывает файл и, если требуется, перемещает его из одного каталога
в другой.
Все прочие "жесткие" ссылки на файл (созданные с помощью
link(2)),
не изменяются.
Если
newpath
уже существует, то он будет вновь записан (при определенных
условиях, см. ОШИБКИ ниже), так что неизвестны условия, при которых
другой процесс, пытающийся обратиться к
newpath,
не обнаружит его.
Если
newpath
существует, но операция завершается ошибкой или система аварийно
завершает работу,
rename
гарантирует, что
newpath
останется нетронутым.
При повторной записи, однако, есть вероятность, что
oldpath
и
newpath
будут ссылаться на один и тот же файл.
Если
oldpath
является символьной ссылкой, то она переименовывается; если
newpath
является символьной ссылкой, то будет вновь записан файл, на который
она указывает.
ВОЗВРАЩАЕМЫЕ ЗНАЧЕНИЯ
В случае успешного завершения вызова возвращается нулевое значение.
При ошибке возвращается -1, а переменной
errno
присваивается номер ошибки.
НАЙДЕННЫЕ ОШИБКИ
EISDIR
Каталог
newpath
существует, но
oldpath
не является каталогом.
EXDEV
oldpath и newpath
находятся в разных файловых системах.
ENOTEMPTY
newpath
является непустым каталогом.
EBUSY
newpath
существует и является текущим рабочим каталогом или корневым каталогом
какого-то процесса.
EEXIST
Новое имя пути совпадает с началом старого имени.
EINVAL
Попытка сделать каталог своим собственным подкаталогом.
EMLINK
oldpath
уже имеет максимальное количество ссылок, или
каталог, содержащий
newpath,
уже имеет максимальное количество ссылок.
ENOTDIR
Компонент, используемый как каталог в
oldpath или newpath
, в действительности не является каталогом.
EFAULT
oldpath или newpath
указывают на каталог за пределами доступного адресного пространства.
EACCES
Запись в каталог, содержащий
oldpath или newpath ,
запрещена для эффективного uid процесса, или один из каталогов в
oldpath или newpath
не позволяет производить поиск (выполнение), или
oldpath
был каталогом и не позволял запись в него информации для обновления
..).
EPERM
Каталог, содержащий
oldpath,
имеет sticky-бит, а эффективный uid процесса не равен ни uid файла,
который нужно удалить, ни uid каталога, который его содержит, или
файловая система, содержащая
pathname,
не поддерживает переименования запрошенного типа.
ENAMETOOLONG
Имена
oldpath или newpath
являются слишком длинными.
ENOENT
Одна из частей каталога, указанная в
oldpath или newpath
, не существует или является "висячей" символьной ссылкой.
ENOMEM
Ядру не хватило памяти для выполнения операции.
EROFS
Файл находится в файловой системе, предназначенной только для чтения.
ELOOP
oldpath или newpath
содержат зацикленную символьную ссылку, то есть при соответствующей подстановке
происходит ссылка на нее саму.
ENOSPC
В устройстве, содержащем файл, нет места для новой записи.
СООТВЕТСТВИЕ СТАНДАРТАМ
POSIX, 4.3BSD, ANSI C.
НАЙДЕННЫЕ ОШИБКИ
При работе с файловыми системами NFS нельзя считать, что
если операция завершилась неудачно, то имя файла
не изменилось. Если сервер производит операцию rename, а затем
аварийно останавливает свою работу, то перепосланный пакет RPC будет
вновь обработан при восстановлении работы сервера, что вызовет сообщение об ошибке.
Приложение в этой ситуации должно работать корректно. См.
link(2),
где описывается подобная проблема.
