5. Bug Reporting Guidelines
When you find a bug inPostgres Pro we want to hear about it. Your bug reports play an important part in makingPostgres Pro more reliable because even the utmost care cannot guarantee that every part ofPostgres Pro will work on every platform under every circumstance.
The following suggestions are intended to assist you in forming bug reports that can be handled in an effective fashion. No one is required to follow them but doing so tends to be to everyone's advantage.
5.1. Identifying Bugs
Before you report a bug, please read and re-read the documentation to verify that you can really do whatever it is you are trying. If it is not clear from the documentation whether you can do something or not, please report that too; it is a bug in the documentation. If it turns out that a program does something different from what the documentation says, that is a bug. That might include, but is not limited to, the following circumstances:
A program terminates with a fatal signal or an operating system error message that would point to a problem in the program. (A counterexample might be a“disk full” message, since you have to fix that yourself.)
A program produces the wrong output for any given input.
A program refuses to accept valid input (as defined in the documentation).
A program accepts invalid input without a notice or error message. But keep in mind that your idea of invalid input might be our idea of an extension or compatibility with traditional practice.
Postgres Pro fails to install according to the instructions on supported platforms.
Here“program” refers to any executable, not only the backend process.
Being slow or resource-hogging is not necessarily a bug. Failing to comply to theSQL standard is not necessarily a bug either, unless compliance for the specific feature is explicitly claimed.
Note
If you are reporting an error message, please obtain the most verbose form of the message. Inpsql, say
\set VERBOSITY verbosebeforehand. If you are extracting the message from the server log, set the run-time parameterlog_error_verbosity toverboseso that all details are logged.Note
In case of fatal errors, the error message reported by the client might not contain all the information available. Please also look at the log output of the database server.
The output you expect is very important to state. Please provide the expected output, if applicable.
Any command line options and other start-up options, including any relevant environment variables or configuration files that you changed from the default.
Anything you did at all differently from the installation instructions.
ThePostgres Pro version. You can run the command
SELECT pgpro_version();to find out the version of the server you are connected to. Most executable programs also support a--versionoption; at leastpostgres --versionandpsql --versionshould work.Platform information. This includes the kernel name and version, C library, processor, memory information, and so on.
5.3. Where to Report Bugs
In general, send bug reports to our support email address at<bugs@postgrespro.ru>. You are requested to use a descriptive subject for your email message, perhaps parts of the error message.
Do not send bug reports specific toPostgres Pro to thePostgreSQL support email address, asPostgres Pro is not supported by thePostgreSQL community. But you can send reports to<pgsql-bugs@lists.postgresql.org> for any bugs related toPostgreSQL.
Even if your bug is not specific toPostgres Pro, do not send bug reports to any of the user mailing lists, such as<pgsql-sql@lists.postgresql.org> or<pgsql-general@lists.postgresql.org>. These mailing lists are for answering user questions, and their subscribers normally do not wish to receive bug reports. More importantly, they are unlikely to fix them.
Also, please donot send reports to the developers' mailing list<pgsql-hackers@lists.postgresql.org>. This list is for discussing the development ofPostgreSQL, and it would be nice if the community could keep the bug reports separate. The community might choose to take up a discussion about your bug report onpgsql-hackers, if thePostgreSQL-related problem needs more review.