OnWorks favicon

git-symbolic-ref - Online in the Cloud

Run git-symbolic-ref in OnWorks free hosting provider over Ubuntu Online, Fedora Online, Windows online emulator or MAC OS online emulator

This is the command git-symbolic-ref that can be run in the OnWorks free hosting provider using one of our multiple free online workstations such as Ubuntu Online, Fedora Online, Windows online emulator or MAC OS online emulator



git-symbolic-ref - Read, modify and delete symbolic refs


git symbolic-ref [-m <reason>] <name> <ref>
git symbolic-ref [-q] [--short] <name>
git symbolic-ref --delete [-q] <name>


Given one argument, reads which branch head the given symbolic ref refers to and outputs
its path, relative to the .git/ directory. Typically you would give HEAD as the <name>
argument to see which branch your working tree is on.

Given two arguments, creates or updates a symbolic ref <name> to point at the given branch

Given --delete and an additional argument, deletes the given symbolic ref.

A symbolic ref is a regular file that stores a string that begins with ref: refs/. For
example, your .git/HEAD is a regular file whose contents is ref: refs/heads/master.


-d, --delete
Delete the symbolic ref <name>.

-q, --quiet
Do not issue an error message if the <name> is not a symbolic ref but a detached HEAD;
instead exit with non-zero status silently.

When showing the value of <name> as a symbolic ref, try to shorten the value, e.g.
from refs/heads/master to master.

Update the reflog for <name> with <reason>. This is valid only when creating or
updating a symbolic ref.


In the past, .git/HEAD was a symbolic link pointing at refs/heads/master. When we wanted
to switch to another branch, we did ln -sf refs/heads/newbranch .git/HEAD, and when we
wanted to find out which branch we are on, we did readlink .git/HEAD. But symbolic links
are not entirely portable, so they are now deprecated and symbolic refs (as described
above) are used by default.

git symbolic-ref will exit with status 0 if the contents of the symbolic ref were printed
correctly, with status 1 if the requested name is not a symbolic ref, or 128 if another
error occurs.


Part of the git(1) suite

Use git-symbolic-ref online using onworks.net services

Free Servers & Workstations

Download Windows & Linux apps

  • 1
    Clover EFI bootloader
    Clover EFI bootloader
    Project has moved to
    Features:Boot macOS, Windows, and Linux
    in UEFI or legacy mode on Mac or PC with
    Download Clover EFI bootloader
  • 2
    Join us in Gitter!
    Enable the URPMS repository in your
    system -
    Download unitedrpms
  • 3
    Boost C++ Libraries
    Boost C++ Libraries
    Boost provides free portable
    peer-reviewed C++ libraries. The
    emphasis is on portable libraries which
    work well with the C++ Standard Library.
    See http://www.bo...
    Download Boost C++ Libraries
  • 4
    VirtualGL redirects 3D commands from a
    Unix/Linux OpenGL application onto a
    server-side GPU and converts the
    rendered 3D images into a video stream
    with which ...
    Download VirtualGL
  • 5
    Library to enable user space
    application programs to communicate with
    USB devices. Audience: Developers, End
    Users/Desktop. Programming Language: C.
    Download libusb
  • 6
    SWIG is a software development tool
    that connects programs written in C and
    C++ with a variety of high-level
    programming languages. SWIG is used with
    Download SWIG
  • More »

Linux commands