Page History

Table of Contents

[core]

[CORE]

Anchor
core core

• logs = PATH

  Anchor
  core.logs core.logs

  
  

  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. 

• logLevel = [info|finer|finest]

  Anchor
  core.loglevel core.loglevel

  
  

  SubGit logs verbosity level. There are three levels:

  • 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 INFO.


• shared = [true|false]

  Anchor
  core.shared core.shared

  a boolean value, can be set to true or false.When true, all files in the Git repository will be made group-writable; false will set all the files owner writable only. The option must be true when more than one system account is used to work with this repository. The default is false.
   

• authorsFile = PATH

  a path to the authors mapping file or authors mapping helper program:
  
  

  • authors mapping file – a text file with explicit authors mapping:

    Code Block
    language text theme FadeToGrey title authors mapping syntax
    svn_username = Git User <gituser@example.com>

  • 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 authorsFile options specified, they will be processed from the last to the first until the mapping is obtained. 

• authorsFileEncoding = ENCODING

  Anchor
  core.authorsFileEncoding core.authorsFileEncoding

  encoding in which authors mapping information is present. The default value is UTF8.
   

• defaultDomain = DOMAIN

  domain 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.

• failSafe = [auto|svn|git]

  Anchor
  core.failSafe core.failSafe

  a way SubGit handles translation failures. There are three possible options:
  
  • 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.
  Find more details in "Error recover" user manual. 

• pathEncoding = ENCODING

  Anchor
  core. pathEncoding core. pathEncoding

  
  

  encoding to be used to store paths in Git tree objects. The default value is UTF8.

• gitPath = PATH

  Anchor
  core. gitPath core. gitPath

  
  

  a 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. streamFileThreshold

  
  

  file 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.

• javaHome = PATH

  Anchor
  core.javaHome core.javaHome

  
  

  a path to Java home directory; this Java RE will be used to run hooks.

[SVN]

• url = URL

  Anchor
  svn.url svn.url

  SVN project URL to be used for import/mirror. Supported protocols:

• trunk = PATH

  Anchor
  svn.trunk svn.trunk

  
  

  a path to SVN project trunk relative to the SVN project URL. For more details see "Branches and Tags mapping" user manual.
   

• branches = PATH

  Anchor
  svn.branches svn.branches

  
  

  a path to SVN project branches directory relative to the SVN project URL. There can be more than one branches option in a configuration. For more details see "Branches and Tags mapping" user manual.
  


• tags = PATH

  Anchor
  svn.tags svn.tags

  
  

  a path to SVN project tags directory relative to the SVN project URL. There can be more than one tags option in a configuration. For more details see "Branches and Tags mapping" user manual.
   

• shelves = PATH

  Anchor
  svn.shelves svn.shelves

  
  

  a path to SVN project shelves directory 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_PATTERN



  a 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]