💾 Archived View for mirrors.apple2.org.za › archive › ground.icaen.uiowa.edu › unix › Nulib.v324 › n… captured on 2023-01-29 at 11:02:40.
-=-=-=-=-=-=-
/*
* nuread.h - linked list structures used for holding NuFX header data,
* and structure definitions for archive innards
*
* NuLib v3.2 March 1992 Freeware (distribute, don't sell)
* By Andy McFadden (fadden@uts.amdahl.com)
*/
/*
* (this will be included by all source files which access NuFX archives)
*/
/* The NuFX master format version we output, and the maximum we can extract */
#define OURMVERS 2
#define MAXMVERS 2
/* The NuFX record format version we output, and the maximum we can extract */
#define OURVERS 0
#define MAXVERS 3
/* "NuFile" in alternating ASCII */
static onebyt MasterID[7] = { 0x4e, 0xf5, 0x46, 0xe9, 0x6c, 0xe5, 0x0 };
/* "NuFX" in alternating ASCII */
static onebyt RecordID[5] = { 0x4e, 0xf5, 0x46, 0xd8, 0x0 };
/*
* Structure definitions for NuFX innards
*/
/* master header block */
typedef struct {
onebyt ID[6];
twobyt master_crc;
fourbyt total_records;
Time arc_create_when;
Time arc_mod_when;
twobyt master_version;
onebyt reserved1[8];
fourbyt master_eof;
onebyt reserved2[6];
} MHblock;
#define MHsize 48 /* this should not change */
/* record header block */
typedef struct {
onebyt ID[4];
twobyt header_crc;
twobyt attrib_count;
twobyt version_number;
twobyt total_threads;
twobyt reserved1;
twobyt file_sys_id;
onebyt file_sys_info;
onebyt reserved2;
fourbyt access;
fourbyt file_type;
fourbyt extra_type;
twobyt storage_type;
Time create_when;
Time mod_when;
Time archive_when;
twobyt option_size;
/* future expansion here... */
} RHblock;
#define RHsize 58 /* sizeof(RHblock) should work, but might not */
#define ATTSIZE 64 /* default attrib_count when creating new */
/*
* This buffer must be able to contain three things (not all at once):
* - The master header block (size = MHsize)
* - The record header block (size = RHsize)
* - Attributes not specified in the RHblock (attrib_count - RHsize - 2)
*
* Currently, it only needs to be 64 bytes. Since it is allocated as local
* storage only once during execution, making it reasonably large should
* not cause any problems in performance but will make the program stable
* if it encounters an archive with a drastically expanded RHblock.
*/
#define RECBUFSIZ 256
/* thread record */
typedef struct {
twobyt thread_class;
twobyt thread_format;
twobyt thread_kind;
twobyt thread_crc;
fourbyt thread_eof;
fourbyt comp_thread_eof;
} THblock;
#define THsize 16 /* this should not change */
/*
* Definitions for the linked lists
* A linked list of Record headers, with linked lists of Threads attached
*/
/* thread nodes */
typedef struct TNode_s {
THblock *THptr; /* points to thread info */
long fileposn; /* absolute position of this thread in the file */
struct TNode_s *TNext; /* points to next thread node */
} TNode;
/* record nodes */
typedef struct RNode_s {
RHblock *RHptr; /* points to the record header block */
char *filename; /* filename of record */
twobyt filename_length; /* length of filename (as stored in record hdr) */
twobyt real_fn_length; /* length of filename (actual) */
TNode *TNodePtr; /* points to first thread node */
fourbyt unc_len; /* total uncompressed length of all threads */
fourbyt comp_len; /* total compressed length of all threads */
struct RNode_s *RNext; /* points to next record node */
} RNode;
/* head of list */
typedef struct {
char *arc_name; /* filename of archive */
MHblock *MHptr; /* points to master header */
RNode *RNodePtr; /* points to first record node */
long nextposn; /* abs. position in file to put next record (for ADD) */
} ListHdr;
/*
* function declarations
*/
extern ListHdr *NuRead(); /* read archive info into memory */
extern void NuTest(); /* archive integrity check */
extern twobyt CalcCRC(); /* calculate a CRC on a range of bytes */
extern char *PrintDate(); /* print a date from a (Time *) struct */
extern void BCopy(); /* copy bytes: *src, *dest, num, order? */
extern void HiSwap(); /* swap bytes (maybe): *ptr, src_index, dst_index */