From 60b198a768247cfe2484ec18039a1ffba204c51e Mon Sep 17 00:00:00 2001 From: Bruce Momjian Date: Thu, 30 Oct 2003 02:40:29 +0000 Subject: [PATCH] Update FAQ_DEV: elog => ereport. --- doc/FAQ_DEV | 29 +++++++++++++++-------------- doc/src/FAQ/FAQ_DEV.html | 14 +++++++------- 2 files changed, 22 insertions(+), 21 deletions(-) diff --git a/doc/FAQ_DEV b/doc/FAQ_DEV index 6a6f1d51d5..65d478471a 100644 --- a/doc/FAQ_DEV +++ b/doc/FAQ_DEV @@ -1,7 +1,7 @@ Developer's Frequently Asked Questions (FAQ) for PostgreSQL - Last updated: Mon Jun 2 00:34:39 EDT 2003 + Last updated: Wed Oct 29 21:40:18 EST 2003 Current maintainer: Bruce Momjian (pgman@candle.pha.pa.us) @@ -34,7 +34,7 @@ 2.3) Why do we use Node and List to make data structures? 2.4) I just added a field to a structure. What else should I do? 2.5) Why do we use palloc() and pfree() to allocate memory? - 2.6) What is elog()? + 2.6) What is ereport()? 2.7) What is CommandCounterIncrement()? _________________________________________________________________ @@ -687,20 +687,21 @@ List *i, *list; are special non-query contexts that memory can be allocated in. These affect when the allocated memory is freed by the backend. - 2.6) What is elog()? + 2.6) What is ereport()? - elog() is used to send messages to the front-end, and optionally + ereport() is used to send messages to the front-end, and optionally terminate the current query being processed. The first parameter is an - elog level of DEBUG (levels 1-5), LOG, INFO, NOTICE, ERROR, FATAL, or - PANIC. NOTICE prints on the user's terminal and the postmaster logs. - INFO prints only to the user's terminal and LOG prints only to the - server logs. (These can be changed from postgresql.conf.) ERROR prints - in both places, and terminates the current query, never returning from - the call. FATAL terminates the backend process. The remaining - parameters of elog are a printf-style set of parameters to print. - - elog(ERROR) frees most memory and open file descriptors so you don't - need to clean these up before the call. + ereport level of DEBUG (levels 1-5), LOG, INFO, NOTICE, ERROR, FATAL, + or PANIC. NOTICE prints on the user's terminal and the postmaster + logs. INFO prints only to the user's terminal and LOG prints only to + the server logs. (These can be changed from postgresql.conf.) ERROR + prints in both places, and terminates the current query, never + returning from the call. FATAL terminates the backend process. The + remaining parameters of ereport are a printf-style set of parameters + to print. + + ereport(ERROR) frees most memory and open file descriptors so you + don't need to clean these up before the call. 2.7) What is CommandCounterIncrement()? diff --git a/doc/src/FAQ/FAQ_DEV.html b/doc/src/FAQ/FAQ_DEV.html index 9304e794de..64037ff5cd 100644 --- a/doc/src/FAQ/FAQ_DEV.html +++ b/doc/src/FAQ/FAQ_DEV.html @@ -12,7 +12,7 @@

Developer's Frequently Asked Questions (FAQ) for PostgreSQL

-

Last updated: Mon Jun 2 00:34:39 EDT 2003

+

Last updated: Wed Oct 29 21:40:18 EST 2003

Current maintainer: Bruce Momjian (pgman@candle.pha.pa.us)
@@ -61,7 +61,7 @@ should I do?
2.5) Why do we use palloc() and pfree() to allocate memory?
- 2.6) What is elog()?
+ 2.6) What is ereport()?
2.7) What is CommandCounterIncrement()?

@@ -833,11 +833,11 @@ memory can be allocated in. These affect when the allocated memory is freed by the backend.

-

2.6) What is elog()?

+

2.6) What is ereport()?

-

elog() is used to send messages to the front-end, and +

ereport() is used to send messages to the front-end, and optionally terminate the current query being processed. The first - parameter is an elog level of DEBUG (levels 1-5), LOG, + parameter is an ereport level of DEBUG (levels 1-5), LOG, INFO, NOTICE, ERROR, FATAL, or PANIC. NOTICE prints on the user's terminal and the postmaster logs. INFO prints only to the user's terminal and @@ -845,10 +845,10 @@ from postgresql.conf.) ERROR prints in both places, and terminates the current query, never returning from the call. FATAL terminates the backend process. The remaining - parameters of elog are a printf-style set of + parameters of ereport are a printf-style set of parameters to print.

-

elog(ERROR) frees most memory and open file descriptors so +

ereport(ERROR) frees most memory and open file descriptors so you don't need to clean these up before the call.

2.7) What is CommandCounterIncrement()?

-- 2.40.0