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-2024 by Maxim Chirkov Добавить, Поддержать, Вебмастеру |