User Tools

Site Tools


doc:devel:feeds

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
doc:devel:feeds [2013/05/09 01:41]
orca
doc:devel:feeds [2014/09/07 12:55] (current)
rpjday Add supported src-gitsvn update method to table.
Line 1: Line 1:
 ====== OpenWrt Feeds ====== ====== OpenWrt Feeds ======
  
-A feed in OpenWrt is a collection of [[doc:​devel:​packages]] which share a common location. ​ Feeds may reside on a remote server, in a version control system, on the local filesystem, or in any other location addressable by a single name (path/URL) over a protocol with a supported feed method.+In OpenWrt, a "​feed" ​is a collection of [[doc:​devel:​packages]] which share a common location. ​ Feeds may reside on a remote server, in a version control system, on the local filesystem, or in any other location addressable by a single name (path/URL) over a protocol with a supported feed method.
  
 Feeds are additional predefined package build recipes for OpenWrt Buildroot. Feeds are additional predefined package build recipes for OpenWrt Buildroot.
Line 12: Line 12:
 ''​feeds.conf.default''​ when ''​feeds.conf''​ does not exist). ​ This file contains a list of feeds, one per line, and any number of empty lines. ​ Comments begin with # and extend to the end of a line and are ignored during parsing. ​ Each feed line consists of 3 whitespace-separated components: ​ The feed method, the feed name, and the feed source. ''​feeds.conf.default''​ when ''​feeds.conf''​ does not exist). ​ This file contains a list of feeds, one per line, and any number of empty lines. ​ Comments begin with # and extend to the end of a line and are ignored during parsing. ​ Each feed line consists of 3 whitespace-separated components: ​ The feed method, the feed name, and the feed source.
  
-As of this writing ​the file ''<​builroot ​dir>/​feeds.conf.default''​ contains:+As of r41875 ​the file ''<​buildroot ​dir>/​feeds.conf.default''​ contains:
 <file xml feeds.conf.default>​ <file xml feeds.conf.default>​
-src-svn   packages ​ svn://svn.openwrt.org/​openwrt/​packages +src-git packages ​https://github.com/​openwrt/​packages.git 
-src-svn   ​xwrt ​     ​http://x-wrt.googlecode.com/svn/trunk/​package +src-git luci http://git.openwrt.org/project/luci.git 
-src-git ​  luci      git://nbd.name/luci.git +src-git ​routing https://github.com/openwrt-routing/​packages.git 
-src-git ​  routing ​  git://​github.com/​openwrt-routing/​packages.git +src-git ​telephony http://git.openwrt.org/​feed/​telephony.git 
-src-git ​  telephony ​http://feeds.openwrt.nanl.de/openwrt/telephony.git +src-git management https://​github.com/​openwrt-management/​packages.git 
-#​src-svn ​ phone     ​svn://​svn.openwrt.org/​openwrt/​feeds/​phone +#src-git ​oldpackages ​http://git.openwrt.org/​packages.git 
-#​src-svn ​ efl       ​svn://​svn.openwrt.org/​openwrt/​feeds/​efl +#src-svn xwrt http://x-wrt.googlecode.com/​svn/​trunk/​package 
-#​src-svn ​ xorg      svn://​svn.openwrt.org/​openwrt/​feeds/​xorg +#src-svn phone svn://​svn.openwrt.org/​openwrt/​feeds/​phone 
-#​src-svn ​ desktop ​  ​svn://​svn.openwrt.org/​openwrt/​feeds/​desktop +#src-svn efl svn://​svn.openwrt.org/​openwrt/​feeds/​efl 
-#​src-svn ​ xfce      svn://​svn.openwrt.org/​openwrt/​feeds/​xfce +#src-svn xorg svn://​svn.openwrt.org/​openwrt/​feeds/​xorg 
-#​src-svn ​ lxde      svn://​svn.openwrt.org/​openwrt/​feeds/​lxde +#src-svn desktop svn://​svn.openwrt.org/​openwrt/​feeds/​desktop 
-#src-link custom ​   /​usr/​src/​openwrt/​custom-feed+#src-svn xfce svn://​svn.openwrt.org/​openwrt/​feeds/​xfce 
 +#src-svn lxde svn://​svn.openwrt.org/​openwrt/​feeds/​lxde 
 +#src-link custom /​usr/​src/​openwrt/​custom-feed
 </​file>​ </​file>​
  
Line 34: Line 36:
 | src-cpy ​  | Data is copied from the source path | | src-cpy ​  | Data is copied from the source path |
 | src-darcs | Data is downloaded from the source path/URL using ''​darcs''​ | | src-darcs | Data is downloaded from the source path/URL using ''​darcs''​ |
