/*
 * large_object.h - file of info for Postgres large objects
 *
 * /usr/local/devel/postgres-v4r2/src/backend/utils/RCS/large_object.h,v 1.12 1994/02/17 03:29:23 sklower Exp
 */

#include "tmp/c.h"

#define LARGE_OBJECT_BLOCK 1024

/*
 * This is the structure that goes in a tuple for large objects.
 */

typedef union
{
	char filename[1];
	char object_relname[1];
}
LargeObjectDataPtr;

/*
 * PURE_FILE indicates that a large object is strictly stored as a user
 * file and Postgres simply points to it.  This is good for large object
 * applications that use other files, but has no transaction semantics,
 * security, crash recover, etc.
 */

#define PURE_FILE	0 

/*
 * VERSIONED_FILE indicates that a large object is stored in the form of a
 * base object with a succeeding string of large object delta's, which are
 * new or replacement block numbers.
 */

#define VERSIONED_FILE	1 

/*
 * CLASS_FILE is a large object that is stored essentially as a Postgres
 * complex object.  Each block of the file is stored in a tuple.
 */

#define CLASS_FILE	2 

/*
 * Other large object schemes can be thought of - their numbering
 * should go here.
 */
#define EXTERNAL_FILE	3
#define JAQUITH_FILE	4

/*
 * !! VARIABLE LENGTH STRUCTURE !!
 */

typedef struct
{
/*
 * Length of this structure - this structure is treated as a Variable Length
 * Attribute by the Postgres access methods.
 */

	int32 lo_length;

/*
 * Large object storage type - described above.
 */
	long lo_storage_type;

/*
 * Ignored if the object is _not_ a versioned file
 */

	long lo_nblocks;
	short lo_lastoff, lo_version;

/*
 * Pointer to large object data - may be a filename or relation name
 */
	LargeObjectDataPtr lo_ptr;
}
LargeObject;

/*
 * This structure will eventually have lots more stuff associated with it.
 */

typedef struct
{
	union {
	    struct unix_fs {
		int fd;			/* Postgres virtual file descriptor */
		int seekPos;		/* ONLY FOR JAQUITH!!!  (future use) */
		int dirty;    /* ONLY FOR JAQUITH  Has file been written to? */
	    } u_fs;

	    struct inversion_fs {
		Relation heap_r;	/* heap relation */
		Relation index_r;	/* index relation on seqno attribute */
		IndexScanDesc iscan;	/* index scan we're using */
		TupleDescriptor hdesc;	/* heap relation tuple desc */
		TupleDescriptor idesc;	/* index relation tuple desc */
		uint32 lowbyte;		/* low byte on the current page */
		uint32 highbyte;	/* high byte on the current page */
		uint32 offset;		/* current seek pointer */
		ItemPointerData htid;	/* tid of current heap tuple */

#define IFS_RDLOCK	(1 << 0)
#define IFS_WRLOCK	(1 << 1)
#define IFS_ATEOF	(1 << 2)

		u_long flags;		/* locking info, etc */

	    } i_fs;
	} ofs;
	LargeObject *object;
}
LargeObjectDesc;

/*
 * Function definitions...
 */

/*
 * external registered function interface 
 */

char *
lo_filein ARGS((
	char *filename
));


char *
lo_fileout ARGS((
    LargeObject *object
));

/* 
 * internal large object interface
 */

LargeObjectDesc *
LOCreate ARGS((
   char *path,
   int open_mode
));

#ifdef JAQUITH

LargeObjectDesc *
JOCreate ARGS((
   char *path,
   int open_mode
));

#endif  /* JAQUITH */

LargeObjectDesc *
LOOpen ARGS((
    LargeObject *object,
    int open_mode
));

#ifdef JAQUITH
LargeObjectDesc *
JOOpen ARGS((
    LargeObject *object,
    int open_mode
));

#endif /* JAQUITH */

void
LOStat ARGS((
    LargeObjectDesc *obj_desc,
    unsigned int *nblocks,
    unsigned int *byte_offset
));

int
LOBlockRead ARGS((
    LargeObjectDesc *obj_desc,
    char *buf,
    unsigned long nblocks
));

int
LOBlockWrite ARGS((
    LargeObjectDesc *obj_desc,
    char *buf,
    unsigned long n_whole_blocks,
    unsigned long bytes_at_end
));

unsigned long
LOBlockSeek ARGS((
	LargeObjectDesc *obj_desc,
	unsigned long offset,
	int whence
));

void
LOClose ARGS((
    LargeObjectDesc *obj_desc
));

#ifdef JAQUITH
void
JOClose ARGS((
    LargeObjectDesc *obj_desc
));

#endif  /* JAQUITH */

void
LODestroy ARGS((
    LargeObject *object
));

LargeObject *
LODescToObject ARGS((
    LargeObjectDesc *obj_desc
));

#ifdef JAQUITH

char *
JO_path ARGS((
    char *name
));

char *
JO_arch ARGS((
    char *name
));

int
JO_get ARGS((
    char *name
));

int 
JO_put ARGS((
    char *name
));


#endif  /* JAQUITH */