OpenWrt之feeds.conf.default详解

目录

• OpenWrt之feeds.conf.default详解
  • 文件内容
  • 命令解释
  • src-svn与src-gitsvn
  • src-git与src-git-full
  • src-cpy与src-link
  • 其他的src命令
  • feeds命令用法
  • branch与commit的分割符号
  • branch与tag的区别

OpenWrt之feeds.conf.default详解

---

文件内容

src-git-full packages https://git.openwrt.org/feed/packages.git
src-git-full luci https://git.openwrt.org/project/luci.git
src-git-full routing https://git.openwrt.org/feed/routing.git
src-git-full telephony https://git.openwrt.org/feed/telephony.git
#src-git-full video https://github.com/openwrt/video.git
#src-git-full targets https://github.com/openwrt/targets.git
#src-git-full oldpackages http://git.openwrt.org/packages.git
#src-link custom /usr/src/openwrt/custom-feed

OpenWrt的feeds.conf.default, 是添加一些应用和包的文件, 看过之后下面解析命令用法

---

命令解释

• 先说# , 这个是注释用, 不会有人不知道吧

• 这个文件主要是由scripts/feeds这个perl脚本控制着, 贴一个命令的定义

  my %update_method = (
  	'src-svn' => {
  		'init'		=> "svn checkout '%s' '%s'",
  		'update'	=> "svn update",
  		'controldir'	=> ".svn",
  		'revision'	=> "svn info | grep 'Revision' | cut -d ' ' -f 2 | tr -d '\n'"},
  	'src-cpy' => {
  		'init'		=> "cp -Rf '%s' '%s'",
  		'update'	=> "",
  		'revision'	=> "echo -n 'local'"},
  	'src-link' => {
  		'init'		=> "ln -s '%s' '%s'",
  		'update'	=> "",
  		'revision'	=> "echo -n 'local'"},
  	'src-dummy' => {
  		'init'		=> "true '%s' && mkdir '%s'",
  		'update'	=> "",
  		'revision'	=> "echo -n 'dummy'"},
  	'src-git' => {
  		'init'          => "git clone --depth 1 '%s' '%s'",
  		'init_branch'   => "git clone --depth 1 --branch '%s' '%s' '%s'",
  		'init_commit'   => "git clone '%s' '%s' && cd '%s' && git checkout -b '%s' '%s' && cd -",
  		'update'	=> "git pull --ff-only",
  		'update_force'	=> "git pull --ff-only || (git reset --hard HEAD; git pull --ff-only; exit 1)",
  		'post_update'	=> "git submodule update --init --recursive",
  		'controldir'	=> ".git",
  		'revision'	=> "git rev-parse --short HEAD | tr -d '\n'"},
  	'src-git-full' => {
  		'init'          => "git clone '%s' '%s'",
  		'init_branch'   => "git clone --branch '%s' '%s' '%s'",
  		'init_commit'   => "git clone '%s' '%s' && cd '%s' && git checkout -b '%s' '%s' && cd -",
  		'update'	=> "git pull --ff-only",
  		'update_force'	=> "git pull --ff-only || (git reset --hard HEAD; git pull --ff-only; exit 1)",
  		'post_update'	=> "git submodule update --init --recursive",
  		'controldir'	=> ".git",
  		'revision'	=> "git rev-parse --short HEAD | tr -d '\n'"},
  	'src-gitsvn' => {
  		'init'	=> "git svn clone -r HEAD '%s' '%s'",
  		'update'	=> "git svn rebase",
  		'controldir'	=> ".git",
  		'revision'	=> "git rev-parse --short HEAD | tr -d '\n'"},
  	'src-bzr' => {
  		'init'		=> "bzr checkout --lightweight '%s' '%s'",
  		'update'	=> "bzr update",
  		'controldir'	=> ".bzr"},
  	'src-hg' => {
  		'init'		=> "hg clone '%s' '%s'",
  		'update'	=> "hg pull --update",
  		'controldir'	=> ".hg"},
  	'src-darcs' => {
  		'init'    => "darcs get '%s' '%s'",
  		'update'  => "darcs pull -a",
  		'controldir' => "_darcs"},
  );
  # src-git: pull broken
  # src-cpy: broken if `basename $src` != $name
  

