~ubuntu-branches/ubuntu/oneiric/postgresql-9.1/oneiric-security

« back to all changes in this revision

Viewing changes to doc/src/sgml/man1/pg_dumpall.1

  • Committer: Bazaar Package Importer
  • Author(s): Martin Pitt
  • Date: 2011-06-14 09:53:29 UTC
  • mto: (6.1.1 sid) (10.1.1 oneiric-proposed) (1.2.1)
  • mto: This revision was merged to the branch mainline in revision 5.
  • Revision ID: james.westby@ubuntu.com-20110614095329-71gfhjywyp2c27au
Tags: upstream-9.1~beta2
ImportĀ upstreamĀ versionĀ 9.1~beta2

Show diffs side-by-side

added added

removed removed

Lines of Context:
2
2
.\"     Title: pg_dumpall
3
3
.\"    Author: The PostgreSQL Global Development Group
4
4
.\" Generator: DocBook XSL Stylesheets v1.75.1 <http://docbook.sf.net/>
5
 
.\"      Date: 2011-04-27
6
 
.\"    Manual: PostgreSQL 9.1beta1 Documentation
7
 
.\"    Source: PostgreSQL 9.1beta1
 
5
.\"      Date: 2011-06-09
 
6
.\"    Manual: PostgreSQL 9.1beta2 Documentation
 
7
.\"    Source: PostgreSQL 9.1beta2
8
8
.\"  Language: English
9
9
.\"
10
 
.TH "PG_DUMPALL" "1" "2011-04-27" "PostgreSQL 9.1beta1" "PostgreSQL 9.1beta1 Documentation"
 
10
.TH "PG_DUMPALL" "1" "2011-06-09" "PostgreSQL 9.1beta2" "PostgreSQL 9.1beta2 Documentation"
11
11
.\" -----------------------------------------------------------------
12
12
.\" * set default formatting
13
13
.\" -----------------------------------------------------------------
104
104
\fB\-O\fR\&.
105
105
.RE
106
106
.PP
107
 
\fB\-\-lock\-wait\-timeout=\fR\fB\fItimeout\fR\fR
108
 
.RS 4
109
 
Do not wait forever to acquire shared table locks at the beginning of the dump\&. Instead, fail if unable to lock a table within the specified
110
 
\fItimeout\fR\&. The timeout may be specified in any of the formats accepted by
111
 
SET statement_timeout\&. Allowed values vary depending on the server version you are dumping from, but an integer number of milliseconds is accepted by all versions since 7\&.3\&. This option is ignored when dumping from a pre\-7\&.3 server\&.
112
 
.RE
113
 
.PP
114
 
\fB\-\-no\-tablespaces\fR
115
 
.RS 4
116
 
Do not output commands to create tablespaces nor select tablespaces for objects\&. With this option, all objects will be created in whichever tablespace is the default during restore\&.
117
 
.RE
118
 
.PP
119
 
\fB\-\-no\-security\-label\fR
120
 
.RS 4
121
 
Do not dump security labels\&.
122
 
.RE
123
 
.PP
124
 
\fB\-\-no\-unlogged\-table\-data\fR
125
 
.RS 4
126
 
Do not dump the contents of unlogged tables\&. This option has no effect on whether or not the table definitions (schema) are dumped; it only suppresses dumping the table data\&.
127
 
.RE
128
 
.PP
129
107
\fB\-r\fR, \fB\-\-roles\-only\fR
130
108
.RS 4
131
109
Dump only roles, no databases or tablespaces\&.
173
151
This option is for use by in\-place upgrade utilities\&. Its use for other purposes is not recommended or supported\&. The behavior of the option may change in future releases without notice\&.
174
152
.RE
175
153
.PP
176
 
\fB\-\-inserts\fR
177
 
.RS 4
178
 
Dump data as
179
 
INSERT
180
 
commands (rather than
181
 
COPY)\&. This will make restoration very slow; it is mainly useful for making dumps that can be loaded into non\-PostgreSQL
182
 
databases\&. Note that the restore might fail altogether if you have rearranged column order\&. The
183
 
\fB\-\-column\-inserts\fR
184
 
option is safer, though even slower\&.
185
 
.RE
186
 
.PP
187
154
\fB\-\-column\-inserts\fR, \fB\-\-attribute\-inserts\fR
188
155
.RS 4
189
156
Dump data as
209
176
\fB\-S\fR, or preferably be careful to start the resulting script as a superuser\&.
210
177
.RE
211
178
.PP
 
179
\fB\-\-inserts\fR
 
180
.RS 4
 
181
Dump data as
 
182
INSERT
 
183
commands (rather than
 
184
COPY)\&. This will make restoration very slow; it is mainly useful for making dumps that can be loaded into non\-PostgreSQL
 
185
databases\&. Note that the restore might fail altogether if you have rearranged column order\&. The
 
186
\fB\-\-column\-inserts\fR
 
187
option is safer, though even slower\&.
 
188
.RE
 
189
.PP
 
190
\fB\-\-lock\-wait\-timeout=\fR\fB\fItimeout\fR\fR
 
191
.RS 4
 
192
Do not wait forever to acquire shared table locks at the beginning of the dump\&. Instead, fail if unable to lock a table within the specified
 
193
\fItimeout\fR\&. The timeout may be specified in any of the formats accepted by
 
194
SET statement_timeout\&. Allowed values vary depending on the server version you are dumping from, but an integer number of milliseconds is accepted by all versions since 7\&.3\&. This option is ignored when dumping from a pre\-7\&.3 server\&.
 
195
.RE
 
196
.PP
 
197
\fB\-\-no\-security\-labels\fR
 
198
.RS 4
 
199
Do not dump security labels\&.
 
200
.RE
 
201
.PP
 
202
\fB\-\-no\-tablespaces\fR
 
203
.RS 4
 
204
Do not output commands to create tablespaces nor select tablespaces for objects\&. With this option, all objects will be created in whichever tablespace is the default during restore\&.
 
205
.RE
 
206
.PP
 
207
\fB\-\-no\-unlogged\-table\-data\fR
 
208
.RS 4
 
209
Do not dump the contents of unlogged tables\&. This option has no effect on whether or not the table definitions (schema) are dumped; it only suppresses dumping the table data\&.
 
210
.RE
 
211
.PP
 
212
\fB\-\-quote\-all\-identifiers\fR
 
213
.RS 4
 
214
Force quoting of all identifiers\&. This may be useful when dumping a database for migration to a future version that may have introduced additional keywords\&.
 
215
.RE
 
216
.PP
212
217
\fB\-\-use\-set\-session\-authorization\fR
213
218
.RS 4
214
219
Output SQL\-standard
218
223
commands to determine object ownership\&. This makes the dump more standards compatible, but depending on the history of the objects in the dump, might not restore properly\&.
219
224
.RE
220
225
.PP
221
 
\fB\-\-quote\-all\-identifiers\fR
222
 
.RS 4
223
 
Force quoting of all identifiers\&. This may be useful when dumping a database for migration to a future version that may have introduced additional keywords\&.
224
 
.RE
225
 
.PP
226
226
\fB\-?\fR, \fB\-\-help\fR
227
227
.RS 4
228
228
Show help about