Интерактивная система просмотра системных руководств (man-ов)
Cif_Getunitdir (3)
>> Cif_Getunitdir (3) ( Solaris man: Библиотечные вызовы )
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)
intcifd;
structCif_unittbl *utp;
structCif_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