Table of Contents
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 = PATH
Anchor core.logs core.logs
SubGit logs verbosity level. There are three levels:
logLevel = [info|finer|finest]
Anchor core.loglevel core.loglevel
INFO– default level, least verbose, reflects import/mirror process steps.
FINER– more verbose, Subgit logs every action it performs.
FINEST– most verbose, logs everything, including whole network traffic with all the payload.
The values are case-insensitive. Default log level is
a boolean value, can be set to
shared = [true|false]
Anchor core.shared core.shared
true, all files in the Git repository will be made group-writable;
falsewill set all the files owner writable only. The option must be
truewhen more than one system account is used to work with this repository. The default is
a path to the authors mapping file or authors mapping helper program:
authorsFile = PATH
authors mapping file – a text file with explicit authors mapping:
Code Block language text theme FadeToGrey title authors mapping syntax
svn_username = Git User <firstname.lastname@example.org>
- authors helper program – an executable authors mapping helper program and its optional arguments.
Find more details on authors mapping in the authors mapping user manual.
There could be more than one
authorsFileoptions specified, they will be processed from the last to the first until the mapping is obtained.
encoding in which authors mapping information is present. The default value is
authorsFileEncoding = ENCODING
Anchor core.authorsFileEncoding core.authorsFileEncoding
defaultDomain = DOMAINdomain to be used to generate Git committer email when authors mapping is not defined or does not provide an email address for a particular committer.
a way SubGit handles translation failures. There are three possible options:
failSafe = [auto|svn|git]
Anchor core.failSafe core.failSafe
auto– failed translation results in commits or pushes to be blocked on the side to which translation has failed.
svn– commits to Subversion are never being blocked.
git– pushes to Git are never being blocked.
pathEncoding = ENCODING
Anchor core. pathEncoding core. pathEncodingencoding to be used to store paths in Git tree objects. The default value is
gitPath = PATH
Anchor core. gitPath core. gitPatha path to Git executable. If this option is set, Git executable will be used to stream large files and perform Git garbage collection that can significantly decrease memory and disk space consumption.
streamFileThreshold = SIZE
Anchor core. streamFileThreshold core. streamFileThresholdfile size in bytes. SubGit loads the entire file into memory if its size less than this threshold; if the file is larger than the threshold, SubGit sends it as a stream. The option is not set by default, but SubGit sets the threshold to 50MB when the option is not set, so default threshold is 50MB. Note, the bigger the threshold is, the more likely to run into OutOfMemory error.
a path to Java home directory; this Java RE will be used to run hooks.
javaHome = PATH
Anchor core.javaHome core.javaHome
SVN project URL to be used for import/mirror. Supported protocols:
url = URL
Anchor svn.url svn.url
trunk = PATH
Anchor svn.trunk svn.trunka path to SVN project
trunkrelative to the SVN project URL. For more details see "Branches and Tags mapping" user manual.
branches = PATH
Anchor svn.branches svn.branchesa path to SVN project
branchesdirectory relative to the SVN project URL. There can be more than one
branchesoption in a configuration. For more details see "Branches and Tags mapping" user manual.
tags = PATH
Anchor svn.tags svn.tagsa path to SVN project
tagsdirectory relative to the SVN project URL. There can be more than one
tagsoption in a configuration. For more details see "Branches and Tags mapping" user manual.
shelves = PATH
Anchor svn.shelves svn.shelvesa path to SVN project
shelvesdirectory relative to the SVN project URL; this is special directory intended to store commits in some ambiguous situations when SubGit is unable to determine branch name where those particular commits belong to, find more details in the "What are shelves really?" blog post.
excludeBranches = SIMPLE_PATTERNa string that represents a branch or tag name to be excluded from translation. It can be either full branch or tag name or a name pattern with one wildcard. Interchangeable with
excludeTags. For more details see "Branches and Tags mapping" user manual.
excludeTags = SIMPLE_PATTERN
includePath = PATTERN
excludePath = PATTERN
auth = [default,option1,…]
minimalRevision = REVISION
fetchInterval = INTERVAL
connectTimeout = TIMEOUT
readTimeout = TIMEOUT
httpSpooling = [true|false]
triggerSvnPostReceive = [true|false]
triggerGitGC = [true|false|N]
keepGitCommitTime = [true|false]
revisionProperties = PATTERN
svnCommitMessage = PATTERN
gitCommitMessage = PATTERN
allowBranchReplacement = [true|false]
allowReplacementBranches = PATH
allowBranchDeletion = [true|false]
allowDeletionBranches = PATH
allowForcePush = [true|false]
cleanStaleRefLocks = [true|false]