GitProtocolConstants.java

/*
 * Copyright (C) 2008, 2013 Google Inc.
 * Copyright (C) 2008, Robin Rosenberg <robin.rosenberg@dewire.com>
 * Copyright (C) 2008, 2020 Shawn O. Pearce <spearce@spearce.org> and others
 *
 * This program and the accompanying materials are made available under the
 * terms of the Eclipse Distribution License v. 1.0 which is available at
 * https://www.eclipse.org/org/documents/edl-v10.php.
 *
 * SPDX-License-Identifier: BSD-3-Clause
 */

package org.eclipse.jgit.transport;

/**
 * Wire constants for the native Git protocol.
 *
 * @since 3.2
 */
public final class GitProtocolConstants {
    /**
     * Include tags if we are also including the referenced objects.
     *
     * @since 3.2
     */
    public static final String OPTION_INCLUDE_TAG = "include-tag"; //$NON-NLS-1$

    /**
     * Multi-ACK support for improved negotiation.
     *
     * @since 3.2
     */
    public static final String OPTION_MULTI_ACK = "multi_ack"; //$NON-NLS-1$

    /**
     * Multi-ACK detailed support for improved negotiation.
     *
     * @since 3.2
     */
    public static final String OPTION_MULTI_ACK_DETAILED = "multi_ack_detailed"; //$NON-NLS-1$

    /**
     * The client supports packs with deltas but not their bases.
     *
     * @since 3.2
     */
    public static final String OPTION_THIN_PACK = "thin-pack"; //$NON-NLS-1$

    /**
     * The client supports using the side-band for progress messages.
     *
     * @since 3.2
     */
    public static final String OPTION_SIDE_BAND = "side-band"; //$NON-NLS-1$

    /**
     * The client supports using the 64K side-band for progress messages.
     *
     * @since 3.2
     */
    public static final String OPTION_SIDE_BAND_64K = "side-band-64k"; //$NON-NLS-1$

    /**
     * The client supports packs with OFS deltas.
     *
     * @since 3.2
     */
    public static final String OPTION_OFS_DELTA = "ofs-delta"; //$NON-NLS-1$

    /**
     * The client supports shallow fetches.
     *
     * @since 3.2
     */
    public static final String OPTION_SHALLOW = "shallow"; //$NON-NLS-1$

    /**
     * The client wants the "deepen" command to be interpreted as relative to
     * the client's shallow commits.
     *
     * @since 5.0
     */
    public static final String OPTION_DEEPEN_RELATIVE = "deepen-relative"; //$NON-NLS-1$

    /**
     * The client does not want progress messages and will ignore them.
     *
     * @since 3.2
     */
    public static final String OPTION_NO_PROGRESS = "no-progress"; //$NON-NLS-1$

    /**
     * The client supports receiving a pack before it has sent "done".
     *
     * @since 3.2
     */
    public static final String OPTION_NO_DONE = "no-done"; //$NON-NLS-1$

    /**
     * The client supports fetching objects at the tip of any ref, even if not
     * advertised.
     *
     * @since 3.2
     */
    public static final String OPTION_ALLOW_TIP_SHA1_IN_WANT = "allow-tip-sha1-in-want"; //$NON-NLS-1$

    /**
     * The client supports fetching objects that are reachable from a tip of a
     * ref that is allowed to fetch.
     *
     * @since 4.1
     */
    public static final String OPTION_ALLOW_REACHABLE_SHA1_IN_WANT = "allow-reachable-sha1-in-want"; //$NON-NLS-1$

    /**
     * Symbolic reference support for better negotiation.
     *
     * @since 3.6
     */
    public static final String OPTION_SYMREF = "symref"; //$NON-NLS-1$

    /**
     * The client will send a push certificate.
     *
     * @since 4.0
     */
    public static final String OPTION_PUSH_CERT = "push-cert"; //$NON-NLS-1$

    /**
     * The client specified a filter expression.
     *
     * @since 5.0
     */
    public static final String OPTION_FILTER = "filter"; //$NON-NLS-1$

    /**
     * The client specified a want-ref expression.
     *
     * @since 5.1
     */
    public static final String OPTION_WANT_REF = "want-ref"; //$NON-NLS-1$

    /**
     * The client requested that the whole response be multiplexed, with
     * each non-flush and non-delim pkt prefixed by a sideband designator.
     *
     * @since 5.5
     */
    public static final String OPTION_SIDEBAND_ALL = "sideband-all"; //$NON-NLS-1$

    /**
     * The client supports atomic pushes. If this option is used, the server
     * will update all refs within one atomic transaction.
     *
     * @since 3.6
     */
    public static final String CAPABILITY_ATOMIC = "atomic"; //$NON-NLS-1$

