[ новости /+++ | форум | теги | ]

Каталог документации / Раздел "Программирование, языки" / Оглавление документа

Открытие файла.

IN	comm	коммуникатор (дескриптор)
IN	filename	имя открываемого файла (строка)
IN	amode	тип доступа к файлу (целое)
IN	info	информационный объект (дескриптор)
OUT	fh	новый дескриптор файла (дескриптор)

int MPI_File_open(MPI_Comm comm, char *filename,
int amode, MPI_Info info, MPI_File *fh)
MPI_FILE_OPEN(COMM, FILENAME, AMODE, INFO, FH, IERROR)
CHARACTER*(*) FILENAME
INTEGER COMM, AMODE, INFO, FH, IERROR
static MPI::File MPI::File::Open(const MPI::Intracomm& comm,
const char* filename, int amode, const MPI::Info& info)

Формат для задания имени файла в filename зависит от реализации и для каждой конкретной реализации должен быть документирован.

Совет разработчикам: При реализации может требоваться, чтобы filename включал в себя строку или строки, задающие дополнительную информацию о файле. Примерами могут послужить тип файловой системы (например, префикс ufs:), имя удаленного сервера (например, префикс machine.univ.edu:), или пароль к файлу (например, постфикс /PASSWORD=SECRET). []

Совет пользователям:

В некоторых реализациях MPI имена файлов могут не совпадать в различных процессах. Например, ``/tmp/foo'' может обозначать в разных процессах разные файлы; в то же время файл может иметь различные имена в зависимости от расположения процесса. Ответственность за обеспечение того, чтобы файл соответствовал аргументу filename, лежит на пользователе, так как для реализации иногда невозможно обнаружить такого рода ошибки.[]

Изначально все процессы просматривают файл как линейный поток байтов, и каждый процесс просматривает данные в своем собственном представлении (не производится никаких преобразований представления). (Файлы POSIX являются линейными потоками байтов в родном представлении.) Вид файла может быть изменен посредством подпрограммы MPI_FILE_SET_VIEW.

Поддерживаются следующие типы доступа (задаваемые в amode, получаемом при применении OR к следующим целым константам):

• MPI_MODE_RDONLY -- только чтение,
• MPI_MODE_RDWR -- чтение и запись,
• MPI_MODE_WRONLY -- только запись,
• MPI_MODE_CREATE -- создавать файл, если он не существует,
• MPI_MODE_EXCL -- ошибка, если создаваемый файл уже существует,
• MPI_MODE_DELETE_ON_CLOSE -- удалять файл при закрытии,
• MPI_MODE_UNIQUE_OPEN -- файл не будет параллельно открыт где-либо еще,
• MPI_MODE_SEQUENTIAL -- файл будет доступен лишь последовательно,
• MPI_MODE_APPEND -- установить начальную позицию всех файловых указателей на конец файла.

Совет пользователям:

Пользователи Си/С++ могут использовать побитовую операцию ИЛИ (OR), чтобы объединить эти константы; пользователи ФОРТРАН90 могут использовать встроенную операцию IOR. Пользователи ФОРТРАН77 могут использовать (непереносимо на другие системы) побитовую операцию IOR на тех системах, которые ее поддерживают. Кроме этого, пользователи ФОРТРАН могут использовать (переносимо) целочисленное сложение, чтобы получить желаемый результат (каждая константа должна входить в сумму не более одного раза). []

Совет разработчикам: Значения данных констант должны быть определены таким образом, чтобы побитовое ИЛИ и сумма любого неповторяющегося набора из этих констант были эквивалентны. []

Типы доступа MPI_MODE_RDONLY,MPI_MODE_RDWR, MPI_MODE_WRONLY, MPI_MODE_CREATE, и
[]MPI_MODE_EXCL имеют семантику, идентичную их POSIX аналогам. Ровно один из типов
[]MPI_MODE_RDONLY, MPI_MODE_RDWR или MPI_MODE_WRONLY должен быть задан. Ошибочно определять MPI_MODE_CREATE или MPI_MODE_EXCL в сочетании с MPI_MODE_RDONLY; ошибочно также определять MPI_MODE_SEQUENTIAL вместе с MPI_MODE_RDWR.

Тип MPI_MODE_DELETE_ON_CLOSE вызывает удаление файла (эквивалент вызову MPI_FILE_DELETE), когда файл закрывается.

Тип MPI_MODE_UNIQUE_OPEN позволяет реализации оптимизировать доступ к файлу. Ошибочно открывать файл при помощи данного типа доступа, за исключением тех случаев, когда файл не будет параллельно открыт где-либо еще.

Совет пользователям:

Для MPI_MODE_UNIQUE_OPEN, не открыт где-либо еще включает в себя процессы как внутри среды MPI, так и вне ее. В частности, необходимо быть осведомленным о возможных внешних событиях, которые могут открывать файлы (например, автоматические системы создания резервных копий). Когда определен тип MPI_MODE_UNIQUE_OPEN, на пользователе лежит ответственность за то, чтобы никакие события такого рода не происходили. []

Тип MPI_MODE_SEQUENTIAL позволяет реализации оптимизировать доступ к некоторым последовательным устройствам (кассеты и сетевые потоки). Ошибочно пытаться произвести непоследовательный доступ к файлу, который был открыт с данным типом доступа.

Задание MPI_MODE_APPEND гарантирует только то, что при возврате из MPI_FILE_OPEN все общие и индивидуальные указатели на файл указывают на изначальный конец файла. Последующая установка положений файловых указателей зависит от приложения. В частности, реализация не обеспечивает добавления всех записей в конец файла.

Ошибки, связанные с типами доступа, генерируются в классе MPI_ERR_AMODE. Аргумент info используется для обеспечения информации относительно шаблонов доступа к файлам и специфики файловой системы (см. раздел File Info ). В случаях, когда не нужно определять эту информацию, может быть использована константа MPI_INFO_NULL.

Совет пользователям:

Некоторые файловые атрибуты зависят от атрибутов, присущих реализации (например, права доступа к файлам). Эти атрибуты должны быть установлены, используя или аргумент info, или средства вне оболочки MPI. []

Файлы по умолчанию открываются с использованием неатомарной семантики непротиворечивости (см. раздел File Consistency ). Более строгая атомарная семантика, необходимая для атомарности конфликтующих попыток доступа, может быть

установлена функцией MPI_FILE_SET_ATOMICITY.

Партнёры:

Хостинг: