svnadmin

svnadmin是一个用来监控和修改Subversion版本库的管理工具。

因为svnadmin直接访问版本库（因此只可以在存放版本库的机器上使用），它通过路径访问版本库，而不是URL。

svnadmin选项

--bdb-log-keep

（Berkeley DB特定）关闭数据库日志文件的自动删除，保留这些文件可以帮助你在灾难性版本库故障时更加便利。

--bdb-txn-nosync

（Berkeley DB特定）在提交数据库事务时关闭fsync。可以在svnadmin create命令创建Berkeley DB后端时开启DB_TXN_NOSYNC（可以改进速度，但是有相关的风险）。

--bypass-hooks

绕过版本库钩子系统。

--clean-logs

删除不使用的Berkeley DB日志。

--force-uuid

缺省情况下，当版本库加载已经包含修订版本的数据时svnadmin会忽略流中的UUID，这个选项会导致版本库的UUID设置为流的UUID。

--ignore-uuid

缺省情况下，当加载空版本库时，svnadmin会使用来自流中的UUID，这个选项会导致忽略UUID（如果你的配置文件已经设置了--force-uuid，将会用于将其覆盖）。

--incremental

导出一个修订版本针对前一个修订版本的区别，而不是通常的完全结果。

--parent-dir DIR

当加载一个转储文件时，根路径为DIR而不是/。

--revision (-r) ARG

指定一个操作的修订版本。

--quiet

不显示通常的过程—只显示错误。

--use-post-commit-hook

当导入使用一个转储文件时，在每次新的修订版本产生时运行版本库post-commit钩子。

--use-pre-commit-hook

当加载一个转储文件时，每次新加修订版本之前运行版本库的pre-commit钩子。如果钩子失败，终止提交并中断加载进程。

svnadmin子命令

svnadmin create — 创建一个新的空的版本库。

svnadmin create REPOS_PATH

描述

在提供的路径上创建一个新的空的版本库，如果提供的目录不存在，它会为你创建。[55]对于Subversion 1.2，svnadmin缺省使用fsfs文件系统后    端创建版本库。

选项

--bdb-txn-nosync

--bdb-log-keep

--config-dir DIR

--fs-type TYPE

例子

创建一个版本库就是这样简单：

$ svnadmin create /usr/local/svn/repos

在Subversion 1.0，一定会创建一个Berkeley DB版本库，在Subversion 1.1，Berkeley DB版本库是缺省类型，但是一个FSFS版本库也是可以创建，使用--fs-type选项：

$ svnadmin create /usr/local/svn/repos --fs-type fsfs

svnadmin deltify — 修订版本范围的路径的增量变化。

svnadmin deltify [-r LOWER[:UPPER]] REPOS_PATH

描述

svnadmin deltify因为历史原因而存在，这个命令已经废弃，不再需要。

它开始于当Subversion提供了管理员控制版本库压缩策略的能力，结果是复杂工作得到了非常小的收益，所以这个“特性”被废弃了。

选项

--revision (-r) REV

--quiet (-q)

svnadmin dump — 将文件系统的内容转储到标准输出。

svnadmin dump REPOS_PATH [-r LOWER[:UPPER]] [--incremental]

描述

使用“dumpfile”可移植格式将文件系统的内容转储到标准输出，将反馈发送到标准错误，导出的修订版本从LOWER到UPPER。如果没有提供修订版本，会导出所有的修订版本树，如果只提供LOWER，导出一个修订版本树，通常的用法见“版本库数据的移植”一节。

缺省情况下，Subversion的转储流包含了一个包括所有文件和目录的单独修订版本（请求的修订版本范围的第一个），后面是其它的只包含本修订所修改的文件和目录的修订版本（请求范围的其它版本）。对于修改的文件，转储文件包括所有的内容和属性，对于目录，包括所有的属性。

有一对有用的选项可以改变转储文件产生的方式，第一个是--incremental，使得第一个修订版本只显示其修改的文件和目录，而不是整个目录树，就像转储文件中其它的修订版本。这对产生一个准备导入到已经有数据的版本库时非常有用。

第二个有用的选项是--deltas，这个选项导致svnadmin dump不会保留修改文件的所有内容，而只是记录修改的部分。这样减少（有些情况下是非常大的）了svnadmin dump产生的转储文件的大小。然而，也有缺点—增量转储文件需要更多的CPU来创建，也不可以用svndumpfilter操作，也不如非增量文件容易被如gzip和bzip2等第三方工具压缩。

选项

--revision (-r) REV

--incremental

--quiet (-q)

--deltas

例子

