CIF_GETFILEDIR(3)

NAME

Cif_Getfiledir - Retrieves the file directory for an open, sorted binary compiler information file (CIF)

SYNOPSIS

#define CIF_VERSION 2
#include <cif.h>
int Cif_Getfiledir (cifd, fdir)
int cifd;
struct Cif_filedir ∗∗fdir;

IMPLEMENTATION

All Sun SPARC systems

DESCRIPTION

The Cif_Getfiledir routine retrieves the file directory for the CIF identified by the descriptor.

The Cif_Getfiledir routine accepts the following arguments:

cifd CIF descriptor returned by the Cif_Open(3) routine.

fdir Sets the address of the file directory.

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_Getfiledir 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_BADFORM The CIF file has an incorrect format.

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_Filedir routine. The CIF descriptor is obtained by using the Cif_Open routine: int fd; struct Cif_filedir ∗filedir;

fd = Cif_Open(cifname, "r", (int ∗)0, CIF_VERSION);

Cif_Getfiledir(fd, &filedir);

Museum

Related Articles