    /**
     * The client expects less noise, e.g. no progress.
     *
     * @since 4.0
     */
    public static final String CAPABILITY_QUIET = "quiet"; //$NON-NLS-1$

    /**
     * The client expects a status report after the server processes the pack.
     *
     * @since 3.2
     */
    public static final String CAPABILITY_REPORT_STATUS = "report-status"; //$NON-NLS-1$

    /**
     * The server supports deleting refs.
     *
     * @since 3.2
     */
    public static final String CAPABILITY_DELETE_REFS = "delete-refs"; //$NON-NLS-1$

    /**
     * The server supports packs with OFS deltas.
     *
     * @since 3.2
     */
    public static final String CAPABILITY_OFS_DELTA = "ofs-delta"; //$NON-NLS-1$

    /**
     * The client supports using the 64K side-band for progress messages.
     *
     * @since 3.2
     */
    public static final String CAPABILITY_SIDE_BAND_64K = "side-band-64k"; //$NON-NLS-1$

    /**
     * The server allows recording of push certificates.
     *
     * @since 4.0
     */
    public static final String CAPABILITY_PUSH_CERT = "push-cert"; //$NON-NLS-1$

    /**
     * Implementation name and version of the client or server.
     *
     * @since 4.0
     */
    public static final String OPTION_AGENT = "agent"; //$NON-NLS-1$

    /**
     * The server supports the receiving of push options.
     *
     * @since 4.5
     */
    public static final String CAPABILITY_PUSH_OPTIONS = "push-options"; //$NON-NLS-1$

    /**
     * The server supports the client specifying ref names.
     *
     * @since 5.1
     */
    public static final String CAPABILITY_REF_IN_WANT = "ref-in-want"; //$NON-NLS-1$

    /**
     * The server supports arbitrary options
     *
     * @since 5.2
     */
    public static final String CAPABILITY_SERVER_OPTION = "server-option"; //$NON-NLS-1$

    /**
     * Option for passing application-specific options to the server.
     *
     * @since 5.2
     */
    public static final String OPTION_SERVER_OPTION = "server-option"; //$NON-NLS-1$

    /**
     * The server supports listing refs using protocol v2.
     *
     * @since 5.0
     */
    public static final String COMMAND_LS_REFS = "ls-refs"; //$NON-NLS-1$

    /**
     * The server supports fetch using protocol v2.
     *
     * @since 5.0
     */
    public static final String COMMAND_FETCH = "fetch"; //$NON-NLS-1$

    /**
     * HTTP header to set by clients to request a specific git protocol version
     * in the HTTP transport.
     *
     * @since 5.11
     */
    public static final String PROTOCOL_HEADER = "Git-Protocol"; //$NON-NLS-1$

    /**
     * Environment variable to set by clients to request a specific git protocol
     * in the file:// and ssh:// transports.
     *
     * @since 5.11
     */
    public static final String PROTOCOL_ENVIRONMENT_VARIABLE = "GIT_PROTOCOL"; //$NON-NLS-1$

    /**
     * Protocol V2 ref advertisement attribute containing the peeled object id
     * for annotated tags.
     *
     * @since 5.11
     */
    public static final String REF_ATTR_PEELED = "peeled:"; //$NON-NLS-1$

    /**
     * Protocol V2 ref advertisement attribute containing the name of the ref
     * for symbolic refs.
     *
     * @since 5.11
     */
    public static final String REF_ATTR_SYMREF_TARGET = "symref-target:"; //$NON-NLS-1$

    /**
     * Protocol V2 acknowledgments section header.
     *
     * @since 5.11
     */
    public static final String SECTION_ACKNOWLEDGMENTS = "acknowledgments"; //$NON-NLS-1$

    /**
     * Protocol V2 packfile section header.
     *
     * @since 5.11
     */
    public static final String SECTION_PACKFILE = "packfile"; //$NON-NLS-1$

    /**
     * Protocol announcement for protocol version 1. This is the same as V0,
     * except for this initial line.
     *
     * @since 5.11
     */
    public static final String VERSION_1 = "version 1"; //$NON-NLS-1$

    /**
     * Protocol announcement for protocol version 2.
     *
     * @since 5.11
     */
    public static final String VERSION_2 = "version 2"; //$NON-NLS-1$

    /**
     * Protocol request for protocol version 2.
     *
     * @since 5.11
     */
    public static final String VERSION_2_REQUEST = "version=2"; //$NON-NLS-1$

    enum MultiAck {
        OFF, CONTINUE, DETAILED;
    }

    private GitProtocolConstants() {
    }
}