Назва
rename - змінює назву і місцеположення файлу
Огляд
#include <stdio.h>
int rename(const char oldpath, const char newpath);
Опис
rename міняє назву файлу, переміщуючи його між директоріями, якщо необхідно.
Будь-які інші жорсткі посилання на файл (створених, наприклад, ?link(2)) залишаються незмінними.
Якщо newpath вже існує, його буде автоматично замінено (за кількома умовами - дивіться ПОМИЛКИ нижче), тож не буде такого моменту, коли якийсь процес, що намагається отримати доступ до файлу, не знайде його.
Якщо newpath існує, але операція з якоїсь причини зазнає невдачі, rename гарантує залишити один взірець newpath на місці.
Не зважаючи на це, під час перезапису може виявитись момент у якому oldpath і newpath, обидва, посилатумуться на файл, чия назва змінюється.
Якщо oldpath вказує на символічне посилання, останнє змінить назву; якщо newpath вказує на символічне посилання, його буде перезаписано.
Повернені значення
При вдалому виконанні повертається нуль, при помилці повертається -1 і змінна errno набуде відповідного значення.
Помилки
EISDIR newpath - це вже існуючий каталог, але oldpath не є каталогом.
EXDEV : newpath і oldpath не знаходяться на тій самій файловій системі.
ENOTEMPTY або EEXIST : newpath - це непорожній каталог, томбто містить об'єкти окрім "." або "..".
EBUSY : rename зазнав невдачі, оскільки oldpath або newpath є каталогом, використовуваним якомось процесом (напевне, як поточна робоча директорія, кореневий каталог або сиректорію відкрито для читання) або використовується системою (наприклад, як пункт приєднання інших файлових систем). Система вважає це помилкою. (Зауважте, що не вимагається повернення EBUSY в таких випадках - нічого не забороняє виконувати rename, EBUSY лише дозволяється повернути у випадках, якщо система не в змозі опрацювати такі ситуації.
EINVAL : Нова назва шляху, pathname, містить префікс шляху старої, або, більш узагальнено, відбулася спроба створення каталогу, як підкаталог самого себе.
EMLINK : oldpath вже має максимально-дозволене число посилань на себе, або це був каталог і каталог, що містить newpath має максимально-дозволене число посилань.
ENOTDIR : Складова, що була використана як назва каталогу для oldpath або newpath, насправді, не є такою. Або oldpath є каталогом, а newpath вже існує, але не як каталог.
EFAULT : oldpath або newpath вказують поза межі доступного простору адрес.
EACCES : Немає дозволу на запис каталогу, де міститься oldpath або newpath для дійсного UID процесу, або в одному з каталогів з oldpath або newpath не дозволяється пошук (не встановлений дозвіл на виконання), або oldpath - це каталог, в якому заборонено запис (необхідний для поновлення компоненти "..").
EPERM або EACCES : Каталог, що містить oldpath має встановленим стійкий біт і UID процесу не дорівнює ні ідентифікаційному номеру надкористувача ні UID файлу видалення, ні UID каталогу, де міститься oldpath, або newpath вже існує і каталог, де він міститься має встановленим стійкий біт з і UID процесу не дорівнює ні ідентифікаційному номеру надкористувача ні UID файлу до заміни, ні UID каталогу, де міститься newpath, або файлова система не підтримує зміни назв вказаного типу.
ENAMETOOLONG : Назви oldpath або newpath занадто довгі.
ENOENT : Каталогова складова oldpath або newpath не існує або ж це зависле символічне посилання.
ENOMEM : Недостатньо пам'яті ядра.
EROFS : Файл знаходиться на файловій системі тільки для читання.
ELOOP : Забагато символічних посилань при спробі розв'язання oldpath або newpath.
ENOSPC : Пристрій, де знаходиться файл, не має достатньо місця для створення нової директорії.
Відповідність стандартам
POSIX, 4.3BSD, ANSI C
Вади
На мережній файовій системі NFS, ви не можете бути певними, що якщо операція по зміні назви зазнала невдачі, файл не було перейменовано. Якщо сервер здійснив rename і дав збій, повторна передача RPC після того, як роботу серверу відновлено, спричинює вихід з ладу. Додаткам доводиться самим мати справу з такими ситуаціями. Дивіться ?link(2) щодо подібних помилок.