English ▾ Themen ▾ Neueste Version ▾ git-ls-remote zuletzt aktualisiert in 2.48.0

NAME

git-ls-remote - Referenzen in einem entfernten Repository auflisten

SYNOPSIS

git ls-remote [--branches] [--tags] [--refs] [--upload-pack=<exec>]
	      [-q | --quiet] [--exit-code] [--get-url] [--sort=<key>]
	      [--symref] [<repository> [<patterns>…​]]

BESCHREIBUNG

Zeigt die im entfernten Repository verfügbaren Referenzen zusammen mit den zugehörigen Commit-IDs an.

OPTIONEN

-b
--branches
-t
--tags

Beschränkt auf lokale Branches bzw. lokale Tags. Diese Optionen sind *nicht* gegenseitig ausschließend; wenn beide angegeben werden, werden Referenzen angezeigt, die in refs/heads und refs/tags gespeichert sind. Beachten Sie, dass --heads und -h veraltete Synonyme für --branches und -b sind und in Zukunft entfernt werden könnten. Beachten Sie auch, dass git ls-remote -h ohne weitere Angaben auf der Befehlszeile Hilfe anzeigt, wie bei anderen Git-Unterbefehlen üblich.

--refs

Zeigt keine "peeled" Tags oder Pseudoreferenzen wie HEAD in der Ausgabe an.

-q
--quiet

Schreibt die entfernte URL nicht nach stderr.

--upload-pack=<exec>

Gibt den vollständigen Pfad zu git-upload-pack auf dem entfernten Host an. Dies ermöglicht das Auflisten von Referenzen aus Repositories, auf die über SSH zugegriffen wird und bei denen der SSH-Daemon nicht den vom Benutzer konfigurierten PATH verwendet.

--exit-code

Beendet mit dem Status "2", wenn keine übereinstimmenden Referenzen im entfernten Repository gefunden werden. Normalerweise beendet sich der Befehl mit dem Status "0", um anzuzeigen, dass er erfolgreich mit dem entfernten Repository kommuniziert hat, unabhängig davon, ob er übereinstimmende Referenzen gefunden hat.

--get-url

Erweitert die URL des angegebenen entfernten Repositories unter Berücksichtigung jeder "url.<base>.insteadOf" Konfigurationseinstellung (siehe git-config[1]) und beendet, ohne mit dem Remote zu sprechen.

--symref

Zusätzlich zum Objekt, auf das es zeigt, wird die zugrunde liegende Referenz angezeigt, auf die es zeigt, wenn eine symbolische Referenz angezeigt wird. Derzeit zeigt upload-pack nur die symbolische Referenz HEAD an, so dass dies die einzige sein wird, die von ls-remote angezeigt wird.

--sort=<key>

Sortiert basierend auf dem angegebenen Schlüssel. Präfixieren Sie -, um in absteigender Reihenfolge des Werts zu sortieren. Unterstützt "version:refname" oder "v:refname" (Tag-Namen werden als Versionen behandelt). Die Sortierreihenfolge "version:refname" kann auch von der Konfigurationsvariable "versionsort.suffix" beeinflusst werden. Weitere Sortieroptionen finden Sie in git-for-each-ref[1], aber seien Sie sich bewusst, dass Schlüssel wie committerdate, die Zugriff auf die Objekte selbst erfordern, nicht für Referenzen funktionieren, deren Objekte noch nicht vom Remote geholt wurden, und einen Fehler missing object liefern.

-o <option>
--server-option=<option>

Überträgt die angegebene Zeichenkette an den Server, wenn die Kommunikation über Protokollversion 2 erfolgt. Die angegebene Zeichenkette darf kein NUL- oder LF-Zeichen enthalten. Wenn mehrere --server-option=<option> angegeben werden, werden sie alle in der auf der Befehlszeile angegebenen Reihenfolge an die Gegenseite gesendet. Wenn von der Befehlszeile keine --server-option=<option> angegeben wird, werden stattdessen die Werte der Konfigurationsvariable remote.<name>.serverOption verwendet.

<repository>

Das "entfernte" Repository, das abgefragt werden soll. Dieser Parameter kann entweder eine URL oder der Name eines Remotes sein (siehe die Abschnitte GIT URLS und REMOTES von git-fetch[1]).

<patterns>…​

Wenn nicht angegeben, werden alle Referenzen angezeigt, nachdem sie mit --heads und --tags gefiltert wurden. Wenn <patterns>…​ angegeben sind, werden nur Referenzen angezeigt, die einem oder mehreren der angegebenen Muster entsprechen. Jedes Muster wird als Glob interpretiert (siehe glob in gitglossary[7]), das gegen den "Schwanz" einer Referenz abgeglichen wird, entweder vom Anfang der Referenz (sodass ein vollständiger Name wie refs/heads/foo übereinstimmt) oder von einem Schrägstrich-Separator (sodass bar mit refs/heads/bar übereinstimmt, aber nicht mit refs/heads/foobar).

AUSGABE

Die Ausgabe erfolgt im Format

<oid> TAB <ref> LF

Wenn ein annotierter Tag angezeigt wird und --refs nicht angegeben ist, werden zwei solche Zeilen angezeigt: eine mit dem Refnamen für den Tag selbst als <ref> und eine weitere mit <ref> gefolgt von ^{}. Das <oid> in der letzteren Zeile zeigt den Namen des Objekts an, auf das der Tag zeigt.

BEISPIELE

  • Alle Referenzen (einschließlich symbolischer und Pseudoreferenzen) auflisten, Tags "peelen"

    $ git ls-remote
    27d43aaaf50ef0ae014b88bba294f93658016a2e	HEAD
    950264636c68591989456e3ba0a5442f93152c1a	refs/heads/main
    d9ab777d41f92a8c1684c91cfb02053d7dd1046b	refs/heads/next
    d4ca2e3147b409459955613c152220f4db848ee1	refs/tags/v2.40.0
    73876f4861cd3d187a4682290ab75c9dccadbc56	refs/tags/v2.40.0^{}
  • Alle Referenzen auflisten, die mit den angegebenen Mustern übereinstimmen

    $ git ls-remote http://www.kernel.org/pub/scm/git/git.git master seen rc
    5fe978a5381f1fbad26a80e682ddd2a401966740	refs/heads/master
    c781a84b5204fb294c9ccc79f8b3baceeb32c061	refs/heads/seen
  • Nur Tags auflisten, die mit einem angegebenen Wildcard-Muster übereinstimmen

    $ git ls-remote --tags http://www.kernel.org/pub/scm/git/git.git v\*
    485a869c64a68cc5795dd99689797c5900f4716d	refs/tags/v2.39.2
    cbf04937d5b9fcf0a76c28f69e6294e9e3ecd7e6	refs/tags/v2.39.2^{}
    d4ca2e3147b409459955613c152220f4db848ee1	refs/tags/v2.40.0
    73876f4861cd3d187a4682290ab75c9dccadbc56	refs/tags/v2.40.0^{}

GIT

Teil der git[1] Suite