aboutsummaryrefslogtreecommitdiff
path: root/doc/src/sgml/notation.sgml
blob: e6faf72fecd592a30da0bd50d098ed56f70b7e47 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
<!--
$Header: /cvsroot/pgsql/doc/src/sgml/notation.sgml,v 1.12 2000/12/22 19:31:56 petere Exp $
-->

<sect1 id="terminology">
 <title>Terminology</title>

 <para>
  The 
  <Productname>Postgres</Productname> <firstterm>superuser</firstterm>
  is the user named <replaceable>postgres</replaceable>
  who owns the <Productname>Postgres</Productname>
  binaries and database files.  As the database superuser, all
  protection mechanisms may be bypassed and any data accessed
  arbitrarily.  
  In addition, the <Productname>Postgres</Productname> superuser is
  allowed to execute
  some support programs which are generally not available to all users.
  Note that the <Productname>Postgres</Productname> superuser is
  <emphasis>not</emphasis>
  the same as the Unix superuser (which will be referred to as
  <firstterm>root</firstterm>).
  The superuser should have a non-zero user identifier
  (<firstterm>UID</firstterm>) for security reasons.
 </para>

 <para>
  The
  <firstterm>database administrator</firstterm>
  or <acronym>DBA</acronym>, is the person who is responsible for installing 
  <Productname>Postgres</Productname> with mechanisms to
  enforce a security policy for a site.  The DBA can add new users by
  the method described below 
  and maintain a set of template databases for use by
  <application>createdb</application>.
 </para>

 <para>
  The <application>postmaster</application>
  is the process that acts as a clearing-house for requests 
  to the <Productname>Postgres</Productname> system.
  Frontend applications connect to the <application>postmaster</application>,
  which keeps tracks of any system errors and communication between the
  backend processes.  The <application>postmaster</application>
  can take several command-line arguments to tune its behavior.
  However, supplying arguments is necessary only if you intend to run multiple
  sites or a non-default site.
 </para>

 <para>
  The <Productname>Postgres</Productname> backend
  (the actual executable program <application>postgres</application>) may be executed
  directly from the user shell by the 
  <Productname>Postgres</Productname> super-user 
  (with the database name as an argument).  However,
  doing this bypasses the shared buffer pool and lock table associated
  with a postmaster/site, therefore this is not recommended in a multiuser
  site.
 </para>
</sect1>

<sect1 id="notation">
 <title>Notation</title>

 <para>
  "<literal>...</literal>" or <filename>/usr/local/pgsql/</filename> 
  at the front of a file name is used to represent the
  path to the <Productname>Postgres</Productname> superuser's home directory.
 </para>

 <para>
  In a command synopsis, brackets
  ("<literal>[</literal>" and "<literal>]</literal>") indicate an optional phrase or keyword.
  Anything in braces
  ("<literal>{</literal>" and "<literal>}</literal>") and containing vertical bars
  ("<literal>|</literal>")
  indicates that you must choose one.
 </para>

 <para>
  In examples, parentheses ("<literal>(</literal>" and "<literal>)</literal>") are
  used to group boolean
  expressions.  "<literal>|</literal>" is the boolean operator OR.
 </para>

 <para>
  Examples will show commands executed from various accounts and programs.
  Commands executed from the root account will be preceeded with
  "<literal>&gt;</literal>".
  Commands executed from the <Productname>Postgres</Productname>
  superuser account will be preceeded with "<literal>%</literal>", while commands
  executed from an unprivileged user's account will be preceeded with
  "<literal>$</literal>".
  <acronym>SQL</acronym> commands will be preceeded with "<literal>=&gt;</literal>"
  or will have no leading prompt, depending on the context.
 </para>

 <note>
  <para>
   At the time of writing (<Productname>Postgres</Productname> 7.0)
   the notation for
   flagging commands is not universally consistant throughout the
   documentation set.
   Please report problems to
   <ulink url="mailto:docs@postgresql.org">the Documentation Mailing List</ulink>.
  </para>
 </note>

</sect1>

<!-- Keep this comment at the end of the file
Local variables:
mode:sgml
sgml-omittag:nil
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:"./reference.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:("/usr/lib/sgml/catalog")
sgml-local-ecat-files:nil
End:
-->