Svenska â–Ÿ Topics â–Ÿ Latest version â–Ÿ git-ls-tree last updated in 2.42.0

NAMN

git-ls-tree - Lista innehÄllet i ett trÀdobjekt

SYNOPSIS

git ls-tree [-d] [-r] [-t] [-l] [-z]
	    [--name-only] [--name-status] [--object-only] [--full-name] [--full-tree] [--abbrev[=<n>]] [--format=<format>]
	    <trĂ€dlikt> [<sökvĂ€g>
​]

BESKRIVNING

Listar innehÄllet i ett givet trÀdobjekt, ungefÀr som vad "/bin/ls -a" gör i den aktuella arbetskatalogen. Observera att:

  • Beteendet skiljer sig nĂ„got frĂ„n "/bin/ls" genom att <sökvĂ€g> bara anger en lista med mönster som ska matchas, t.ex. sĂ„ att ange katalognamn (utan -r) kommer att bete sig annorlunda, och ordningen pĂ„ argumenten spelar ingen roll.

  • Beteendet liknar det för "/bin/ls" i det att <sökvĂ€g> tas som relativ till den aktuella arbetskatalogen. T.ex. nĂ€r du Ă€r i en katalog sub som har en katalog dir kan du köra git ls-tree -r HEAD dir för att lista innehĂ„llet i trĂ€det (det vill sĂ€ga sub/dir i HEAD). Du vill inte ange ett trĂ€d som inte Ă€r pĂ„ rotnivĂ„ (t.ex. git ls-tree -r HEAD:sub dir) i det hĂ€r fallet, eftersom det skulle resultera i att frĂ„ga efter sub/sub/dir i HEAD-incheckningen. Den aktuella arbetskatalogen kan dock ignoreras genom att skicka alternativet --full-tree.

ALTERNATIV

<trÀdlikt>

ID för ett trÀdlikt objekt.

-d

Visa endast sjÀlva den namngivna trÀdposten, inte dess barn.

-r

Rekursera ner i undertrÀd.

-t

Visar trÀdposter Àven nÀr man ska anvÀnda rekursiv funktion. Har ingen effekt om -r inte skickades. -d innebÀr -t.

-l
--long

Visa objektstorlek för blob-poster (filposter).

-z

\0 radavslutning vid utdata och citera inte filnamn. Se UTMATNINGSFORMAT nedan för mer information.

--name-only
--name-status

Lista endast filnamn (i stÀllet för den "lÄnga" utdatan), ett per rad. Kan inte kombineras med --object-only.

--object-only

Lista endast namnen pÄ objekten, ett per rad. Kan inte kombineras med --name-only eller --name-status. Detta motsvarar att ange --format='%(objektnamn), men för bÄde detta alternativ och exakt det formatet anvÀnder kommandot en handoptimerad kodvÀg i stÀllet för att gÄ via den generiska formateringsmekanismen.

--abbrev[=<n>]

I stÀllet för att visa hela 40-byte hexadecimala objektraderna, visa det kortaste prefixet som Àr minst <n> hexdigits lÄngt och som unikt refererar till objektet. Antal siffror som inte Àr standard kan anges med --abbrev=<n>.

--full-name

I stÀllet för att visa sökvÀgarna i förhÄllande till den aktuella arbetskatalogen, visa de fullstÀndiga sökvÀgarna.

--full-tree

BegrÀnsa inte listan till den aktuella arbetskatalogen. InnebÀr --full-name.

--format=<format>

En strÀng som interpolerar %(fÀltnamn) frÄn resultatet som visas. Den interpolerar ocksÄ %% till %, och %xNN dÀr NN Àr hexagonala siffror interpolerar till tecken med hexagonalkod NN; till exempel interpolerar %x00 till \0 (NUL), %x09 till \t (TAB) och %x0a till \n (LF). NÀr --format anges kan den inte kombineras med andra formatÀndringsalternativ, inklusive --long, --name-only och --object-only.

[<sökvĂ€g>
​]

NÀr sökvÀgar anges, visa dem (observera att detta inte Àr rÄa sökvÀgsnamn, utan snarare en lista med mönster som ska matcha). Annars anvÀnds implicit trÀdets rotnivÄ som enda sökvÀgsargument.

Utdataformat

Utdataformatet för ls-tree bestÀms antingen av alternativet --format eller andra format-Àndringsalternativ som --name-only etc. (se --format ovan).

AnvÀndningen av vissa --format-direktiv motsvarar att anvÀnda dessa alternativ, men att anropa hela formateringsmaskineriet kan vara lÄngsammare Àn att anvÀnda ett lÀmpligt formateringsalternativ.

I de fall dÀr --format exakt skulle mappas till ett befintligt alternativ kommer ls-tree att anvÀnda lÀmplig snabbare sökvÀg. Standardformatet Àr alltsÄ likvÀrdigt med:

%(objectmode) %(objecttype) %(objectname)%x09%(path)

Det hÀr utdataformat Àr kompatibelt med vad --index-info --stdin i git update-index förvÀntar sig.

NÀr alternativet -l anvÀnds Àndras formatet till

%(objectmode) %(objecttype) %(objectname) %(objectsize:padded)%x09%(path)

Objektstorleken som identifieras av <objektnamn> anges i byte och Àr högerjusterad med en minsta bredd pÄ 7 tecken. Objektstorleken anges endast för blob-poster (filposter); för andra poster anvÀnds --tecknet i stÀllet för storlek.

Utan -z-alternativet citeras sökvÀgar med "ovanliga" tecken enligt beskrivningen för konfigurationsvariabeln core.quotePath (se git-config[1]). Med -z matas filnamnet ut ordagrant och raden avslutas med en NUL-byte.

Anpassat format:

Det Àr möjligt att skriva ut i ett anpassat format genom att anvÀnda alternativet --format, vilket kan interpolera olika fÀlt med hjÀlp av notationen %(fÀltnamn). Om du till exempel bara bryr dig om fÀlten "objektnamn" och "sökvÀg" kan du köra med ett specifikt "--format" som

git ls-tree --format='%(objectname) %(path)' <trÀdlikt>

FÄLTNAMN

Olika vÀrden frÄn strukturerade fÀlt kan anvÀndas för att interpolera in i den resulterande utdata. För varje utmatningsrad kan följande namn anvÀndas:

objectmode

Objektets lÀge.

objecttype

Objektets typ (commit, blob eller tree).

objectname

Objektets namn.

objectsize[:padded]

Storleken pÄ ett blob-objekt ("-" om det Àr ett commit eller tree). Det stöder ocksÄ ett utfyllt format med storleken "%(objectsize:padded)".

sökvÀg

Objektets sökvÀg.

GIT

En del av git[1]-sviten