blob: cc797cc39e7f5f8d57415a648ec0479694c6a3a0 [file] [log] [blame]
Yuxuan 'fishy' Wang61698b12013-12-20 12:55:51 -08001= gerrit version
Magnus Bäckf9b41a42012-09-25 12:20:39 -04002
Yuxuan 'fishy' Wang61698b12013-12-20 12:55:51 -08003== NAME
Magnus Bäckf9b41a42012-09-25 12:20:39 -04004gerrit version - Show the version of the currently executing Gerrit server
5
Yuxuan 'fishy' Wang61698b12013-12-20 12:55:51 -08006== SYNOPSIS
Michael Ochmanne2d76a12016-06-23 17:07:37 +02007[verse]
Yuxuan 'fishy' Wangd85b6872013-11-15 11:47:46 -08008--
Michael Ochmanne2d76a12016-06-23 17:07:37 +02009_ssh_ -p <port> <host> _gerrit version_
Yuxuan 'fishy' Wangd85b6872013-11-15 11:47:46 -080010--
Magnus Bäckf9b41a42012-09-25 12:20:39 -040011
Yuxuan 'fishy' Wang61698b12013-12-20 12:55:51 -080012== DESCRIPTION
Magnus Bäckf9b41a42012-09-25 12:20:39 -040013Displays a one-line response with the string `gerrit version` followed
14by the currently executing version of Gerrit.
15
16The `git describe` command is used to generate the version string based
17on the Git commit used to build Gerrit. For official releases of Gerrit,
18the version string will be equal to the Git tag set in the Gerrit source
19code, which in turn is equal to the name of the release (for example
202.4.2). When building Gerrit from another commit (one that doesn't have
21an official-looking tag pointing to it), the version string has the form
22`<tagname>-<n>-g<sha1>`, where `<n>` is an integer indicating the number
23of commits ahead of the `<tagname>` tag the commit is, and `<sha1>` is
24the seven-character abbreviated SHA-1 of the commit. See the `git
25describe` documentation for details on how `<tagname>` is chosen and how
26`<n>` is computed.
27
Yuxuan 'fishy' Wang61698b12013-12-20 12:55:51 -080028== ACCESS
Magnus Bäckf9b41a42012-09-25 12:20:39 -040029Any user who has configured an SSH key.
30
Yuxuan 'fishy' Wang61698b12013-12-20 12:55:51 -080031== SCRIPTING
Magnus Bäckf9b41a42012-09-25 12:20:39 -040032This command is intended to be used in scripts.
33
Yuxuan 'fishy' Wang61698b12013-12-20 12:55:51 -080034== EXAMPLES
Magnus Bäckf9b41a42012-09-25 12:20:39 -040035
Michael Ochmannb99feab2016-07-06 14:10:22 +020036----
Magnus Bäckf9b41a42012-09-25 12:20:39 -040037 $ ssh -p 29418 review.example.com gerrit version
38 gerrit version 2.4.2
Michael Ochmannb99feab2016-07-06 14:10:22 +020039----
Magnus Bäckf9b41a42012-09-25 12:20:39 -040040
41GERRIT
42------
43Part of link:index.html[Gerrit Code Review]
Yuxuan 'fishy' Wang99cb68d2013-10-31 17:26:00 -070044
45SEARCHBOX
46---------