- bullseye-backports 4.18.1-1~bpo11+1
MKSTEMP(3) | Руководство программиста Linux | MKSTEMP(3) |
ИМЯ¶
mkstemp, mkostemp, mkstemps, mkostemps - создаёт временный файл с уникальным именем
СИНТАКСИС¶
#include <stdlib.h>
int mkstemp(char *template);
int mkostemp(char *template, int flags);
int mkstemps(char *template, int suffixlen);
int mkostemps(char *template, int suffixlen, int flags);
mkstemp():
|| /* начиная с glibc 2.12: */ _POSIX_C_SOURCE >= 200809L
|| /* версии glibc <= 2.19: */ _SVID_SOURCE || _BSD_SOURCE
mkostemp(): _GNU_SOURCE
mkstemps():
/* glibc начиная с
2.19: */ _DEFAULT_SOURCE
|| /* версии glibc <= 2.19: */
_SVID_SOURCE || _BSD_SOURCE
mkostemps(): _GNU_SOURCE
ОПИСАНИЕ¶
Функция mktemp() генерирует на основе шаблона template уникальное имя для временного файла, создаёт и открывает файл, после чего возвращает дескриптор открытого файла.
Последние шесть символов template должны быть равны "XXXXXX", они будут заменены на строку, которая сделает имя файла уникальным. Так как template будет меняться, он должна быть объявлен не строковой константой, а массивом символов.
Файл создается с правами 0600, то есть читать и записывать в него может только владелец. Возвращаемый дескриптор файла предоставляет доступ к файлу как на чтение, так и на запись. Файл открывается с помощью open(2) с флагом O_EXCL, что гарантирует, что вызывающий является процессом, создавшим файл.
Функция mkostemp() подобна mkstemp(), но отличие в том, что следующие биты (с теми же значениями что и для open(2)) могут быть указаны в flags: O_APPEND, O_CLOEXEC и O_SYNC. Заметим, что при создании файла mkostemp() включает значения O_RDWR, O_CREAT и O_EXCL в аргумент flags при вызове open(2); добавлять эти значения в аргумент flags при вызове mkostemp() необязательно и это приводит к ошибках в некоторых системах.
Функция mkstemps() похожа на mkstemp(), за исключением строки в template, которая содержит символы суффикса suffixlen. Таким образом, template будет приобретать вид prefixXXXXXXsuffix, а строка XXXXXX будет меняться так же, как и для mkstemp().
Функция mkostemps() является аналогом mkstemps(), подобно как mkostemp() является аналогом mkstemp().
ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ¶
При успешном выполнении данные функции возвращают дескриптор временного файла. В случае ошибки возвращается -1, а errno устанавливается в соответствующее значение.
ОШИБКИ¶
- EEXIST
- Невозможно создать уникальное имя временного файла. Содержимое template теперь не определено.
- EINVAL
- Для mkstemp() и mkostemp(): последние шесть символов template не равны XXXXXX. template не изменён.
- Для mkstemps() и mkostemps(): количество символов template меньше, чем (6 + suffixlen) или последние 6 символов до суффикса в template не равны XXXXXX.
Данные функции также могут завершиться ошибками, описанными в open(2).
ВЕРСИИ¶
mkostemp() впервые появилась в glibc 2.7. mkstemps() и mkostemps() доступны в glibc с версии 2.11.
АТРИБУТЫ¶
Описание терминов данного раздела смотрите в attributes(7).
Интерфейс | Атрибут | Значение |
mkstemp(), mkostemp(), mkstemps(), mkostemps() | Безвредность в нитях | MT-Safe |
СООТВЕТСТВИЕ СТАНДАРТАМ¶
mkstemp(): 4.3BSD, POSIX.1-2001.
mkstemps() не стандартизована, однако может присутствовать на некоторых системах.
mkostemp() и mkstemp(): являются расширениями glibc.
ЗАМЕЧАНИЯ¶
В версиях glibc 2.06 и ниже файл создавался с правами 0666, то есть читать и записывать в него могли все пользователи. Это старое поведение может быть небезопасным, особенно когда в других UNIX используются права 0600, и кто-то может не заметить это отличие при переносе программы. В POSIX.1-2008 добавлено требование, что файл должен создаваться с правами 0600.
В более общем смысле, в спецификации POSIX для mkstemp() ничего не сказано о правах на файл, поэтому программа должна сама проверить до вызова mkstemp() (и mkostemp()), что маска создания файла (смотрите umask(2)) уставлена в правильное значение.
СМ. ТАКЖЕ¶
ЗАМЕЧАНИЯ¶
Эта страница является частью проекта Linux man-pages версии 5.10. Описание проекта, информацию об ошибках и последнюю версию этой страницы можно найти по адресу https://www.kernel.org/doc/man-pages/.
ПЕРЕВОД¶
Русский перевод этой страницы руководства был сделан aereiae <aereiae@gmail.com>, Alexey <a.chepugov@gmail.com>, Azamat Hackimov <azamat.hackimov@gmail.com>, Dmitriy S. Seregin <dseregin@59.ru>, Dmitry Bolkhovskikh <d20052005@yandex.ru>, ITriskTI <ITriskTI@gmail.com>, Max Is <ismax799@gmail.com>, Yuri Kozlov <yuray@komyakino.ru>, Иван Павлов <pavia00@gmail.com> и Малянов Евгений Викторович <maljanow@outlook.com>
Этот перевод является бесплатной документацией; прочитайте Стандартную общественную лицензию GNU версии 3 или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.
Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо на man-pages-ru-talks@lists.sourceforge.net.
15 сентября 2017 г. | GNU |