1010alink ="#0000ff ">
1111< H1 > Frequently Asked Questions (FAQ) for PostgreSQL</ H1 >
1212
13- < P > Last updated: Mon Jan 3115:40:24 EST 2005</ P >
13+ < P > Last updated: Mon Jan 3117:57:02 EST 2005</ P >
1414
1515< P > Current maintainer: Bruce Momjian (< A href =
1616 "mailto:pgman@candle.pha.pa.us "> pgman@candle.pha.pa.us</ A > )
@@ -519,29 +519,23 @@ <H4><A name="3.3">3.3</A>) How do I tune the database engine for
519519< H4 > < A name ="3.4 "> 3.4</ A > ) What debugging features are
520520 available?</ H4 >
521521
522- < P > PostgreSQL has several features that report status information
523- that can be valuable for debugging purposes.</ P >
522+ < P > There are many< CODE > log_*</ CODE > server configuration variables
523+ that enable printing of query and process statistics which can be
524+ very useful for debugging and performance measurements.</ P >
524525
525- < P > First, by running< I > configure</ I > with the --enable-cassert
526+ < P > < B > The following detailed debug instructions are to be used to
527+ provide more detailed information for server developers debugging a
528+ problem< B > </ P >
529+
530+ < P > It is also possible to debug the server if it isn't operating
531+ properly. First, by running< I > configure</ I > with the --enable-cassert
526532 option, many< I > assert()</ I > s monitor the progress of the backend
527533 and halt the program when something unexpected occurs.</ P >
528534
529- < P > Both< I > postmaster</ I > and< I > postgres</ I > have several debug
530- options available. First, whenever you start< I > postmaster</ I > ,
531- make sure you send the standard output and error to a log file,
532- like:</ P >
533- < PRE >
534- cd /usr/local/pgsql
535- ./bin/postmaster >server.log 2>&1 &
536- </ PRE >
537-
538- < P > This will put a server.log file in the top-level PostgreSQL
539- directory. This file contains useful information about problems or
540- errors encountered by the server.< I > Postmaster</ I > has a< I > -d</ I >
541- option that allows even more detailed information to be reported.
542- The< I > -d</ I > option takes a number that specifies the debug level.
543- Be warned that high debug level values generate large log
544- files.</ P >
535+ The< I > postmaster</ I > has a< I > -d</ I > option that allows even more
536+ detailed information to be reported. The< I > -d</ I > option takes a
537+ number that specifies the debug level. Be warned that high debug
538+ level values generate large log files.</ P >
545539
546540< P > If< I > postmaster</ I > is not running, you can actually run the
547541< I > postgres</ I > backend from the command line, and type your
@@ -565,10 +559,6 @@ <H4><A name="3.4">3.4</A>) What debugging features are
565559 the debugger, set any breakpoints, and continue through the startup
566560 sequence.</ P >
567561
568- < P > There are several< CODE > log_*</ CODE > server configuration variables
569- that enable printing of process statistics which can be very useful
570- for debugging and performance measurements.</ P >
571-
572562< P > You can also compile with profiling to see what functions are
573563 taking execution time. The backend profile files will be deposited
574564 in the< I > pgsql/data/base/dbname</ I > directory. The client profile