git-archive(1)

NAMN

git-archive - Skapa ett arkiv av filer från ett namngivet träd

SYNOPSIS

git archive [--format=<fmt>] [--list] [--prefix=<prefix>/] [<extra>]

                   [-o <fil> | --output=<fil>] [--worktree-attributes]
                   [--remote=<repo> [--exec=<git-upload-archive>]] <tree-ish>
                   [<sökväg>...]

BESKRIVNING

Skapar ett arkiv i det angivna formatet som innehåller trädstrukturen för det namngivna trädet och skriver ut det till standardutgången. Om <prefix> anges, läggs det till i början av filnamnen i arkivet.

git archive beter sig annorlunda när det ges ett träd-ID i motsats till ett commit-ID eller tagg-ID. När ett träd-ID anges används den aktuella tiden som ändringstid för varje fil i arkivet. Å andra sidan, när ett commit-ID eller tagg-ID anges, används commit-tiden som registrerats i det refererade commit-objektet istället. Dessutom lagras commit-ID:t i ett globalt utökat pax-huvud om tar-formatet används; det kan extraheras med git get-tar-commit-id. I ZIP-filer lagras det som en filkommentar.

ALTERNATIV

• --format=<fmt>

Formatet på det resulterande arkivet. Möjliga värden är tar, zip, tar.gz, tgz och alla format som definieras med konfigurationsalternativet tar.<format>.command. Om --format inte anges och utdatafilen specificeras, härleds formatet från filnamnet om möjligt (t.ex. att skriva till foo.zip gör att utdata blir i zip-formatet). Annars är utdataformatet tar.

• -l, --list

Visa alla tillgängliga format.

• -v, --verbose

Rapportera framsteg till stderr.

• --prefix=<prefix>/

Lägg till <prefix>/ i början av sökvägarna i arkivet. Kan upprepas; det högraste värdet används för alla spårade filer. Se nedan vilket värde som används av --add-file.

• -o <fil>, --output=<fil>

Skriv arkivet till <fil> istället för stdout.

• --add-file=<fil>

Lägg till en icke-spårad fil till arkivet. Kan upprepas för att lägga till flera filer. Filens sökväg i arkivet byggs genom att sammanfoga värdet av det sista --prefix alternativet (om något) före detta --add-file och basnamnet på <fil>.

• --add-virtual-file=<sökväg>:<innehåll>

Lägg till det angivna innehållet till arkivet. Kan upprepas för att lägga till flera filer.

Argumentet <sökväg> kan börja och sluta med ett bokstavligt dubbelt citattecken; det innehållna filnamnet tolkas som en C-liknande sträng, d.v.s. backslash tolkas som ett escape-tecken. Sökvägen måste citeras om den innehåller ett kolon, för att undvika att kolon tolkas felaktigt som separatorn mellan sökvägen och innehållet, eller om sökvägen börjar eller slutar med ett dubbelt citattecken.

Filmoden är begränsad till en vanlig fil, och alternativet kan vara föremål för plattformsspecifika kommandoradsbegränsningar. För icke-triviala fall, skriv en icke-spårad fil och använd --add-file istället.

Observera att till skillnad från --add-file påverkas inte sökvägen som skapas i arkivet av alternativet --prefix, eftersom en fullständig <sökväg> kan anges som värdet på alternativet.

• --worktree-attributes

Leta efter attribut i .gitattributes-filer även i arbetskopian (se avsnittet "ATTRIBUTES").

• --mtime=<tid>

Ange ändringstid för arkivposter. Utan detta alternativ används committer-tiden om <tree-ish> är en commit eller tagg, och den aktuella tiden om det är ett träd.

• <extra>

Detta kan vara alla alternativ som arkiveringsbackendet förstår. Se nästa avsnitt.

• --remote=<repo>

Istället för att skapa ett tar-arkiv från det lokala arkivet, hämta ett tar-arkiv från ett fjärrarkiv. Observera att fjärrarkivet kan ha begränsningar för vilka sha1-uttryck som tillåts i <tree-ish>. Se git-upload-archive(1) för mer information.

• --exec=<git-upload-archive>

Används med --remote för att ange sökvägen till git-upload-archive på fjärrsidan.

• <tree-ish>

Trädet eller commiten som ett arkiv ska skapas för.

• <sökväg>

Utan en valfri sökvägsparameter inkluderas alla filer och underkataloger i den aktuella arbetskatalogen i arkivet. Om en eller flera sökvägar anges inkluderas endast dessa.

BACKEND-EXTRA-ALTERNATIV

• zip

-<siffra>

Ange komprimeringsnivå. Större värden tillåter kommandot att spendera mer tid på att komprimera till mindre storlek. Stödda värden är från -0 (lagra endast) till -9 (bästa förhållande). Standard är -6 om inget anges.

• tar

-<nummer>

Ange komprimeringsnivå. Värdet kommer att skickas till komprimeringskommandot som konfigurerats i tar.<format>.command. Se manualsidan för det konfigurerade kommandot för listan över stödda nivåer och standardnivån om detta alternativ inte anges.

KONFIGURATION

• tar.umask

