mirror of
https://github.com/postgres/postgres.git
synced 2025-10-25 13:17:41 +03:00
05cbd6cb22
When pg_nodiscard was first added, the C standard draft had it as a function specifier, and so the code comment about placement was written with that in mind. The final C23 standard has it as an attribute and the placement rules are a bit different for that. Specifically, it needs to be before extern or static. (Or at least both current clang and gcc require that.) So just swap these. (To be clear: The current implementation with gcc attributes doesn't care. This change is just for maximum forward compatibility for non-gcc compilers.) This also keeps the order consistent with the previously introduced pg_noreturn. Also update the code comment to reflect the mentioned developments since its introduction. Reviewed-by: Dagfinn Ilmari Mannsåker <ilmari@ilmari.org> Reviewed-by: Andres Freund <andres@anarazel.de> Discussion: https://www.postgresql.org/message-id/flat/pxr5b3z7jmkpenssra5zroxi7qzzp6eswuggokw64axmdixpnk@zbwxuq7gbbcw
60 lines
2.4 KiB
C
60 lines
2.4 KiB
C
/*-------------------------------------------------------------------------
|
|
*
|
|
* buffile.h
|
|
* Management of large buffered temporary files.
|
|
*
|
|
* The BufFile routines provide a partial replacement for stdio atop
|
|
* virtual file descriptors managed by fd.c. Currently they only support
|
|
* buffered access to a virtual file, without any of stdio's formatting
|
|
* features. That's enough for immediate needs, but the set of facilities
|
|
* could be expanded if necessary.
|
|
*
|
|
* BufFile also supports working with temporary files that exceed the OS
|
|
* file size limit and/or the largest offset representable in an int.
|
|
* It might be better to split that out as a separately accessible module,
|
|
* but currently we have no need for oversize temp files without buffered
|
|
* access.
|
|
*
|
|
* Portions Copyright (c) 1996-2025, PostgreSQL Global Development Group
|
|
* Portions Copyright (c) 1994, Regents of the University of California
|
|
*
|
|
* src/include/storage/buffile.h
|
|
*
|
|
*-------------------------------------------------------------------------
|
|
*/
|
|
|
|
#ifndef BUFFILE_H
|
|
#define BUFFILE_H
|
|
|
|
#include "storage/fileset.h"
|
|
|
|
/* BufFile is an opaque type whose details are not known outside buffile.c. */
|
|
|
|
typedef struct BufFile BufFile;
|
|
|
|
/*
|
|
* prototypes for functions in buffile.c
|
|
*/
|
|
|
|
extern BufFile *BufFileCreateTemp(bool interXact);
|
|
extern void BufFileClose(BufFile *file);
|
|
pg_nodiscard extern size_t BufFileRead(BufFile *file, void *ptr, size_t size);
|
|
extern void BufFileReadExact(BufFile *file, void *ptr, size_t size);
|
|
extern size_t BufFileReadMaybeEOF(BufFile *file, void *ptr, size_t size, bool eofOK);
|
|
extern void BufFileWrite(BufFile *file, const void *ptr, size_t size);
|
|
extern int BufFileSeek(BufFile *file, int fileno, off_t offset, int whence);
|
|
extern void BufFileTell(BufFile *file, int *fileno, off_t *offset);
|
|
extern int BufFileSeekBlock(BufFile *file, int64 blknum);
|
|
extern int64 BufFileSize(BufFile *file);
|
|
extern int64 BufFileAppend(BufFile *target, BufFile *source);
|
|
|
|
extern BufFile *BufFileCreateFileSet(FileSet *fileset, const char *name);
|
|
extern void BufFileExportFileSet(BufFile *file);
|
|
extern BufFile *BufFileOpenFileSet(FileSet *fileset, const char *name,
|
|
int mode, bool missing_ok);
|
|
extern void BufFileDeleteFileSet(FileSet *fileset, const char *name,
|
|
bool missing_ok);
|
|
extern void BufFileTruncateFileSet(BufFile *file, int fileno, off_t offset);
|
|
|
|
#endif /* BUFFILE_H */
|