blob: cdfc779f161fa595edde8aea214dcc4df31f0046 [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
David Shevitzc47f2362018-09-27 10:55:35 -07004gerrit version - Show the version of the currently executing Gerrit server.
Magnus Bäckf9b41a42012-09-25 12:20:39 -04005
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
Gert van Dijkdc4f8d12017-08-27 21:14:23 +020029Any user who has SSH access to Gerrit.
Magnus Bäckf9b41a42012-09-25 12:20:39 -040030
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----
David Shevitzc47f2362018-09-27 10:55:35 -070037$ ssh -p 29418 review.example.com gerrit version
38gerrit 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---------