Denna variabel kan användas för att begränsa rättighetsbitarna för tar-arkivposter. Standardvärdet är 0002, vilket stänger av skrivbiten för alla. Specialvärdet "user" indikerar att den arkiverande användarens umask kommer att användas istället. Se umask(2) för mer information. Om --remote används gäller endast konfigurationen av fjärrarkivet.

• tar.<format>.command

Denna variabel anger ett shell-kommando genom vilket tar-utdata genererat av git archive ska skickas via pipe. Kommandot exekveras med skalet med den genererade tar-filen på standardinmatningen och bör producera den slutliga utdatan på standardutmatningen. Eventuella komprimeringsnivåalternativ kommer att skickas till kommandot (t.ex. -9).

Formaten tar.gz och tgz definieras automatiskt och använder standardkommandot git archive gzip, vilket anropar en intern implementering av gzip.

• tar.<format>.remote

Om sant, aktivera formatet för användning av fjärrklienter via git-upload-archive(1). Standardvärdet är falskt för användardefinierade format, men sant för formaten tar.gz och tgz.

ATTRIBUT

• export-ignore

Filer och kataloger med attributet export-ignore kommer inte att läggas till i arkivfiler. Se gitattributes(5) för mer information.

• export-subst

Om attributet export-subst är inställt för en fil kommer Git att expandera flera platshållare när filen läggs till i ett arkiv. Se gitattributes(5) för mer information.

Observera att attribut som standard hämtas från filerna .gitattributes i det träd som arkiveras. Om du vill justera hur utdata genereras i efterhand (t.ex. om du har commitat utan att lägga till en lämplig export-ignore i dess .gitattributes), justera den utcheckade .gitattributes filen efter behov och använd alternativet --worktree-attributes. Alternativt kan du behålla nödvändiga attribut som ska gälla vid arkivering av alla träd i din fil $GIT_DIR/info/attributes.

EXEMPEL

• git archive --format=tar --prefix=junk/ HEAD | (cd /var/tmp/ && tar xf -)

Skapa ett tar-arkiv som innehåller innehållet i den senaste commiten på den aktuella grenen och packa upp det i katalogen /var/tmp/junk.

• git archive --format=tar --prefix=git-1.4.0/ v1.4.0 | gzip > git-1.4.0.tar.gz

Skapa en komprimerad tarball för v1.4.0-releasen.

• git archive --format=tar.gz --prefix=git-1.4.0/ v1.4.0 > git-1.4.0.tar.gz

Samma som ovan, men med den inbyggda hanteringen av tar.gz.

• git archive --prefix=git-1.4.0/ -o git-1.4.0.tar.gz v1.4.0

Samma som ovan, men formatet härleds från utdatafilen.

• git archive --format=tar --prefix=git-1.4.0/ v1.4.0^{tree} | gzip > git-1.4.0.tar.gz

Skapa en komprimerad tarball för v1.4.0-releasen, men utan ett globalt utökat pax-huvud.

• git archive --format=zip --prefix=git-docs/ HEAD:Documentation/ > git-1.4.0-docs.zip

Lägg allt i den aktuella headens Documentation/-katalog i git-1.4.0-docs.zip, med prefixet git-docs/.

• git archive -o latest.zip HEAD

Skapa ett Zip-arkiv som innehåller innehållet i den senaste commiten på den aktuella grenen. Observera att utdataformatet härleds från utdatafilens filändelse.

• git archive -o latest.tar --prefix=build/ --add-file=configure --prefix= HEAD

Skapar ett tar-arkiv som innehåller innehållet i den senaste commiten på den aktuella grenen utan prefix och den icke-spårade filen configure med prefixet build/.

• git config tar.tar.xz.command "xz -c"

Konfigurera ett "tar.xz"-format för att skapa LZMA-komprimerade tarfiler. Du kan använda det genom att ange --format=tar.xz eller genom att skapa en utdatafil som -o foo.tar.xz.

SE ÄVEN

gitattributes(5)

GIT

Del av git(1)-sviten

KOLOFON

Den här sidan är en del av projektet git (Git distribuerat versionshanteringssystem). Information om projektet finns på ⟨http://git-scm.com/⟩. Om du har en felrapport för den här manualsidan, se ⟨http://git-scm.com/community⟩. Den här sidan hämtades från projektets uppströms Git-arkiv ⟨https://github.com/git/git.git⟩ den 2025-02-02. (Vid den tidpunkten var datumet för den senaste commiten som hittades i arkivet 2025-01-31.) Om du upptäcker några renderingsproblem i den här HTML-versionen av sidan, eller om du tror att det finns en bättre eller mer aktuell källa för sidan, eller om du har korrigeringar eller förbättringar av informationen i den här KOLOFONEN (som inte är en del av den ursprungliga manualsidan), skicka ett

Sidslut

Orginalhemsidan på Engelska https://man7.org/linux/man-pages/man1/gencnval.1.html

---

Det här är en maskinöversättning av Linux man sidor till svenska. Om du hittar fel är vi tacksamma om du rapporterar dem via formuläret som finns på https://www.linux.se/kontaka-linux-se/

Tack till Datorhjälp som har sponsrat Linux.se med webbhotell.