NAME
Cif_Getunitdir - Retrieves the unit directory for the
requested unit, from an open, sorted binary compiler infor-
mation file (CIF)
SYNOPSIS
#define CIF_VERSION 2
#include <cif.h>
int Cif_Getunitdir (cifd, utp, unitdir)
int cifd;
struct Cif_unittbl *utp;
struct Cif_unitdir **unitdir;
IMPLEMENTATION
All Sun SPARC systems
DESCRIPTION
The Cif_Getunitdir routine retrieves the unit directory for
the CIF identified by the descriptor and by the unit table.
The Cif_Getunitdir routine accepts the following arguments:
cifd Specifies the CIF descriptor returned by the
Cif_Open(3) routine.
utp Specifies the unit table pointer set by the
Cif_Getfiledir(3) routine.
unitdir
Specifies the address of the unit directory retrieved
by this routine.
CIF_VERSION defines the library version. The default is 1.
The newest version is 2 and should be used with this rou-
tine.
CIFs are initially ASCII, but when passed through cifconv(1)
or when the Cif_Cifconv(3) routine is used, they are con-
verted to sorted binary; then the Cif_Getunitdir routine may
be used.
See the Cif(3) man page for a discussion about CIF informa-
tion, format, and versions.
RETURN VALUES
A zero value indicates success.
A negative value indicates an error condition. The error
condition can be identified with the following symbolic con-
stants:
Symbolic Constant Description
CIF_BADREQ The requested function cannot be per-
formed.
CIF_NOMEM A problem was encountered while acquir-
ing memory.
CIF_NOTOPEN The CIF file descriptor is not an open
file.
CIF_SYSERR An error occurred while calling a system
routine.
EXAMPLES
The following is an example of using the Cif_Getunitdir rou-
tine. It uses the address of the file directory that was
obtained by using the Cif_Filedir routine. int fd; struct
Cif_filedir *filedir; struct Cif_unitdir *unitdir;
fd = Cif_Open(cifname, "r", (int *)0, CIF_VERSION);
Cif_GetFiledir(fd, &filedir);
Cif_Getunitdir(fd, filedir->ut, &unitdir);
SEE ALSO
Cif(3) for general information about CIFs
Cif_Close(3), Cif_Duplicate(3), Cif_Errstring(3),
Cif_Free(3), Cif_Getpos(3), Cif_Getrecord(3),
Cif_Memmode(3), Cif_Msginsert(3), Cif_Open(3),
Cif_Release(3), Cif_Setpos(3) for information about general
CIF library routines
Cif_Getfiledir(3), Cif_Recgroup(3) for information about
binary-format specific CIF library routines
cifconv(1) for information about ASCII to binary format
conversion in the
Compiler information file CIF Compiler information Compiler
listings
|
Закладки на сайте Проследить за страницей |
Created 1996-2025 by Maxim Chirkov Добавить, Поддержать, Вебмастеру |