diff options
Diffstat (limited to 'src/man/notify.l')
-rw-r--r-- | src/man/notify.l | 54 |
1 files changed, 0 insertions, 54 deletions
diff --git a/src/man/notify.l b/src/man/notify.l deleted file mode 100644 index 370677d12f..0000000000 --- a/src/man/notify.l +++ /dev/null @@ -1,54 +0,0 @@ -.\" This is -*-nroff-*- -.\" XXX standard disclaimer belongs here.... -.\" $Header: /cvsroot/pgsql/src/man/Attic/notify.l,v 1.6 1998/10/08 01:16:18 tgl Exp $ -.TH "NOTIFY" SQL 11/05/95 PostgreSQL PostgreSQL -.SH NAME -notify - signal all frontends and backends listening on a class -.SH SYNOPSIS -.nf -\fBnotify\fR class_name -.fi -.SH DESCRIPTION -This man page is obsolete. More complete and reliable info is -available in the User's Guide reference page for NOTIFY. -.PP -.BR notify -is used to awaken all backends and consequently all frontends -that have executed -.IR listen(l) -on -.IR class_name . -This can be used either within an instance-level rule as part of the -action body or from a normal query. When used from within a normal -query, this can be thought of as interprocess communication (IPC). -When used from within a rule, this can be thought of as an alerter -mechanism. -.PP -Notice that the mere fact that a -.BR notify -has been executed does not imply anything in particular about -the state of the class (e.g., that it has been updated), nor -does the notification protocol transmit any useful information -other than the class name. Therefore, all -.BR notify -does is indicate that some backend wishes its peers to examine -.IR class_name -in some application-specific way. -.PP -In fact, -.IR class_name -need not be the name of an SQL class at all. It is best thought of -as a condition name that the application programmer selects. -.PP -This event notification is performed through the Libpq protocol -and frontend application interface. The application program -must call the routine -.IR PQnotifies -in order to find out the name of the class to which a given -notification corresponds. If this code is not included in -the application, the event notification will be queued and -never be processed. -.SH "SEE ALSO" -define rule(l), -listen(l), -libpq(3). |