转储整个版本库：

$ svnadmin dump /usr/local/svn/repos

SVN-fs-dump-format-version: 1

Revision-number: 0

* Dumped revision 0.

Prop-content-length: 56

Content-length: 56

…

从版本库增量转储一个单独的事务：

$ svnadmin dump /usr/local/svn/repos -r 21 --incremental 

* Dumped revision 21.

SVN-fs-dump-format-version: 1

Revision-number: 21

Prop-content-length: 101

Content-length: 101

…

svnadmin help — 求助！

svnadmin help [SUBCOMMAND...]

描述

当你困于一个没有网络连接和本书的沙漠岛屿时，这个子命令非常有用。

别名

?, h

svnadmin hotcopy — 制作一个版本库的热备份。

svnadmin hotcopy REPOS_PATH NEW_REPOS_PATH

描述

这个子命令会制作一个版本库的完全“热”拷贝，包括所有的钩子，配置文件，当然还有数据库文件。如果你传递--clean-logs选项，svnadmin会执行热拷贝操作，然后删除不用的Berkeley DB日志文件。你可以在任何时候运行这个命令得到一个版本库的安全拷贝，不管其它进程是否使用这个版本库。

选项

--clean-logs

svnadmin list-dblogs — 询问Berkeley DB在给定的Subversion版本库有哪些日志文件存在（只有在版本库使用bdb作为后端时使用）。

svnadmin list-dblogs REPOS_PATH

描述

Berkeley DB创建了记录所有版本库修改的日志，允许我们在面对大灾难时恢复。除非你开启了DB_LOG_AUTOREMOVE，否则日志文件会累积，尽管大多数是不再使用可以从磁盘删除得到空间。

svnadmin list-unused-dblogs — 询问Berkeley DB哪些日志文件可以安全的删除（只有在版本库使用bdb作为后端时使用）。

svnadmin list-unused-dblogs REPOS_PATH

描述

Berkeley DB创建了记录所有版本库修改的日志，允许我们在面对大灾难时恢复。除非你开启了DB_LOG_AUTOREMOVE，否则日志文件会累积，尽管大多数是不再使用可以从磁盘删除得到空间。详情见“管理磁盘空间”一节。

例子

Berkeley DB创建了记录所有版本库修改的日志，允许我们在面对大灾难时恢复。除非你开启了DB_LOG_AUTOREMOVE，否则日志文件会累积，尽管大多数是不再使用，可以从磁盘删除得到空间。详情见“管理磁盘空间”一节。

$ svnadmin list-unused-dblogs /path/to/repos

/path/to/repos/log.0000000031

/path/to/repos/log.0000000032

/path/to/repos/log.0000000033

$ svnadmin list-unused-dblogs /path/to/repos | xargs rm

## disk space reclaimed!

svnadmin load — 从标准输入读进一个“svnadmin load”格式化的流。

svnadmin load REPOS_PATH

描述

从标准输入读取格式化流“dumpfile”，提交新修订版本到版本库的文件系统，在标准输出返回进度。

选项

--quiet (-q)

--ignore-uuid

--force-uuid

--use-pre-commit-hook

--use-post-commit-hook

--parent-dir

例子

这里显示了加载一个备份文件到版本库（当然，使用svnadmin dump）：

$ svnadmin load /usr/local/svn/restored < repos-backup

<<< Started new txn, based on original revision 1

     * adding path : test ... done.

     * adding path : test/a ... done.

…

或者你希望加载到一个子目录：

$ svnadmin load --parent-dir new/subdir/for/project /usr/local/svn/restored < repos-backup

<<< Started new txn, based on original revision 1

     * adding path : test ... done.

     * adding path : test/a ... done.

…

svnadmin lslocks — 打印所有锁定的描述。

svnadmin lslocks REPOS_PATH

描述

打印版本库所有锁定的描述。

选项

无

例子

显示了版本库/svn/repos中一个锁定的文件：

$ svnadmin lslocks /svn/repos

Path: /tree.jpg

UUID Token: opaquelocktoken:ab00ddf0-6afb-0310-9cd0-dda813329753

Owner: harry

Created: 2005-07-08 17:27:36 -0500 (Fri, 08 Jul 2005)

Expires: 

Comment (1 line):

Rework the uppermost branches on the bald cypress in the foreground.

svnadmin lstxns — 打印所有未提交的事物名称。

svnadmin lstxns REPOS_PATH

描述

打印所有未提交的事物名称。关于未提交事物是怎样创建和如何使用的信息见“删除终止的事务”一节。

例子

列出版本库所有突出的事物。

