LDOPEN(3X)

НАЗВАНИЕ
ldopen, ldaopen - открыть объектный файл обычного формата на чтение

СИНТАКСИС

	#include <stdio.h>

	#include <filehdr.h>

	#include <ldfcn.h>



	LDFILE *ldopen (filename, ldptr)

	char *filename;

	LDFILE *ldptr;



	LDFILE *ldaopen (filename, oldptr)

	char *filename;

	LDFILE *oldptr;

ОПИСАНИЕ
Функции ldopen и ldclose(3X) обеспечивают унифицированный доступ как к отдельным объектным файлам, так и к объектным файлам, входящим в состав архивов. С помощью этих функций архив объектных файлов может быть обработан так, как если бы он был последовательностью отдельных объектных файлов обычного формата.

Если аргумент ldptr имеет значение NULL, функция ldopen открывает файл filename, размещает и инициализирует структуру LDFILE и возвращает указатель на эту структуру.

Если значение ldptr соответствует открытому файлу и TYPE (ldptr) является магическим числом архивного файла, ldopen инициализирует стуктуру LDFILE для обработки следующего элемента архива filename.

Функции ldopen и ldclose(3X) предназначены для совместной работы. Ldclose возвращает значение FAILURE только в том случае, когда TYPE (ldptr) является магическим числом архива и в архиве еще есть необработанные файлы. В этом единственном случае можно вызывать ldopen с текущим значением ldptr. Во всех других случаях, в частности, когда открывается файл с новым именем, следует вызывать ldopen с аргументом ldptr, равным NULL.

Схема использования ldopen и ldclose(3X) такова:

	/* Для каждого из обрабатываемых файлов */



	ldptr = NULL;

	do {

	  if ((ldptr = ldopen (filename, ldpr)) == NULL) {

	    /* Проверить магическое число */

	    /* Обработать файл */

	  }

	} while (ldclose (ldptr) == FAILURE);

Функция ldaopen служит для повторного открытия объектного файла. Если значение oldptr отлично от NULL, ldaopen заново открывает файл с именем filename, порождает новую структуру LDFILE, копируя из структуры, указанной в oldptr, поля TYPE, OFFSET и HEADER, и возвращает указатель на новую структуру. Старый указатель oldptr и новый указатель могут быть использованы одновременно и независимо для чтения разных частей объектного файла. Например, один из указателей может последовательно продвигаться по информации о настройке ссылок, а другой - по элементам таблицы имен.

Функции ldopen и ldaopen открывают файл на чтение. Обе функции возвращают NULL, если файл filename открыть не удается, или если под структуру LDFILE не хватает памяти. Успешное открытие не гарантирует, что указанный файл является объектным.

При редактировании связей вызывающей программы следует подключить библиотеку программ доступа к объектным файлам libld.a.

СМ. ТАКЖЕ
fopen(3S), ldclose(3X), ldfcn(4).