-| src-git ​  | Data is downloaded from the source path/URL using ''​git''​. ​ ((If the source contains a semicolon, the portion before the semicolon is treated as a URL and the portion after as a branch name.)) |+| src-git ​  | Data is downloaded from the source path/URL using ''​git''​. ​ ((If the source contains a semicolon, the portion before the semicolon is treated as a URL and the portion after as a branch name.)) ((If the source contains a caret, the portion before the semicolon is treated as a URL and the portion after as a git commit hash)) 
 +| src-gitsvn | Bidirectional operation between a Subversion repository and git |
 | src-hg ​   | Data is downloaded from the source path/URL using ''​hg''​ | | src-hg ​   | Data is downloaded from the source path/URL using ''​hg''​ |
 | src-link ​ | A symlink to the source path is created | | src-link ​ | A symlink to the source path is created |
Line 99: Line 102:
  
   - You create your current project dir ''​project''​.   - You create your current project dir ''​project''​.
- 
   - Then while in ''/​home/​user/​openwrt/​project''​   - Then while in ''/​home/​user/​openwrt/​project''​
- +    ​- ''​svn co svn://​svn.openwrt.org/​openwrt/​trunk openwrt''​ (for the OpenWRT base system) 
-  ​- ''​svn co svn://​svn.openwrt.org/​openwrt/​trunk openwrt''​ (for the OpenWRT base system) +    - ''​svn co svn://​svn.openwrt.org/​openwrt/​packages packages''​ (for the packages feed)
-  - ''​svn co svn://​svn.openwrt.org/​openwrt/​packages packages''​ (for the packages feed) +
   - Add your package in the appropriate subdirectory under ''/​home/​user/​openwrt/​project/​packages''​   - Add your package in the appropriate subdirectory under ''/​home/​user/​openwrt/​project/​packages''​
  
 === Creating your own feed === === Creating your own feed ===
- 
   - Create your project dir and get trunk, as above   - Create your project dir and get trunk, as above
   - Create your package dir and copy your package into it (e.g. ''​cp packagedir /​home/​user/​openwrt/​project/​customfeed/''​),​ so that your package is under (in this example) ''/​home/​user/​openwrt/​project/​customfeed/​packagedir''​   - Create your package dir and copy your package into it (e.g. ''​cp packagedir /​home/​user/​openwrt/​project/​customfeed/''​),​ so that your package is under (in this example) ''/​home/​user/​openwrt/​project/​customfeed/​packagedir''​
  
 ==== Using the feed ==== ==== Using the feed ====
- 
   - Edit your ''​feeds.conf''​ (i.e. ''/​home/​user/​openwrt/​project/​openwrt/​feeds.conf''​)   - Edit your ''​feeds.conf''​ (i.e. ''/​home/​user/​openwrt/​project/​openwrt/​feeds.conf''​)
   - Add a new line to access the feed (and in the case of adding to the packages feed comment out the normal packages feed.)   - Add a new line to access the feed (and in the case of adding to the packages feed comment out the normal packages feed.)
Line 130: Line 128:
  
 ===== Explanations ===== ===== Explanations =====
- 
 The downloaded sources (referenced in package Makefiles) are not there... The downloaded sources (referenced in package Makefiles) are not there...
 The downloads go first to <​buildroot>/​dl as gzipped .gz files. And there they are stored and then they get unzipped to /build_dir. See e.g. <​buildroot>/​build_dir/​target-*/​ and below it you will find subdirectories for each package'​s sources. The downloads go first to <​buildroot>/​dl as gzipped .gz files. And there they are stored and then they get unzipped to /build_dir. See e.g. <​buildroot>/​build_dir/​target-*/​ and below it you will find subdirectories for each package'​s sources.
 +
 +==== Documentation ====
 +  - [[about:​toolchain|OpenWrt Buildroot – About]]
 +  - [[doc:​howto:​buildroot.exigence|OpenWrt Buildroot – Installation]]
 +  - [[doc:​howto:​build|OpenWrt Buildroot – Usage]]
 +  - OpenWrt Buildroot – Feeds
 +  - [[doc:​techref:​buildroot|OpenWrt Buildroot – Technical Reference]] {{:​meta:​icons:​tango:​48px-construction.svg.png?​nolink&​16}} this article needs //your// attention.
 +
 +
 +===== Links =====
 +
doc/devel/feeds.1368056480.txt.bz2 · Last modified: 2013/05/09 01:41 by orca