CIF_GETUNITDIR(3)

NAME

Cif_Getunitdir - Retrieves the unit directory for the requested unit, from an open, sorted binary compiler information 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 routine.

CIFs are initially ASCII, but when passed through cifconv(1) or when the Cif_Cifconv(3) routine is used, they are converted to sorted binary; then the Cif_Getunitdir routine may be used.

See the Cif(3) man page for a discussion about CIF information, 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 constants:

Symbolic Constant Description

CIF_BADREQ The requested function cannot be performed.

CIF_NOMEM A problem was encountered while acquiring 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 routine. 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);

Museum

Related Articles