                            Release Notes for
                              Git Connector

                             Version 2026.1

Introduction

    This document lists all user-visible changes to Git Connector (also
    referred to as the Connector). Release notes for other Perforce
    products are available separately on the Perforce Documentation
    web page.

    The Connector augments the functionality of the P4 Server 
    support Git clients. It services requests from Git clients,
    and stores Git data in Git repos that reside within a depot of type
    graph in the P4 server. Requests are supported over both HTTP(S) and
    SSH connections.

    Perforce numbers releases YYYY.R/CCCCC, e.g. 2017.1/1512253.
    YYYY is the year; R is the release of that year; CCCCC is the
    bug fix change level.  Each bug fix in these release notes is
    marked by its change number.  Any build includes (1) all bug fixes
    of all previous releases and (2) all bug fixes of the current
    release up to the bug fix change level.

    The Connector components 'gconn' and 'git-remote-p4gc' will report
    their version information by passing the '-V' flag.  Additionally,
    Git users can retrieve extended version information through cloning
    '@info' special command by running 'git clone git@ConnectorHost:@info'
    or 'git clone https://ConnectorHost/@info'.

Requirements

    * Git Connector requires an installation of the P4 Server
      2017.1/1504924 or later.

    * The Connector is available in two distribution package formats:
      Debian (.deb) for Ubuntu systems and RPM (.rpm) for CentOS and
      RedHat Enterprise Linux (RHEL). You can install the Connector on
      the following Linux (Intel x86_64) platforms:
          * Ubuntu 14.04 LTS
          * Ubuntu 16.04 LTS
          * Ubuntu 18.04 LTS
          * Ubuntu 20.04 LTS
          * Ubuntu 22.04 LTS
          * Ubuntu 24.04 LTS
          * CentOS or Red Hat 6.x
          * CentOS or Red Hat 7.x
          * CentOS or Red Hat 8.x
          * CentOS or Red Hat 9.x
          * SLES 12 

    * The Connector requires Git version 1.8.5 or later. If the distribution
      package comes with an earlier release of Git, you need to manually
      upgrade to a supported version.

--------------------------------------------------------------------------

Important Product Rebrand Notice

        Helix Core is now P4
        Perforce has a new look and logo that reflects our place in DevOps
        workflows. As part of these changes, Helix Core is now P4. Name updates
        and new icons to align with the P4 branding will be rolled out soon.
        To learn more, see:
          https://www.perforce.com/blog/vcs/introducing-the-p4-platform

--------------------------------------------------------------------------
--------------------------------------------------------------------------

Major new functionality in 2026.1

	#xxxxxxx (Job xxxxxx)
	    Git Connector now supports 2026.1 P4 Server.

No minor new functionality in 2026.1

Bugs fixed in 2026.1

	#2926606 (Bug #131600)
	In gconn a received mirroring event to delete a branch was not removing
	the branch in graph depot. This change fixes the problem.

--------------------------------------------------------------------------

Major new functionality in 2025.2 (2025.2/2852755) (2025/11/14)

	#2840009 (Job 129759)
	    Git Connector now supports 2025.2 P4 Server.

No minor new functionality in 2025.2

No Bugs fixed in 2025.2

--------------------------------------------------------------------------

Major new functionality in 2025.1 (2025.1/2765847) (2025/05/19)

	#2756499 (Job 124762)
	    Git Connector now supports 2025.1 P4 Server.

No minor new functionality in 2025.1

No Bugs fixed in 2025.1

	#2764885 (Job 126572)
	    The configure-git-connector.sh setup script now supports creating a
	    new gconn user against a 2025.1 server with 'dm.user.resetpassword'
	    set to 1.

--------------------------------------------------------------------------

Major new functionality in 2024.2 (2024.2/2676317) (2024/11/04)

	#2668477 (Job 122128)
	    Git Connector now supports 2024.2 Helix Core.

No minor new functionality in 2024.2

No Bugs fixed in 2024.2

--------------------------------------------------------------------------

Major new functionality in 2024.1 (2024.1/2596545) (2024/05/10)

	#2595279 (Job 119639)
	    Git Connector now supports 2024.1 Helix Core.

No minor new functionality in 2024.1

No Bugs fixed in 2024.1

--------------------------------------------------------------------------

Major new functionality in 2023.2 (2023.2/2519612) (2023/11/14)

	#2497731 (Job 117034)
	    Git Connector now supports 2023.2 Helix Core.

No minor new functionality in 2023.2 (2023.2/2519612) (2023/11/14)

Bugs fixed in 2023.2 Patch 1 (2023.2/2523557) (2023/11/23)

	#2523557 (Job #118298) **
	    P4API has been upgraded to 2023.2 Patch 1

Bugs fixed in 2023.2 (2023.2/2519612) (2023/11/14)

	#2514816 (Job #118099)
	    OpenSSL has been upgraded to 3.0.12

--------------------------------------------------------------------------

Major new functionality in 2023.1 (2023.1/2442900) (2023/05/16)

	#2420869 (Job 115678)
	    Git Connector now supports 2023.1 Helix Core.

No minor new functionality in 2023.1

No bugs fixed in 2023.1

--------------------------------------------------------------------------

Major new functionality in 2022.2

	#2332022 (Job 113341)
	    Git Connector now supports 2022.2 Helix Core.

No minor new functionality in 2022.2

Bugs fixed in 2022.2 Patch 1

	#2405360 (Bug 114071)
	    OpenSSL has been upgraded to 1.1.1t

	#2390384 (Bug 113921)
	    Packages for Ubuntu 22.04 LTS and CentOS or Red Hat 9.x added

