Setup and Config
Getting and Creating Projects
Basic Snapshotting
Branching and Merging
Sharing and Updating Projects
Inspection and Comparison
Patching
Debugging
External Systems
Server Admin
Guides
- gitattributes
- Command-line interface conventions
- Everyday Git
- Frequently Asked Questions (FAQ)
- Glossary
- Hooks
- gitignore
- gitmodules
- Revisions
- Submodules
- Tutorial
- Workflows
- All guides...
Administration
Plumbing Commands
- 2.48.1 → 2.53.0 no changes
-
2.48.0
2025-01-10
- 2.43.1 → 2.47.3 no changes
-
2.43.0
2023-11-20
- 2.39.1 → 2.42.4 no changes
-
2.39.0
2022-12-12
- 2.1.4 → 2.38.5 no changes
-
2.0.5
2014-12-17
SYNOPSIS
git symbolic-ref [-m <anledning>] <namn> <ref>
git symbolic-ref [-q] [--short] [--no-recurse] <namn>
git symbolic-ref --delete [-q] <namn>
BESKRIVNING
Givet ett argument, läser vilket grenhuvud den givna symboliska referensen refererar till och matar ut dess sökväg, relativt till .git/-katalogen. Vanligtvis skulle du ange HEAD som <namn>-argument för att se vilken gren ditt arbetskatalog finns på.
Skapar eller uppdaterar, givet två argument, en symbolisk ref <namn> som pekar på den givna grenen <ref>.
Givet --delete och ett ytterligare argument, raderas den givna symboliska referensen.
En symbolisk ref är en vanlig fil som lagrar en sträng som börjar med ref: refs/. Till exempel är din .git/HEAD en vanlig fil vars innehåll är ref: refs/heads/master.
ALTERNATIV
- -d
- --delete
-
Ta bort den symboliska referensen <namn>.
- -q
- --quiet
-
Ge inte ett felmeddelande om <namn> inte är en symbolisk referens utan en fristående HEAD; avsluta istället med status som inte är noll i tysthet.
- --short
-
När du visar värdet för <namn> som en symbolisk referens, försök att förkorta värdet, t.ex. från
refs/heads/mastertillmaster. - --recurse
- --no-recurse
-
När värdet för <namn> visas som en symbolisk referens, om <namn> refererar till en annan symbolisk referens, följ en sådan kedja av symboliska referenser tills resultatet inte längre pekar på en symbolisk referens (
--recurse, vilket är standardvärdet).--no-recursestoppar efter att endast en enda nivå av symbolisk referens har avrefererats. - -m
-
Uppdatera refloggen för <namn> med <orsak>. Detta gäller endast när man skapar eller uppdaterar en symbolisk referens.
NOTERINGAR
Förr i tiden var .git/HEAD en symbolisk länk som pekade på refs/heads/master. När vi ville byta till en annan gren gjorde vi ln -sf refs/heads/newbranch .git/HEAD, och när vi ville ta reda på vilken gren vi är på gjorde vi readlink .git/HEAD. Men symboliska länkar är inte helt portabla, så de är nu föråldrade och symboliska referenser (som beskrivs ovan) används som standard.
git symbolic-ref avslutas med status 0 om innehållet i den symboliska referensen skrevs ut korrekt, med status 1 om det begärda namnet inte är en symbolisk referens, eller 128 om ett annat fel uppstår.
GIT
En del av git[1]-sviten