$ svnadmin lstxns /usr/local/svn/repos/ 

1w

1x

svnadmin recover — 将版本库数据库恢复到稳定状态（只有在版本库使用bdb作为后端时使用），此外，如果repos/conf/passwd不存在，它会创建一个默认的密码文件。

svnadmin recover REPOS_PATH

描述

在你得到的错误说明你需要恢复版本库时运行这个命令。

选项

--wait

例子

恢复挂起的版本库：

$ svnadmin recover /usr/local/svn/repos/ 

Repository lock acquired.

Please wait; recovering the repository may take some time...

Recovery completed.

The latest repos revision is 34.

恢复数据库需要一个版本库的独占锁（这是一个“数据库锁”；见锁定的三种含义），如果另一个进程访问版本库，svnadmin recover会出错：

$ svnadmin recover /usr/local/svn/repos

svn: Failed to get exclusive repository access; perhaps another process

such as httpd, svnserve or svn has it open?

$

--wait选项可以导致svnadmin recover一直等待其它进程断开连接：

$ svnadmin recover /usr/local/svn/repos --wait

Waiting on repository lock; perhaps another process has it open?

### time goes by...

Repository lock acquired.

Please wait; recovering the repository may take some time...

Recovery completed.

The latest repos revision is 34.

svnadmin rmlocks — 无条件的删除版本库的一个或多个锁定。

svnadmin rmlocks REPOS_PATH LOCKED_PATH...

描述

从LOCKED_PATH删除没个锁定。

选项

无

例子

这删除了版本库/svn/repos里tree.jpg和house.jpg文件上的锁定：

$ svnadmin rmlocks /svn/repos tree.jpg house.jpg

Removed lock on '/tree.jpg.

Removed lock on '/house.jpg.

svnadmin rmtxns — 从版本库删除事物。

svnadmin rmtxns REPOS_PATH TXN_NAME...

描述

删除版本库的事物，更多细节在“删除终止的事务”一节。

选项

--quiet (-q)

例子

删除命名的事物：

$ svnadmin rmtxns /usr/local/svn/repos/ 1w 1x

很幸运，lstxns的输出作为rmtxns输入工作良好：

$ svnadmin rmtxns /usr/local/svn/repos/  `svnadmin lstxns /usr/local/svn/repos/`

从版本库删除所有未提交的事务。

svnadmin setlog — 设置某个修订版本的日志信息。

svnadmin setlog REPOS_PATH -r REVISION FILE

描述

设置修订版本REVISION的日志信息为FILE的内容。

这与使用svn propset --revprop设置某一修订版本的svn:log属性效果一样，除了你也可以使用--bypass-hooks选项绕过的所有pre-或post-commit的钩子脚本，这在pre-revprop-change钩子脚本中禁止修改修订版本属性时非常有用。

警告

修订版本属性不在版本控制之下的，所以这个命令会永久覆盖前一个日志信息。

选项

--revision (-r) REV

--bypass-hooks

例子

设置修订版本19的日志信息为文件msg的内容：

$ svnadmin setlog /usr/local/svn/repos/ -r 19 msg

svnadmin create — 创建一个新的空的版本库。

svnadmin create REPOS_PATH

描述

在提供的路径上创建一个新的空的版本库，如果提供的目录不存在，它会为你创建。[55]对于Subversion 1.2，svnadmin缺省使用fsfs文件系统后端创建版本库。

选项

--bdb-txn-nosync

--bdb-log-keep

--config-dir DIR

--fs-type TYPE

例子

创建一个版本库就是这样简单：

$ svnadmin create /usr/local/svn/repos

在Subversion 1.0，一定会创建一个Berkeley DB版本库，在Subversion 1.1，Berkeley DB版本库是缺省类型，但是一个FSFS版本库也是可以创建，使用--fs-type选项：

$ svnadmin create /usr/local/svn/repos --fs-type fsfs

svnadmin verify — 验证版本库保存的数据。

svnadmin verify REPOS_PATH

描述

如果你希望验证版本库的完整性可以运行这个命令，这样会遍历版本库的所有的修订版本，导出修订版本并丢弃输出—有规律的执行这个命令来防止磁盘失败会是一个好方法，如果这个命令失败了—这是发生问题的第一个征兆—这表明你的版本库至少有一个损坏的修订版本，你必须从备份恢复损坏的修订版本（你需要备份，你没有吗？）。

例子

检验挂起的版本库：

$ svnadmin verify /usr/local/svn/repos/ 

* Verified revision 1729.

转载于:https://my.oschina.net/leewb/blog/612517