iframe-proxy | Sunbelt Computer Software

Repository navigation

History

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

126

127

128

* This file is part of libgit2, distributed under the GNU GPL v2 with

* a Linking Exception. For full terms see the included COPYING file.

#ifndef INCLUDE_git_clone_h__

#define INCLUDE_git_clone_h__

#include "common.h"

#include "types.h"

#include "indexer.h"

#include "checkout.h"

#include "remote.h"

/**

* @file git2/clone.h

* @brief Git cloning routines

* @defgroup git_clone Git cloning routines

* @ingroup Git

* @{

GIT_BEGIN_DECL

/**

* Clone options structure

* Use the GIT_CLONE_OPTIONS_INIT to get the default settings, like this:

* git_clone_options opts = GIT_CLONE_OPTIONS_INIT;

* - `checkout_opts` are option passed to the checkout step. To disable

* checkout, set the `checkout_strategy` to GIT_CHECKOUT_NONE.

* Generally you will want the use GIT_CHECKOUT_SAFE_CREATE to create

* all files in the working directory for the newly cloned repository.

* - `bare` should be set to zero (false) to create a standard repo,

* or non-zero for a bare repo

* - `ignore_cert_errors` should be set to 1 if errors validating the

* remote host's certificate should be ignored.

* ** "origin" remote options: **

* - `remote_name` is the name to be given to the "origin" remote. The

* default is "origin".

* - `checkout_branch` gives the name of the branch to checkout. NULL

* means use the remote's HEAD.

* - `signature` is the identity used when updating the reflog. NULL means to

* use the default signature using the config.

typedef struct git_clone_options {

unsigned int version;

git_checkout_options checkout_opts;

git_remote_callbacks remote_callbacks;

int bare;

int ignore_cert_errors;

const char *remote_name;

const char* checkout_branch;

git_signature *signature;

} git_clone_options;

#define GIT_CLONE_OPTIONS_VERSION 1

#define GIT_CLONE_OPTIONS_INIT {GIT_CLONE_OPTIONS_VERSION, {GIT_CHECKOUT_OPTIONS_VERSION, GIT_CHECKOUT_SAFE_CREATE}, GIT_REMOTE_CALLBACKS_INIT}

/**

* Initializes a `git_clone_options` with default values. Equivalent to

* creating an instance with GIT_CLONE_OPTIONS_INIT.

* @param opts The `git_clone_options` struct to initialize

* @param version Version of struct; pass `GIT_CLONE_OPTIONS_VERSION`

* @return Zero on success; -1 on failure.

GIT_EXTERN(int) git_clone_init_options(

git_clone_options *opts,

unsigned int version);

/**

* Clone a remote repository.

* This version handles the simple case. If you'd like to create the

* repository or remote with non-default settings, you can create and

* configure them and then use `git_clone_into()`.

* @param out pointer that will receive the resulting repository object

* @param url the remote repository to clone

* @param local_path local directory to clone to

* @param options configuration options for the clone. If NULL, the

* function works as though GIT_OPTIONS_INIT were passed.

* @return 0 on success, any non-zero return value from a callback

* function, or a negative value to indicate an error (use

* `giterr_last` for a detailed error message)

GIT_EXTERN(int) git_clone(

git_repository **out,

const char *url,

const char *local_path,

const git_clone_options *options);

/**

* Clone into a repository

* After creating the repository and remote and configuring them for

* paths and callbacks respectively, you can call this function to

* perform the clone operation and optionally checkout files.

* @param repo the repository to use

* @param remote the remote repository to clone from

* @param co_opts options to use during checkout

* @param branch the branch to checkout after the clone, pass NULL for the

* remote's default branch

* @param signature The identity used when updating the reflog.

* @return 0 on success, any non-zero return value from a callback

* function, or a negative value to indicate an error (use

* `giterr_last` for a detailed error message)

GIT_EXTERN(int) git_clone_into(

git_repository *repo,

git_remote *remote,

const git_checkout_options *co_opts,

const char *branch,

const git_signature *signature);

/** @} */

GIT_END_DECL

#endif

Sunbelt Computer Software

PL/B Language Development and Support

Navigation Menu

Repository navigation

clone.h

clone.h

Sunbelt Computer Software

PL/B Language Development and Support

FilesExpand file tree

clone.h

Latest commit

History

clone.h

File metadata and controls