---

src-svn与src-gitsvn

'src-svn' => {
		'init'		=> "svn checkout '%s' '%s'",
		'update'	=> "svn update",
		'controldir'	=> ".svn",
		'revision'	=> "svn info | grep 'Revision' | cut -d ' ' -f 2 | tr -d '\n'"},
'src-gitsvn' => {
		'init'	=> "git svn clone -r HEAD '%s' '%s'",
		'update'	=> "git svn rebase",
		'controldir'	=> ".git",
		'revision'	=> "git rev-parse --short HEAD | tr -d '\n'"},

• 用法:

src-svn NueXini_Packages https://github.com/NueXini/NueXini_Packages/trunk/
# 拉取默认分支
src-svn NueXini_Packages https://github.com/NueXini/NueXini_Packages/branches/v20220620
# 拉取指定分支
src-svn NueXini_Packages https://github.com/NueXini/NueXini_Packages/trunk/luci-app-disableipv6/
# 拉取指定文件夹

• src-gitsvn

• 我愿称之为git与svn的结合体

• 这个主要命令是git svn clone -r HEAD, 参考https://git-scm.com/docs/git-svn

• 用法:

src-gitsvn NueXini_Packages https://github.com/NueXini/NueXini_Packages.git

---

src-git与src-git-full

'src-git' => {
		'init'          => "git clone --depth 1 '%s' '%s'",
		'init_branch'   => "git clone --depth 1 --branch '%s' '%s' '%s'",
		'init_commit'   => "git clone '%s' '%s' && cd '%s' && git checkout -b '%s' '%s' && cd -",
		'update'	=> "git pull --ff-only",
		'update_force'	=> "git pull --ff-only || (git reset --hard HEAD; git pull --ff-only; exit 1)",
		'post_update'	=> "git submodule update --init --recursive",
		'controldir'	=> ".git",
		'revision'	=> "git rev-parse --short HEAD | tr -d '\n'"},
'src-git-full' => {
		'init'          => "git clone '%s' '%s'",
		'init_branch'   => "git clone --branch '%s' '%s' '%s'",
		'init_commit'   => "git clone '%s' '%s' && cd '%s' && git checkout -b '%s' '%s' && cd -",
		'update'	=> "git pull --ff-only",
		'update_force'	=> "git pull --ff-only || (git reset --hard HEAD; git pull --ff-only; exit 1)",
		'post_update'	=> "git submodule update --init --recursive",
		'controldir'	=> ".git",
		'revision'	=> "git rev-parse --short HEAD | tr -d '\n'"},

• 这两者共同操作是git clone区别是clone的深度不一样, src-git-full是全clone, 而src-git的深度为--depth 1
• 用法: src-git-full / src-git-full 保存的文件夹名 仓库地址
• 注: 后面可指定 分支, tag, commit , 不填则是拉取默认分支

src-git NueXini_Packages https://github.com/NueXini/NueXini_Packages.git;main
# 指定branch
src-git NueXini_Packages https://github.com/NueXini/NueXini_Packages.git;v20220620
# 指定tag
src-git NueXini_Packages https://github.com/NueXini/NueXini_Packages.git^47e35dd380b88d5cffc267eabe7a125da86d194b
# 指定commit

---

src-cpy与src-link

'src-cpy' => {
		'init'		=> "cp -Rf '%s' '%s'",
		'update'	=> "",
		'revision'	=> "echo -n 'local'"},
'src-link' => {
		'init'		=> "ln -s '%s' '%s'",
		'update'	=> "",
		'revision'	=> "echo -n 'local'"},

这两个命令的唯一区别是src-cpy会复制一份源到feeds目录, src-link则是ln -s创建一个软链接, 我个人是比较倾向src-link的, 这样可以修改源码能及时响应.

• 用法: src-cpy / src-link 保存的文件名 源目录

src-link NueXini_Packages package/NueXini_Packages
# 拉取package目录下的NueXini_Packages目录

---

其他的src命令

• 像bzr, hg, darcs 一些其他的分布式版本控制系统, 基本很少用到, 可以自行参考命令解释了解使用方法

---

feeds命令用法

