aboutsummaryrefslogtreecommitdiff
path: root/doc/src/sgml/ref/load.sgml
diff options
context:
space:
mode:
Diffstat (limited to 'doc/src/sgml/ref/load.sgml')
-rw-r--r--doc/src/sgml/ref/load.sgml56
1 files changed, 39 insertions, 17 deletions
diff --git a/doc/src/sgml/ref/load.sgml b/doc/src/sgml/ref/load.sgml
index a72675105af..ad355e0c209 100644
--- a/doc/src/sgml/ref/load.sgml
+++ b/doc/src/sgml/ref/load.sgml
@@ -15,7 +15,7 @@ Dynamically loads an object file
<REFSYNOPSISDIV>
<REFSYNOPSISDIVINFO>
-<DATE>1998-09-01</DATE>
+<DATE>1998-09-24</DATE>
</REFSYNOPSISDIVINFO>
<SYNOPSIS>
<REPLACEABLE CLASS="PARAMETER">
@@ -47,21 +47,41 @@ Object file for dynamic loading.
<REFSECT2 ID="R2-SQL-LOAD-2">
<REFSECT2INFO>
-<DATE>1998-04-15</DATE>
+<DATE>1998-09-24</DATE>
</REFSECT2INFO>
<TITLE>
Outputs
</TITLE>
<PARA>
-</PARA>
+
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
-LOAD
+<replaceable>status</replaceable>
+</TERM>
+<LISTITEM>
+<PARA>
+
+<VARIABLELIST>
+<VARLISTENTRY>
+<TERM>
+<returnvalue>LOAD</returnvalue>
</TERM>
<LISTITEM>
<PARA>
+Message returned on successful completion.
+<VARLISTENTRY>
+<TERM>
+<returnvalue>ERROR: LOAD: could not open file '<REPLACEABLE CLASS="PARAMETER">filename</REPLACEABLE>'</returnvalue>
+</TERM>
+<LISTITEM>
+<PARA>
+Message returned if the specified file is not found. The file must be visible
+<emphasis>to the <productname>Postgres</productname> backend</emphasis>,
+with the appropriate full path name specified, to avoid this message.
+
+</VARIABLELIST>
</VARIABLELIST>
</REFSECT2>
@@ -69,7 +89,7 @@ LOAD
<REFSECT1 ID="R1-SQL-LOAD-1">
<REFSECT1INFO>
-<DATE>1998-04-15</DATE>
+<DATE>1998-09-24</DATE>
</REFSECT1INFO>
<TITLE>
Description
@@ -78,7 +98,7 @@ Description
Loads an object (or ".o") file into the
<productname>Postgres</productname> backend address space. Once a
file is loaded, all functions in that file can be accessed. This
-function is used in support of ADT's.
+function is used in support of user-defined types and functions.
<para>
If a file is not loaded using
@@ -92,7 +112,7 @@ at this time.
<REFSECT2 ID="R2-SQL-LOAD-3">
<REFSECT2INFO>
-<DATE>1998-04-15</DATE>
+<DATE>1998-09-24</DATE>
</REFSECT2INFO>
<TITLE>
Notes
@@ -101,12 +121,14 @@ Notes
Functions in loaded object files should not call functions in other
object files loaded through the
<command>LOAD</command>
-command, meaning, for example, that all functions in file A should
+command. For example, all functions in file <literal>A</literal> should
call each other, functions in the standard or math libraries, or in
Postgres itself. They should not call functions defined in a different
-loaded file B. This is because if B is reloaded, the Postgres loader is
-not able to relocate the calls from the functions in A into
-the new address space of B. If B is not reloaded, however, there will
+loaded file <literal>B</literal>.
+ This is because if <literal>B</literal> is reloaded, the Postgres loader is
+not able to relocate the calls from the functions in <literal>A</literal> into
+the new address space of <literal>B</literal>.
+If <literal>B</literal> is not reloaded, however, there will
not be a problem.
<para>
@@ -114,7 +136,7 @@ Object files must be compiled to contain position independent code.
For example,
on DECstations you must use
<application>/bin/cc</application>
-with the "-G 0" option when compiling object files to be
+with the <literal>-G 0</literal> option when compiling object files to be
loaded.
<para>
@@ -130,9 +152,9 @@ Usage
</TITLE>
<PARA>
<ProgramListing>
- --Load the file /usr/postgres/demo/circle.o
- --
- LOAD "/usr/postgres/demo/circle.o"
+--Load the file /usr/postgres/demo/circle.o
+--
+LOAD "/usr/postgres/demo/circle.o"
</ProgramListing>
</REFSECT1>
@@ -146,12 +168,12 @@ Compatibility
<REFSECT2 ID="R2-SQL-LOAD-4">
<REFSECT2INFO>
-<DATE>1998-04-15</DATE>
+<DATE>1998-09-24</DATE>
</REFSECT2INFO>
<TITLE>
SQL92
</TITLE>
<PARA>
-There is no LOAD statement in <acronym>SQL92</acronym>.
+There is no <command>LOAD</command> in <acronym>SQL92</acronym>.
</REFENTRY>