mirror of
https://github.com/postgres/postgres.git
synced 2026-01-26 09:41:40 +03:00
74938d1320
Add various widely useful "IWYU pragma" annotations, such as - Common header files such as c.h, postgres.h should be "always_keep". - System headers included in c.h, postgres.h etc. should be considered "export". - Some portability headers such as getopt_long.h should be "always_keep", so they are not considered superfluous on some platforms. - Certain system headers included from portability headers should be considered "export" because the purpose of the portability header is to wrap them. - Superfluous includes marked as "for backward compatibility" get a formal IWYU annotation. - Generated header included in utils/syscache.h is marked exported. This is a very commonly used include and this avoids lots of complaints. Discussion: https://www.postgresql.org/message-id/flat/9395d484-eff4-47c2-b276-8e228526c8ae@eisentraut.org
58 lines
1.8 KiB
C
58 lines
1.8 KiB
C
/*
|
|
* Postgres files that use getopt(3) always include this file.
|
|
* We must cope with three different scenarios:
|
|
* 1. We're using the platform's getopt(), and we should just import the
|
|
* appropriate declarations.
|
|
* 2. The platform lacks getopt(), and we must declare everything.
|
|
* 3. The platform has getopt(), but we're not using it because we don't
|
|
* like its behavior. The declarations we make here must be compatible
|
|
* with both the platform's getopt() and our src/port/getopt.c.
|
|
*
|
|
* Portions Copyright (c) 1987, 1993, 1994
|
|
* The Regents of the University of California. All rights reserved.
|
|
*
|
|
* Portions Copyright (c) 2003-2025, PostgreSQL Global Development Group
|
|
*
|
|
* src/include/pg_getopt.h
|
|
*/
|
|
/* IWYU pragma: always_keep */
|
|
#ifndef PG_GETOPT_H
|
|
#define PG_GETOPT_H
|
|
|
|
/* POSIX says getopt() is provided by unistd.h */
|
|
#include <unistd.h> /* IWYU pragma: export */
|
|
|
|
/* rely on the system's getopt.h if present */
|
|
#ifdef HAVE_GETOPT_H
|
|
#include <getopt.h> /* IWYU pragma: export */
|
|
#endif
|
|
|
|
/*
|
|
* If we have <getopt.h>, assume it declares these variables, else do that
|
|
* ourselves. (We used to just declare them unconditionally, but Cygwin
|
|
* doesn't like that.)
|
|
*/
|
|
#ifndef HAVE_GETOPT_H
|
|
|
|
extern PGDLLIMPORT char *optarg;
|
|
extern PGDLLIMPORT int optind;
|
|
extern PGDLLIMPORT int opterr;
|
|
extern PGDLLIMPORT int optopt;
|
|
|
|
#endif /* HAVE_GETOPT_H */
|
|
|
|
/*
|
|
* Some platforms have optreset but fail to declare it in <getopt.h>, so cope.
|
|
* Cygwin, however, doesn't like this either.
|
|
*/
|
|
#if defined(HAVE_INT_OPTRESET) && !defined(__CYGWIN__)
|
|
extern PGDLLIMPORT int optreset;
|
|
#endif
|
|
|
|
/* Provide getopt() declaration if the platform doesn't have it */
|
|
#ifndef HAVE_GETOPT
|
|
extern int getopt(int nargc, char *const *nargv, const char *ostr);
|
|
#endif
|
|
|
|
#endif /* PG_GETOPT_H */
|