...
logslogLevelsharedauthorsFileauthorsFileEncodingdefaultDomainfailSafepathEncodinggitPathstreamFileThresholdjavaHome
[AUTH]Table of Contents
[CORE]Anchor core core
| Anchor | ||||
|---|---|---|---|---|
|
a path to the directory where SubGit logs are being stored. The path can be either absolute or relative to the Git repository where import/mirror from SVN is being performed to.logs = PATHAnchor core.logs core.logs
...
gitCommitMessage = PATTERNAnchor svn.gitCommitMessage svn.gitCommitMessage a pattern consisting of placeholders that construct Git commit message when a SVNcommit is being translated to Git. There are several acceptable placeholders:%author= Git author%committer= Git committer%date= date of revision%message= original message%svnUser= Subversion username%revision= Subversion revision, GRN in your notation%branch.= Subversion branch\n= newline feed
For example, if thegitCommitMessagewas set like this:Code Block language text theme FadeToGrey title gitCommitMessage gitCommitMessage = SVN %revision@%branch\\n%message
Then, some changes have been committed to the SVN repository:
Code Block language text theme FadeToGrey title SVN revision 197 ----------------------------------------------------------------- r197 | johndoe | 2017-06-29 13:38:02 +0500 (Thu, 29 Jun 2017) | Changed paths: M /project1/trunk/source.txt gitCommitMessage example -----------------------------------------------------------------
Translated Git commit will look like this:
Code Block language text theme FadeToGrey title Git commit $ git log -v commit d5c7c9e2518a5e8942c26d7cda5ace61ddb7c045 Author: John Dow <johndoe@example.com> Date: Thu Jun 29 08:38:02 2017 +0000 SVN 197@trunk gitCommitMessage example
WhenallowBranchReplacement = [true|false]Anchor svn.allowBranchReplacement svn.allowBranchReplacement true, SVN branches replacement is allowed, otherwise it isn't allowed.allowReplacementBranches = PATHAnchor svn.allowReplacementBranches svn.allowReplacementBranches a path pattern relative tosvn.urlthat points to SVN branches which are allowed to be replaced. This option works as an exception whenallowBranchReplacementis set tofalse:it allows replacing those SVN branches when new Git changes are being pushed to the SubGit-mirrored Git repository.
WhenallowBranchDeletion = [true|false]Anchor svn.allowBranchDeletion svn.allowBranchDeletion true, SVN branches removing is allowed, otherwise it isn't allowed.allowDeletionBranches = PATHAnchor svn.allowDeletionBranches svn.allowDeletionBranches a path pattern relative tourlpointing to SVN branches which are allowed to be deleted. This option works as an exceptionallowBranchReplacementis set tofalse:It allows removing those SVN branches when new Git changes are being pushed to the SubGit-mirrored Git repository.allowForcePush = [true|false]Anchor svn.allowForcePush svn.allowForcePush When set tofalseSubGit rejects any attempts to perform non-fast-forward updates for those refs which are synchronized with SVN repository. Whentrue, such updates are allowed.cleanStaleRefLocks = [true|false]Anchor svn.cleanStaleRefLocks svn.cleanStaleRefLocks When set totrue, SubGit automatically deletes any stale Git ref locks – i.e. ref lock filesGIT_REPO/refs/**/*.lockthat exist more than a minute. Iffalse, SubGit won’t delete lock files, that means any stale ref locks has to be resolved manually. The default istrue.
[AUTH]Anchor auth auth
| Anchor | ||||
|---|---|---|---|---|
|
a username that is used to log into the Subversion repository.userName = NAMEAnchor auth.userName auth.userName
password = PASSWORD
user password that is used to log into the Subversion repository.
sshKeyFile = PATH<a name="auth.sshKeyFile">a path to SSH key file in case if SVN repository is supposed to be accessed over svn+ssh and the key is used for login. The path can be either absolute or relative to the Git repository where import/mirror from SVN is being performed to.
sshKeyPassphrase = PASSPHRASE<a name="auth.sshKeyPassphrase">passphrase for the SSH key.
sslClientCertFile = PATH<a name="auth.sshKeyPassphrase">a path to client SSL client certificate of PKSC#12 format for the case the SVN repository is being accessed over HTTPS and client certificate is used for log in. The path can be either absolute or relative to the Git repository where import/mirror from SVN is being performed to.
sslClientCertPassphrase = PASSPHRASE<a name="auth.sshKeyPassphrase">passphrase for the SSL client certificate.
passwords = PATH<a name="auth.passwords">a path to passwords file; the file contains username/password pairs that are used to log into the Subversion repository. The path can be either absolute or relative to the Git repository where import/mirror from SVN is being performed to.
credentialHelper = PATH<a name="auth.credentialHelper">a path to the credential helper program and its optional arguments. The path can be either absolute or relative to the Git repository where import/mirror from SVN is being performed to. The program is expected to be non-interactive (no prompt) and to use Git credential helper input/output format. Sample credential helper script could be found in
subgit/samplesdirectory.subversionConfigurationDirectory = [PATH|@default@]<a name="auth.subversionConfigurationDirectory">a path to Subversion configuration directory or
@default@to use current user Subversion configuration and credentials cache. The path can be either absolute or relative to the Git repository where import/mirror from SVN is being performed to.useDefaultSubversionConfigurationDirectory = [true|false]<a name="auth.useDefaultSubversionConfigurationDirectory">a boolean value, can be set to
trueorfalse. Whentruedefault user SVN directory is used (~/.subversion); whenfalse, path that is set bysubversionConfigurationDirectoryoption is used.