diff options
Diffstat (limited to 'doc/src/sgml/ref/createuser.sgml')
| -rw-r--r-- | doc/src/sgml/ref/createuser.sgml | 114 |
1 files changed, 57 insertions, 57 deletions
diff --git a/doc/src/sgml/ref/createuser.sgml b/doc/src/sgml/ref/createuser.sgml index fda77976ff2..788ee81dafb 100644 --- a/doc/src/sgml/ref/createuser.sgml +++ b/doc/src/sgml/ref/createuser.sgml @@ -34,15 +34,15 @@ PostgreSQL documentation <para> <application>createuser</application> creates a new <productname>PostgreSQL</productname> user (or more precisely, a role). - Only superusers and users with <literal>CREATEROLE</> privilege can create + Only superusers and users with <literal>CREATEROLE</literal> privilege can create new users, so <application>createuser</application> must be invoked by someone who can connect as a superuser or a user with - <literal>CREATEROLE</> privilege. + <literal>CREATEROLE</literal> privilege. </para> <para> If you wish to create a new superuser, you must connect as a - superuser, not merely with <literal>CREATEROLE</> privilege. + superuser, not merely with <literal>CREATEROLE</literal> privilege. Being a superuser implies the ability to bypass all access permission checks within the database, so superuserdom should not be granted lightly. </para> @@ -61,7 +61,7 @@ PostgreSQL documentation <title>Options</title> <para> - <application>createuser</> accepts the following command-line arguments: + <application>createuser</application> accepts the following command-line arguments: <variablelist> <varlistentry> @@ -77,8 +77,8 @@ PostgreSQL documentation </varlistentry> <varlistentry> - <term><option>-c <replaceable class="parameter">number</replaceable></></term> - <term><option>--connection-limit=<replaceable class="parameter">number</replaceable></></term> + <term><option>-c <replaceable class="parameter">number</replaceable></option></term> + <term><option>--connection-limit=<replaceable class="parameter">number</replaceable></option></term> <listitem> <para> Set a maximum number of connections for the new user. @@ -88,8 +88,8 @@ PostgreSQL documentation </varlistentry> <varlistentry> - <term><option>-d</></term> - <term><option>--createdb</></term> + <term><option>-d</option></term> + <term><option>--createdb</option></term> <listitem> <para> The new user will be allowed to create databases. @@ -98,8 +98,8 @@ PostgreSQL documentation </varlistentry> <varlistentry> - <term><option>-D</></term> - <term><option>--no-createdb</></term> + <term><option>-D</option></term> + <term><option>--no-createdb</option></term> <listitem> <para> The new user will not be allowed to create databases. This is the @@ -109,8 +109,8 @@ PostgreSQL documentation </varlistentry> <varlistentry> - <term><option>-e</></term> - <term><option>--echo</></term> + <term><option>-e</option></term> + <term><option>--echo</option></term> <listitem> <para> Echo the commands that <application>createuser</application> generates @@ -120,8 +120,8 @@ PostgreSQL documentation </varlistentry> <varlistentry> - <term><option>-E</></term> - <term><option>--encrypted</></term> + <term><option>-E</option></term> + <term><option>--encrypted</option></term> <listitem> <para> This option is obsolete but still accepted for backward @@ -131,21 +131,21 @@ PostgreSQL documentation </varlistentry> <varlistentry> - <term><option>-g <replaceable class="parameter">role</replaceable></></term> - <term><option>--role=<replaceable class="parameter">role</replaceable></></term> + <term><option>-g <replaceable class="parameter">role</replaceable></option></term> + <term><option>--role=<replaceable class="parameter">role</replaceable></option></term> <listitem> <para> Indicates role to which this role will be added immediately as a new member. Multiple roles to which this role will be added as a member can be specified by writing multiple - <option>-g</> switches. + <option>-g</option> switches. </para> </listitem> </varlistentry> <varlistentry> - <term><option>-i</></term> - <term><option>--inherit</></term> + <term><option>-i</option></term> + <term><option>--inherit</option></term> <listitem> <para> The new role will automatically inherit privileges of roles @@ -156,8 +156,8 @@ PostgreSQL documentation </varlistentry> <varlistentry> - <term><option>-I</></term> - <term><option>--no-inherit</></term> + <term><option>-I</option></term> + <term><option>--no-inherit</option></term> <listitem> <para> The new role will not automatically inherit privileges of roles @@ -167,7 +167,7 @@ PostgreSQL documentation </varlistentry> <varlistentry> - <term><option>--interactive</></term> + <term><option>--interactive</option></term> <listitem> <para> Prompt for the user name if none is specified on the command line, and @@ -181,8 +181,8 @@ PostgreSQL documentation </varlistentry> <varlistentry> - <term><option>-l</></term> - <term><option>--login</></term> + <term><option>-l</option></term> + <term><option>--login</option></term> <listitem> <para> The new user will be allowed to log in (that is, the user name @@ -193,8 +193,8 @@ PostgreSQL documentation </varlistentry> <varlistentry> - <term><option>-L</></term> - <term><option>--no-login</></term> + <term><option>-L</option></term> + <term><option>--no-login</option></term> <listitem> <para> The new user will not be allowed to log in. @@ -205,8 +205,8 @@ PostgreSQL documentation </varlistentry> <varlistentry> - <term><option>-P</></term> - <term><option>--pwprompt</></term> + <term><option>-P</option></term> + <term><option>--pwprompt</option></term> <listitem> <para> If given, <application>createuser</application> will issue a prompt for @@ -217,19 +217,19 @@ PostgreSQL documentation </varlistentry> <varlistentry> - <term><option>-r</></term> - <term><option>--createrole</></term> + <term><option>-r</option></term> + <term><option>--createrole</option></term> <listitem> <para> The new user will be allowed to create new roles (that is, - this user will have <literal>CREATEROLE</> privilege). + this user will have <literal>CREATEROLE</literal> privilege). </para> </listitem> </varlistentry> <varlistentry> - <term><option>-R</></term> - <term><option>--no-createrole</></term> + <term><option>-R</option></term> + <term><option>--no-createrole</option></term> <listitem> <para> The new user will not be allowed to create new roles. This is the @@ -239,8 +239,8 @@ PostgreSQL documentation </varlistentry> <varlistentry> - <term><option>-s</></term> - <term><option>--superuser</></term> + <term><option>-s</option></term> + <term><option>--superuser</option></term> <listitem> <para> The new user will be a superuser. @@ -249,8 +249,8 @@ PostgreSQL documentation </varlistentry> <varlistentry> - <term><option>-S</></term> - <term><option>--no-superuser</></term> + <term><option>-S</option></term> + <term><option>--no-superuser</option></term> <listitem> <para> The new user will not be a superuser. This is the default. @@ -259,8 +259,8 @@ PostgreSQL documentation </varlistentry> <varlistentry> - <term><option>-V</></term> - <term><option>--version</></term> + <term><option>-V</option></term> + <term><option>--version</option></term> <listitem> <para> Print the <application>createuser</application> version and exit. @@ -269,7 +269,7 @@ PostgreSQL documentation </varlistentry> <varlistentry> - <term><option>--replication</></term> + <term><option>--replication</option></term> <listitem> <para> The new user will have the <literal>REPLICATION</literal> privilege, @@ -280,7 +280,7 @@ PostgreSQL documentation </varlistentry> <varlistentry> - <term><option>--no-replication</></term> + <term><option>--no-replication</option></term> <listitem> <para> The new user will not have the <literal>REPLICATION</literal> @@ -291,8 +291,8 @@ PostgreSQL documentation </varlistentry> <varlistentry> - <term><option>-?</></term> - <term><option>--help</></term> + <term><option>-?</option></term> + <term><option>--help</option></term> <listitem> <para> Show help about <application>createuser</application> command line @@ -310,8 +310,8 @@ PostgreSQL documentation <variablelist> <varlistentry> - <term><option>-h <replaceable class="parameter">host</replaceable></></term> - <term><option>--host=<replaceable class="parameter">host</replaceable></></term> + <term><option>-h <replaceable class="parameter">host</replaceable></option></term> + <term><option>--host=<replaceable class="parameter">host</replaceable></option></term> <listitem> <para> Specifies the host name of the machine on which the @@ -323,8 +323,8 @@ PostgreSQL documentation </varlistentry> <varlistentry> - <term><option>-p <replaceable class="parameter">port</replaceable></></term> - <term><option>--port=<replaceable class="parameter">port</replaceable></></term> + <term><option>-p <replaceable class="parameter">port</replaceable></option></term> + <term><option>--port=<replaceable class="parameter">port</replaceable></option></term> <listitem> <para> Specifies the TCP port or local Unix domain socket file @@ -335,8 +335,8 @@ PostgreSQL documentation </varlistentry> <varlistentry> - <term><option>-U <replaceable class="parameter">username</replaceable></></term> - <term><option>--username=<replaceable class="parameter">username</replaceable></></term> + <term><option>-U <replaceable class="parameter">username</replaceable></option></term> + <term><option>--username=<replaceable class="parameter">username</replaceable></option></term> <listitem> <para> User name to connect as (not the user name to create). @@ -345,8 +345,8 @@ PostgreSQL documentation </varlistentry> <varlistentry> - <term><option>-w</></term> - <term><option>--no-password</></term> + <term><option>-w</option></term> + <term><option>--no-password</option></term> <listitem> <para> Never issue a password prompt. If the server requires @@ -360,8 +360,8 @@ PostgreSQL documentation </varlistentry> <varlistentry> - <term><option>-W</></term> - <term><option>--password</></term> + <term><option>-W</option></term> + <term><option>--password</option></term> <listitem> <para> Force <application>createuser</application> to prompt for a @@ -375,7 +375,7 @@ PostgreSQL documentation for a password if the server demands password authentication. However, <application>createuser</application> will waste a connection attempt finding out that the server wants a password. - In some cases it is worth typing <option>-W</> to avoid the extra + In some cases it is worth typing <option>-W</option> to avoid the extra connection attempt. </para> </listitem> @@ -403,8 +403,8 @@ PostgreSQL documentation </variablelist> <para> - This utility, like most other <productname>PostgreSQL</> utilities, - also uses the environment variables supported by <application>libpq</> + This utility, like most other <productname>PostgreSQL</productname> utilities, + also uses the environment variables supported by <application>libpq</application> (see <xref linkend="libpq-envars">). </para> @@ -451,7 +451,7 @@ PostgreSQL documentation <para> To create the same user <literal>joe</literal> using the - server on host <literal>eden</>, port 5000, with attributes explicitly specified, + server on host <literal>eden</literal>, port 5000, with attributes explicitly specified, taking a look at the underlying command: <screen> <prompt>$ </prompt><userinput>createuser -h eden -p 5000 -S -D -R -e joe</userinput> |