Bugs fixed in 2022.2

	#2311769 (Bug 111201)
	    'gconn --mirrorhooks list' could give warning: "Caution:
	    <repo-name>'s urls differ". This change fixes the problem.

--------------------------------------------------------------------------

No major new functionality in 2022.1

No minor new functionality in 2022.1

Bugs fixed in 2022.1 Patch 2

	#2405360 (Bug 114071)
	    OpenSSL has been upgraded to 1.1.1t

Bugs fixed in 2022.1 Patch 1

	#2312600 (Bug 111201)
	    'gconn --mirrorhooks list' could give warning: "Caution:
	    <repo-name>'s urls differ". This change fixes the problem.

No bugs fixed in 2022.1

--------------------------------------------------------------------------

No major new functionality in 2021.2

No minor new functionality in 2021.2

Bugs fixed in 2021.2 Patch 2

	#2405360 (Bug 114071)
	    OpenSSL has been upgraded to 1.1.1t

Bugs fixed in 2021.2 Patch 1

	#2312602 (Bug 111201)
	    'gconn --mirrorhooks list' could give warning: "Caution:
	    <repo-name>'s urls differ". This change fixes the problem.

Bugs fixed in 2021.2

	#2134591 (Bug 106263)
	    Performance for 'git fetch' from Helix is improved by avoiding
	    contention of Helix server resources and avoiding packing the
	    same objects for simultaneous 'git fetch'.

--------------------------------------------------------------------------

No major new functionality in 2021.1

No minor new functionality in 2021.1

Bugs fixed in 2021.1 Patch 2

	#2405360 (Bug 114071)
	    OpenSSL has been upgraded to 1.1.1t

Bugs fixed in 2021.1 Patch 1

	#2312603 (Bug 111201)
	    'gconn --mirrorhooks list' could give warning: "Caution:
	    <repo-name>'s urls differ". This change fixes the problem.

Bugs fixed in 2021.1

	#2094409 (Bug #104951)
	    Upgrading p4d and gconn was causing existing mirroring for repos
	    to fail. This change fixes the problem.

--------------------------------------------------------------------------

No major new functionality in 2020.2

Minor new functionality in 2020.2

	#2013020 (Bug 103141)
	    A new command 'gconn show-config' is introduced that prints out
	    the gconn config items. It is used in the gconn configure script
	    and it eliminates the need for the jq package there.

	#1991734 (Bug 102590)
	    The gconn configure script, when run in interactive mode, now
	    prompts for MIN_DISK_SPACE and allows user to change it from the
	    default value. 

	#1991727 (Bug 102578)
	    When git client operation fails because of a gconn error, the error
	    message is now returned to the git client. This requires the Gconn
	    log level in gconn.conf to be at INFO=3 or higher. 

Bugs fixed in 2020.2

	#1975256 (Bug 102789)
	    When gconn is configured with a Windows Helix server, git clone/pull
	    from git-connector could fail with a "failed to move" error message
	    in the p4gc logfile. This change fixes the problem.

--------------------------------------------------------------------------

No major new functionality in 2020.1

No minor new functionality in 2020.1

No bugs fixed in 2020.1

--------------------------------------------------------------------------

No major new functionality in 2019.2

Minor new functionality in 2019.2

	#1823389 (Bug 93209)
	    In "gconn --poll-repos" logic is changed to read the list of cached
	    repos from the server spec field "UpdateCachedRepos".
	    If no records found there, it falls back to reading values from the
	    sever spec field "externalAddress".

	#1840226 (Bug 95468)
	    The git-connector config script now automatically grants admin
	    permission to gconn-user for all graph repos, including those
	    created in the future.

	#1840228 (Bug 97323)
	    The git-connector config script now allows user set any p4 user as
	    the GitConnector user, overwriting the default, 'gconn-user'.

	#1842887 (Bug 98856)
	    The git-connector config script now supports a new command line
	    parameter, minDiskSpace. In ineractive mode the script will prompt
	    for a value.

No bugs fixed in 2019.2

--------------------------------------------------------------------------

Major new functionality in 2019.1

	#1747626 (Bug 96954)
	    Added support for Git LFS Locks.

No minor new functionality in 2019.1

Bugs fixed in 2019.1 Patch 1

	#1711004 (Bug #96503)
	    Update 'git lfs init' to 'git lfs install'.
	    'init' is not supported beginning with LFS v2.0.
	    If the LFS version is less than  1.1.0, GConn will issue an error.

	#1798468 (Bug #98440)
	    GCONN: webhook: Handle mismatches of the .git suffix on webhook
	    upstream urls.

No bugs fixed in 2019.1

--------------------------------------------------------------------------

No major new functionality in 2018.2

No minor new functionality in 2018.2

Bugs fixed in 2018.2

	#1717047 (Bug 96653)
	    The git mirroring functionality no longer attempts to access the
	    'lfs/objects' directory if it does not exist.

	#1698657 (Bug #92712)
	    When changing the Gconn system user, remove previous entry from
	    the crontab.

--------------------------------------------------------------------------

No major new functionality in 2018.1
 
No minor new functionality in 2018.1
 
Bugs fixed in 2018.1 Patch 2
 
	1707130 (Bug #96402)
	    Update configure-git-connector.sh and
	    configure-https-auth.sh to suppport SLES 11/12
 
Bugs fixed in 2018.1 Patch 1
 
	1653570 (Bug #94778)
	    Add new "gconn --get-ssh-key <type> <key>" command.
	    If a Helix pubkey entry exists for type and key,
	    display the ssh authorized_keys entry formated for gconn to stdout.
 
No bugs fixed in 2018.1
