"Fossies" - the Fresh Open Source Software Archive

Member "git-ls-remote.txt" (15 Dec 2018, 3870 Bytes) of package /linux/misc/git-htmldocs-2.20.1.tar.xz:


As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file.

    1 git-ls-remote(1)
    2 ================
    3 
    4 NAME
    5 ----
    6 git-ls-remote - List references in a remote repository
    7 
    8 
    9 SYNOPSIS
   10 --------
   11 [verse]
   12 'git ls-remote' [--heads] [--tags] [--refs] [--upload-pack=<exec>]
   13 	      [-q | --quiet] [--exit-code] [--get-url] [--sort=<key>]
   14 	      [--symref] [<repository> [<refs>...]]
   15 
   16 DESCRIPTION
   17 -----------
   18 Displays references available in a remote repository along with the associated
   19 commit IDs.
   20 
   21 
   22 OPTIONS
   23 -------
   24 -h::
   25 --heads::
   26 -t::
   27 --tags::
   28 	Limit to only refs/heads and refs/tags, respectively.
   29 	These options are _not_ mutually exclusive; when given
   30 	both, references stored in refs/heads and refs/tags are
   31 	displayed.
   32 
   33 --refs::
   34 	Do not show peeled tags or pseudorefs like HEAD	in the output.
   35 
   36 -q::
   37 --quiet::
   38 	Do not print remote URL to stderr.
   39 
   40 --upload-pack=<exec>::
   41 	Specify the full path of 'git-upload-pack' on the remote
   42 	host. This allows listing references from repositories accessed via
   43 	SSH and where the SSH daemon does not use the PATH configured by the
   44 	user.
   45 
   46 --exit-code::
   47 	Exit with status "2" when no matching refs are found in the remote
   48 	repository. Usually the command exits with status "0" to indicate
   49 	it successfully talked with the remote repository, whether it
   50 	found any matching refs.
   51 
   52 --get-url::
   53 	Expand the URL of the given remote repository taking into account any
   54 	"url.<base>.insteadOf" config setting (See linkgit:git-config[1]) and
   55 	exit without talking to the remote.
   56 
   57 --symref::
   58 	In addition to the object pointed by it, show the underlying
   59 	ref pointed by it when showing a symbolic ref.  Currently,
   60 	upload-pack only shows the symref HEAD, so it will be the only
   61 	one shown by ls-remote.
   62 
   63 --sort=<key>::
   64 	Sort based on the key given. Prefix `-` to sort in descending order
   65 	of the value. Supports "version:refname" or "v:refname" (tag names
   66 	are treated as versions). The "version:refname" sort order can also
   67 	be affected by the "versionsort.suffix" configuration variable.
   68 	See linkgit:git-for-each-ref[1] for more sort options, but be aware
   69 	keys like `committerdate` that require access to the objects
   70 	themselves will not work for refs whose objects have not yet been
   71 	fetched from the remote, and will give a `missing object` error.
   72 
   73 -o <option>::
   74 --server-option=<option>::
   75 	Transmit the given string to the server when communicating using
   76 	protocol version 2.  The given string must not contain a NUL or LF
   77 	character.
   78 	When multiple `--server-option=<option>` are given, they are all
   79 	sent to the other side in the order listed on the command line.
   80 
   81 <repository>::
   82 	The "remote" repository to query.  This parameter can be
   83 	either a URL or the name of a remote (see the GIT URLS and
   84 	REMOTES sections of linkgit:git-fetch[1]).
   85 
   86 <refs>...::
   87 	When unspecified, all references, after filtering done
   88 	with --heads and --tags, are shown.  When <refs>... are
   89 	specified, only references matching the given patterns
   90 	are displayed.
   91 
   92 EXAMPLES
   93 --------
   94 
   95 	$ git ls-remote --tags ./.
   96 	d6602ec5194c87b0fc87103ca4d67251c76f233a	refs/tags/v0.99
   97 	f25a265a342aed6041ab0cc484224d9ca54b6f41	refs/tags/v0.99.1
   98 	7ceca275d047c90c0c7d5afb13ab97efdf51bd6e	refs/tags/v0.99.3
   99 	c5db5456ae3b0873fc659c19fafdde22313cc441	refs/tags/v0.99.2
  100 	0918385dbd9656cab0d1d81ba7453d49bbc16250	refs/tags/junio-gpg-pub
  101 	$ git ls-remote http://www.kernel.org/pub/scm/git/git.git master pu rc
  102 	5fe978a5381f1fbad26a80e682ddd2a401966740	refs/heads/master
  103 	c781a84b5204fb294c9ccc79f8b3baceeb32c061	refs/heads/pu
  104 	$ git remote add korg http://www.kernel.org/pub/scm/git/git.git
  105 	$ git ls-remote --tags korg v\*
  106 	d6602ec5194c87b0fc87103ca4d67251c76f233a	refs/tags/v0.99
  107 	f25a265a342aed6041ab0cc484224d9ca54b6f41	refs/tags/v0.99.1
  108 	c5db5456ae3b0873fc659c19fafdde22313cc441	refs/tags/v0.99.2
  109 	7ceca275d047c90c0c7d5afb13ab97efdf51bd6e	refs/tags/v0.99.3
  110 
  111 SEE ALSO
  112 --------
  113 linkgit:git-check-ref-format[1].
  114 
  115 GIT
  116 ---
  117 Part of the linkgit:git[1] suite