sub usage() {
	print <<EOF;
Usage: $0 <command> [options]
Commands:
	list [options]: List feeds, their content and revisions (if installed)
	Options:
	    -n :            List of feed names.
	    -s :            List of feed names and their URL.
	    -r <feedname>:  List packages of specified feed.
	    -d <delimiter>: Use specified delimiter to distinguish rows (default: spaces)
	    -f :            List feeds in feeds.conf compatible format (when using -s).
	install [options] <package>: Install a package
	Options:
	    -a :           Install all packages from all feeds or from the specified feed using the -p option.
	    -p <feedname>: Prefer this feed when installing packages.
	    -d <y|m|n>:    Set default for newly installed packages.
	    -f :           Install will be forced even if the package exists in core OpenWrt (override)
	search [options] <substring>: Search for a package
	Options:
	    -r <feedname>: Only search in this feed
	uninstall -a|<package>: Uninstall a package
	Options:
	    -a :           Uninstalls all packages.
	update -a|<feedname(s)>: Update packages and lists of feeds in feeds.conf .
	Options:
	    -a :           Update all feeds listed within feeds.conf. Otherwise the specified feeds will be updated.
	    -i :           Recreate the index only. No feed update from repository is performed.
	    -f :           Force updating feeds even if there are changed, uncommitted files.
	clean:             Remove downloaded/generated files.
EOF
	exit(1);
}
my %commands = (
	'list' => \&list,
	'update' => \&update,
	'install' => \&install,
	'search' => \&search,
	'uninstall' => \&uninstall,
	'feed_config' => \&feed_config,
	'clean' => sub {
		system("rm -rf ./feeds ./package/feeds ./target/linux/feeds");
	}
);

---

branch与commit的分割符号

sub update_feed_via($$$$$) {
	my $type = shift;
	my $name = shift;
	my $src = shift;
	my $relocate = shift;
	my $force = shift;
	my $m = $update_method{$type};
	my $localpath = "./feeds/$name";
	my $safepath = $localpath;
	$safepath =~ s/'/'\\''/;
	my ($base_branch, $branch) = split(/;/, $src, 2);
	my ($base_commit, $commit) = split(/\^/, $src, 2);
	if( $relocate || !$m->{'update'} || !-d "$localpath/$m->{'controldir'}" ) {
		system("rm -rf '$safepath'");
		if ($m->{'init_branch'} and $branch) {
			system(sprintf($m->{'init_branch'}, $branch, $base_branch, $safepath)) == 0 or return 1;
		} elsif ($m->{'init_commit'} and $commit) {
			system(sprintf($m->{'init_commit'}, $base_commit, $safepath, $safepath, $commit, $commit)) == 0 or return 1;
		} else {
			system(sprintf($m->{'init'}, $src, $safepath)) == 0 or return 1;
		}
	} elsif ($m->{'init_commit'} and $commit) {
		# in case git hash has been provided don't update the feed
	} else {
		my $update_cmd = $m->{'update'};
		if ($force && exists $m->{'update_force'}) {
			$update_cmd = $m->{'update_force'};
		}
		system("cd '$safepath'; $update_cmd") == 0 or return 1;
	}
	if ($m->{'post_update'}) {
		my $cmd = $m->{'post_update'};
		system("cd '$safepath'; $cmd") == 0 or return 1;
	}
	return 0;
}

• 透过以上代码, 主要能看见branch与commit的分割是不一样的
• branch用的分割符号是;
• commit用的分割符号是^

my ($base_branch, $branch) = split(/;/, $src, 2);
my ($base_commit, $commit) = split(/\^/, $src, 2);

---

branch与tag的区别

• tag就是给commit的hash校验和取的一个名字，比较直观，方便记忆和使用

• tag就像是一个里程碑一个标志一个点，branch是一个新的征程一条线；tag是静态的，branch要向前走；

• tag 对应某次 commit, 是一个点，是不可移动的。
  
  branch 对应一系列 commit，是很多点连成的一根线，有一个HEAD 指针，是可以依靠 HEAD 指针移动的。

  所以，两者的区别决定了使用方式，改动代码用 branch ,不改动只查看用 tag。

• 参考https://git-scm.com/book/zh/v2/Git-%E5%9F%BA%E7%A1%80-%E6%89%93%E6%A0%87%E7%AD%BE

---

Enjoy it ~