PostgreSQL Source Code  git master
Go to the documentation of this file.
1 /*-------------------------------------------------------------------------
2  *
3  * buffile.h
4  * Management of large buffered temporary files.
5  *
6  * The BufFile routines provide a partial replacement for stdio atop
7  * virtual file descriptors managed by fd.c. Currently they only support
8  * buffered access to a virtual file, without any of stdio's formatting
9  * features. That's enough for immediate needs, but the set of facilities
10  * could be expanded if necessary.
11  *
12  * BufFile also supports working with temporary files that exceed the OS
13  * file size limit and/or the largest offset representable in an int.
14  * It might be better to split that out as a separately accessible module,
15  * but currently we have no need for oversize temp files without buffered
16  * access.
17  *
18  * Portions Copyright (c) 1996-2022, PostgreSQL Global Development Group
19  * Portions Copyright (c) 1994, Regents of the University of California
20  *
21  * src/include/storage/buffile.h
22  *
23  *-------------------------------------------------------------------------
24  */
26 #ifndef BUFFILE_H
27 #define BUFFILE_H
29 #include "storage/fileset.h"
31 /* BufFile is an opaque type whose details are not known outside buffile.c. */
33 typedef struct BufFile BufFile;
35 /*
36  * prototypes for functions in buffile.c
37  */
39 extern BufFile *BufFileCreateTemp(bool interXact);
40 extern void BufFileClose(BufFile *file);
41 extern size_t BufFileRead(BufFile *file, void *ptr, size_t size);
42 extern void BufFileWrite(BufFile *file, void *ptr, size_t size);
43 extern int BufFileSeek(BufFile *file, int fileno, off_t offset, int whence);
44 extern void BufFileTell(BufFile *file, int *fileno, off_t *offset);
45 extern int BufFileSeekBlock(BufFile *file, long blknum);
46 extern int64 BufFileSize(BufFile *file);
47 extern long BufFileAppend(BufFile *target, BufFile *source);
49 extern BufFile *BufFileCreateFileSet(FileSet *fileset, const char *name);
50 extern void BufFileExportFileSet(BufFile *file);
51 extern BufFile *BufFileOpenFileSet(FileSet *fileset, const char *name,
52  int mode, bool missing_ok);
53 extern void BufFileDeleteFileSet(FileSet *fileset, const char *name,
54  bool missing_ok);
55 extern void BufFileTruncateFileSet(BufFile *file, int fileno, off_t offset);
57 #endif /* BUFFILE_H */
void BufFileExportFileSet(BufFile *file)
Definition: buffile.c:389
size_t BufFileRead(BufFile *file, void *ptr, size_t size)
Definition: buffile.c:582
long BufFileAppend(BufFile *target, BufFile *source)
Definition: buffile.c:872
BufFile * BufFileOpenFileSet(FileSet *fileset, const char *name, int mode, bool missing_ok)
Definition: buffile.c:286
int BufFileSeekBlock(BufFile *file, long blknum)
Definition: buffile.c:800
void BufFileTell(BufFile *file, int *fileno, off_t *offset)
Definition: buffile.c:782
BufFile * BufFileCreateTemp(bool interXact)
Definition: buffile.c:188
void BufFileTruncateFileSet(BufFile *file, int fileno, off_t offset)
Definition: buffile.c:900
void BufFileWrite(BufFile *file, void *ptr, size_t size)
Definition: buffile.c:625
int BufFileSeek(BufFile *file, int fileno, off_t offset, int whence)
Definition: buffile.c:689
int64 BufFileSize(BufFile *file)
Definition: buffile.c:833
BufFile * BufFileCreateFileSet(FileSet *fileset, const char *name)
Definition: buffile.c:262
void BufFileClose(BufFile *file)
Definition: buffile.c:407
void BufFileDeleteFileSet(FileSet *fileset, const char *name, bool missing_ok)
Definition: buffile.c:359
const char * name
Definition: encode.c:561
static PgChecksumMode mode
Definition: pg_checksums.c:65
static rewind_source * source
Definition: pg_rewind.c:81
FileSet * fileset
Definition: buffile.c:80