gerrit/Documentation/cmd-create-account.txt
Yuxuan 'fishy' Wang 61698b14e0 Use the new section title style in Asciidoctor.
We previous use the section title style like:

Section level 1
===============

Section level 2
---------------

Which have a problem in Asciidoctor that the number of "="s or "-"s must match
the number of characters in the header exactly, as a result it's easy to make
mistakes while changing the titles. Asciidoctor provides a better style like:

= Section level 1

== Section level 2

So we switched to this style.

Also fixed a bug in replace_macros.py, which will not cause any problem in the
old style.

Change-Id: I811dd7238735d98f662767c17086152cd69aea02
2013-12-20 12:55:51 -08:00

80 lines
2.2 KiB
Plaintext

= gerrit create-account
== NAME
gerrit create-account - Create a new user account.
== SYNOPSIS
--
'ssh' -p <port> <host> 'gerrit create-account'
[--group <GROUP>]
[--full-name <FULLNAME>]
[--email <EMAIL>]
[--ssh-key - | <KEY>]
[--http-password <PASSWORD>]
<USERNAME>
--
== DESCRIPTION
Creates a new internal-only user account.
If the account is created without an email address, it may only be
used for batch/role access, such as from an automated build system
or event monitoring over link:cmd-stream-events.html[gerrit stream-events].
Note, however, that in this case the account is not implicitly added
to the 'Non-Interactive Users' group. The account must be explicitly
added to the group with the `--group` option.
If LDAP authentication is being used, the user account is created
without checking the LDAP directory. Consequently users can be
created in Gerrit that do not exist in the underlying LDAP directory.
== ACCESS
Caller must be a member of the privileged 'Administrators' group,
or have been granted
link:access-control.html#capability_createAccount[the 'Create Account' global capability].
== SCRIPTING
This command is intended to be used in scripts.
== OPTIONS
<USERNAME>::
Required; SSH username of the user account.
--ssh-key::
Content of the public SSH key to load into the account's
keyring. If `-` the key is read from stdin, rather than
from the command line.
--group::
Name of the group to put the user into. Multiple --group
options may be specified to add the user to multiple groups.
--full-name::
Display name of the user account.
+
Names containing spaces should be quoted in single quotes (').
This most likely requires double quoting the value, for example
`--full-name "'A description string'"`.
--email::
Preferred email address for the user account.
--http-password::
HTTP password for the user account.
== EXAMPLES
Create a new batch/role access user account called `watcher` in
the 'Non-Interactive Users' group.
====
$ cat ~/.ssh/id_watcher.pub | ssh -p 29418 review.example.com gerrit create-account --group "'Non-Interactive Users'" --ssh-key - watcher
====
GERRIT
------
Part of link:index.html[Gerrit Code Review]
SEARCHBOX
---------