5.3 Gitup 的用法

技巧

FreeBSD 14.0 已经删除了 portsnap，转而使用 Git，如本文所述可以使用 gitup 替代 portsnap。

gitup 是用于更新 Git 仓库的工具。

安装 gitup

• 使用 pkg 安装：

# pkg install gitup 

• 或者使用 Ports 安装：

# cd /usr/ports/net/gitup/
# make install clean

使用 gitup

# gitup ports 	# 获取 latest 分支的 Ports
# gitup release # 获取 release 版本的源代码

境内 Git 镜像站

将 gitup 的示例配置文件复制为正式配置文件：

# cp /usr/local/etc/gitup.conf.sample /usr/local/etc/gitup.conf

编辑 /usr/local/etc/gitup.conf，修改内容如下（有 ①②③ 共计三处需要修改）：

# $FreeBSD$
#
# Default configuration options for gitup.conf.
{
	"defaults" : {
		"host"           : "mirrors.ustc.edu.cn",  # 改动成这样①
		"port"           : 443,
#		"proxy_host"     : "",
#		"proxy_port"     : 0,
#		"proxy_username" : "",
#		"proxy_password" : "",
#		"source_address" : "",
		"low_memory"     : false,
		"display_depth"  : 0,
		"verbosity"      : 1,
		"work_directory" : "/var/db/gitup",
	},

	"ports" : {
		"repository_path"  : "/freebsd-ports/ports.git",  # 改动成这样②
		"branch"           : "main",
		"target_directory" : "/usr/ports",
		"ignores"          : [],
	},

	"quarterly" : {
		"repository_path"  : "/freebsd-ports/ports.git",  # 改动成这样③
		"branch"           : "quarterly",
		"target_directory" : "/usr/ports",
		"ignores"          : [],
	},

	"release" : {
		"repository_path"  : "/src.git",
		"branch"           : "releng/13.2",
		"target_directory" : "/usr/src",
		"ignores"          : [
			"sys/[^\/]+/conf",
		],
	},

	"stable" : {
		"repository_path"  : "/src.git",
		"branch"           : "stable/13",
		"target_directory" : "/usr/src",
		"ignores"          : [
			"sys/[^\/]+/conf",
		],
	},

	"current" : {
		"repository_path"  : "/src.git",
		"branch"           : "main",
		"target_directory" : "/usr/src",
		"ignores"          : [
			"sys/[^\/]+/conf",
		],
	}
}

拉取 ports：

# gitup ports

故障排除与未竟事宜

速度太慢（若不使用镜像站）

需要设置 HTTP 代理：gitup 不使用系统代理，而是由其配置文件 /usr/local/etc/gitup.conf 单独决定代理设置。

示例（先删去前面的 # 再修改）：

"proxy_host": "192.168.27.1",  # 设置代理服务器地址
"proxy_port": 7890              # 设置代理服务器端口

详细调试输出

以详细模式更新 ports 树到最新版本：

# gitup -v2 ports

报错 build_repair_command: There are too many files to repair -- please re-clone the repository: Argument list too long

清空 /usr/ports 目录中的所有现有内容，准备重新同步 Ports：

# rm -rf /usr/ports/*

使用 gitup 同步并拉取最新的 FreeBSD Ports 树:

# gitup ports

清空目录后重新拉取即可，可以忽略 rm: /usr/ports/: Device busy 提示。

参考链接

• gitup --A minimalist, dependency-free program to clone/pull Git repos-itories.，man 手册

• net/gitup

• johnmehr/gitup，开发者官网