11<!--
2- $PostgreSQL: pgsql/doc/src/sgml/ref/dropuser.sgml,v 1.32 2005/05/29 03:32:18 momjian Exp $
2+ $PostgreSQL: pgsql/doc/src/sgml/ref/dropuser.sgml,v 1.33 2005/08/15 02:40:20 tgl Exp $
33PostgreSQL documentation
44-->
55
@@ -33,17 +33,16 @@ PostgreSQL documentation
3333
3434 <para>
3535 <application>dropuser</application> removes an existing
36- <productname>PostgreSQL</productname> user
37- <emphasis>and</emphasis> the databases which that user owned.
38- Only superusers (users with <literal>usesuper</literal> set in
39- the <literal>pg_shadow</literal> table) can destroy
40- <productname>PostgreSQL</productname> users.
36+ <productname>PostgreSQL</productname> user.
37+ Only superusers and users with the <literal>CREATEROLE</> privilege can
38+ remove <productname>PostgreSQL</productname> users. (To remove a
39+ superuser, you must yourself be a superuser.)
4140 </para>
4241
4342 <para>
4443 <application>dropuser</application> is a wrapper around the
45- <acronym>SQL</acronym> command <xref linkend="SQL-DROPUSER "
46- endterm="SQL-DROPUSER -title">.
44+ <acronym>SQL</acronym> command <xref linkend="SQL-DROPROLE "
45+ endterm="SQL-DROPROLE -title">.
4746 There is no effective difference between dropping users via
4847 this utility and via other methods for accessing the server.
4948 </para>
@@ -62,8 +61,8 @@ PostgreSQL documentation
6261 <term><replaceable class="parameter">username</replaceable></term>
6362 <listitem>
6463 <para>
65- Specifies the name of the <productname>PostgreSQL</productname> user to be removed.
66- You will be prompted for a name if none is specified on the command line.
64+ Specifies the name of the <productname>PostgreSQL</productname> user to be removed.
65+ You will be prompted for a name if none is specified on the command line.
6766 </para>
6867 </listitem>
6968 </varlistentry>
@@ -74,7 +73,7 @@ PostgreSQL documentation
7473 <listitem>
7574 <para>
7675 Echo the commands that <application>dropuser</application> generates
77- and sends to the server.
76+ and sends to the server.
7877 </para>
7978 </listitem>
8079 </varlistentry>
@@ -111,10 +110,10 @@ PostgreSQL documentation
111110 <term><option>--host <replaceable class="parameter">host</replaceable></></term>
112111 <listitem>
113112 <para>
114- Specifies the host name of the machine on which the
115- server
116- is running. If the value begins with a slash, it is used
117- as the directory for the Unix domain socket.
113+ Specifies the host name of the machine on which the
114+ server
115+ is running. If the value begins with a slash, it is used
116+ as the directory for the Unix domain socket.
118117 </para>
119118 </listitem>
120119 </varlistentry>
@@ -124,9 +123,9 @@ PostgreSQL documentation
124123 <term><option>--port <replaceable class="parameter">port</replaceable></></term>
125124 <listitem>
126125 <para>
127- Specifies the TCP port or local Unix domain socket file
128- extension on which the server
129- is listening for connections.
126+ Specifies the TCP port or local Unix domain socket file
127+ extension on which the server
128+ is listening for connections.
130129 </para>
131130 </listitem>
132131 </varlistentry>
@@ -179,8 +178,8 @@ PostgreSQL documentation
179178 <title>Diagnostics</title>
180179
181180 <para>
182- In case of difficulty, see <xref linkend="SQL-DROPUSER "
183- endterm="sql-dropuser -title"> and <xref linkend="APP-PSQL"> for
181+ In case of difficulty, see <xref linkend="SQL-DROPROLE "
182+ endterm="sql-droprole -title"> and <xref linkend="APP-PSQL"> for
184183 discussions of potential problems and error messages.
185184 The database server must be running at the
186185 targeted host. Also, any default connection settings and environment
@@ -199,7 +198,7 @@ PostgreSQL documentation
199198 server:
200199<screen>
201200<prompt>$ </prompt><userinput>dropuser joe</userinput>
202- <computeroutput>DROPUSER </computeroutput>
201+ <computeroutput>DROPROLE </computeroutput>
203202</screen>
204203 </para>
205204
@@ -209,10 +208,10 @@ PostgreSQL documentation
209208 command:
210209<screen>
211210<prompt>$ </prompt><userinput>dropuser -p 5000 -h eden -i -e joe</userinput>
212- <computeroutput>User "joe"and any owned databases will be permanentlydeleted .
211+ <computeroutput>Role "joe" will be permanentlyremoved .
213212Are you sure? (y/n) </computeroutput><userinput>y</userinput>
214- <computeroutput>DROPUSER "joe"
215- DROPUSER </computeroutput>
213+ <computeroutput>DROPROLE "joe"
214+ DROPROLE </computeroutput>
216215</screen>
217216 </para>
218217 </refsect1>
@@ -223,7 +222,7 @@ DROP USER</computeroutput>
223222
224223 <simplelist type="inline">
225224 <member><xref linkend="app-createuser"></member>
226- <member><xref linkend="sql-dropuser " endterm="sql-dropuser -title"></member>
225+ <member><xref linkend="sql-droprole " endterm="sql-droprole -title"></member>
227226 <member>Environment Variables (<xref linkend="libpq-envars">)</member>
228227 </simplelist>
229228 </refsect1>